Skip to content

Commit

Permalink
[pt] Add content/pt/docs/concepts/resources and layouts/shortcodes/pt/ (
Browse files Browse the repository at this point in the history
open-telemetry#5132)

Co-authored-by: Ezzio Moreira <[email protected]>
Co-authored-by: Luiz Aoqui <[email protected]>
Co-authored-by: Patrice Chalin <[email protected]>
Co-authored-by: Vitor Vasconcellos <[email protected]>
Co-authored-by: Marylia Gutierrez <[email protected]>
  • Loading branch information
6 people authored Sep 24, 2024
1 parent 0a876eb commit aa5df8e
Show file tree
Hide file tree
Showing 3 changed files with 75 additions and 0 deletions.
1 change: 1 addition & 0 deletions .prettierignore
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,7 @@
!/layouts/shortcodes
/layouts/shortcodes/*
!/layouts/shortcodes/docs
/layouts/shortcodes/pt

/content/ja
/content/zh
Expand Down
60 changes: 60 additions & 0 deletions content/pt/docs/concepts/resources/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,60 @@
---
title: Recursos
weight: 70
default_lang_commit: a1740fd934e595f1396f2eb82a58a80824369b09
---

## Introdução

{{% pt/docs/languages/resources-intro %}}

Se você usar [Jaeger](https://www.jaegertracing.io/) como seu _backend_ de
observabilidade, os atributos do recurso são agrupados na guia **Process**:

![Uma captura de tela do Jaeger mostrando um exemplo de saída de atributos do recurso associados a um rastro.](screenshot-jaeger-resources.png)

Um recurso é adicionado ao `TraceProvider` ou `MetricProvider` quando eles são
criados durante a inicialização. Esta associação não pode ser alterada
posteriormente. Após um recurso ser adicionado, todos os trechos e métricas
produzidos a partir de um `Tracer` ou `Meter` do _provider_ terão o recurso
associado a eles.

## Atributos semânticos com valores padrões fornecidos pelo SDK

Existem atributos fornecidos pelo SDK do OpenTelemetry. Um deles é o
`service.name`, que representa o nome lógico do serviço. Por padrão, os SDKs
atribuirão o valor `unknown_service` para este valor, então é recomendado
defini-lo explicitamente, seja no código ou definindo um valor para a variável
de ambiente `OTEL_SERVICE_NAME`.

Além disso, o SDK também fornecerá os seguintes atributos do recurso para se
autoidentificar: `telemetry.sdk.name`, `telemetry.sdk.language` e
`telemetry.sdk.version`.

## Detectores de recursos

A maioria dos SDKs específicos de linguagem fornece um conjunto de detectores de
recursos que podem ser usados para detectar automaticamente informações de
recursos do ambiente. Os detectores de recursos mais comuns incluem:

- [Sistema Operacional](/docs/specs/semconv/resource/os/)
- [Host](/docs/specs/semconv/resource/host/)
- [Processos e tempo de execução de processos](/docs/specs/semconv/resource/process/)
- [Container](/docs/specs/semconv/resource/container/)
- [Kubernetes](/docs/specs/semconv/resource/k8s/)
- [Atributos específicos do provedor de nuvem](/docs/specs/semconv/resource/#cloud-provider-specific-attributes)
- [e mais](/docs/specs/semconv/resource/)

## Recursos personalizados

Você também pode fornecer seus próprios atributos do recurso. Você pode
fornecê-los em código ou definindo um valor para a variável de ambiente
`OTEL_RESOURCE_ATTRIBUTES`. Se aplicável, utilize
[convenções semânticas para seus atributos do recurso](/docs/specs/semconv/resource).
Por exemplo, você pode fornecer o nome do seu
[ambiente de execução](/docs/specs/semconv/resource/deployment-environment/)
usando `deployment.environment`:

```shell
env OTEL_RESOURCE_ATTRIBUTES=deployment.environment=production yourApp
```
14 changes: 14 additions & 0 deletions layouts/shortcodes/pt/docs/languages/resources-intro.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
{{/*
default_lang_commit: a1740fd934e595f1396f2eb82a58a80824369b09
*/ -}}

<!-- prettier-ignore -->
{{ $processWord := .Get 0 | default "processo" -}}
{{ $resourceHRef := "/docs/concepts/resources/" -}}
{{ if eq .Page.RelPermalink $resourceHRef -}}
{{ $resourceHRef = "/docs/specs/otel/resource/sdk/" -}}
{{ end -}}

Um [recurso]({{ $resourceHRef }}) representa a entidade que está gerando telemetria como atributos do recurso. Por exemplo, um {{ $processWord }} que está gerando telemetria e que está sendo executado em um _container_ no Kubernetes tem o nome de um {{ $processWord }}, um nome de _pod_, um _namespace_ e possivelmente um nome de _deployment_. Todos esses quatro atributos podem ser incluídos em um recurso.

No seu _backend_ de observabilidade, você pode usar as informações de um recurso para refinar a investigação de comportamentos relevantes. Por exemplo, se seus dados de rastros ou métricas indicarem latência no seu sistema, você pode restringir a investigação para um determinado _container_, _pod_ ou _deployment_ do Kubernetes.

0 comments on commit aa5df8e

Please sign in to comment.