forked from open-telemetry/opentelemetry.io
-
Notifications
You must be signed in to change notification settings - Fork 1
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
[pt] Add content/pt/docs/concepts/resources and layouts/shortcodes/pt/ (
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
1 parent
0a876eb
commit aa5df8e
Showing
3 changed files
with
75 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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 | ||
``` |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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. |