[pt] Add signals concepts documentation #4993
Conversation
emdneto
changed the title
|
PTAL @edsoncelio @EzzioMoreira |
There was a problem hiding this comment.
Deixei alguns comentários, mas também gostaria da validação dos comentários propostos. Mesmo assim, excelente tradução, @leandrocarpenter!
|
Opa @leandrocarpenter! Queria deixar uma sugestão, o que acha de quebrar esse PR em vários? O que eu sugiro de fazer nesse PR:
Os outros pode deixar pra outro PR, o que acha? |
|
@leandrocarpenter acho que no seu último commit veio documentos da localização [EN]. Quando puder dá uma olhada nos |
| description: Informações contextuais que são passadas entre sinais | ||
| --- | ||
| No OpenTelemetry, bagagem é uma informação adicional associada ao contexto. | ||
| Bagagem é uma loja de chave-valor, o que significa que permite que você context. |
There was a problem hiding this comment.
| Bagagem é uma loja de chave-valor, o que significa que permite que você context. | |
| Bagagem é uma estrutura de armazenamento de chave-valor, que permite você propagar quaisquer dados junto com o contexto. |
| goste ao lado[contexto](/docs/concepts/context-propagation/#context). | ||
| Bagagem significa que você pode passar dados entre serviços e processos, | ||
| tornando-os disponíveis para adicionar[traços](/docs/concepts/signals/traces/), | ||
| [metricas](/docs/concepts/signals/metrics/), or |
There was a problem hiding this comment.
| [metricas](/docs/concepts/signals/metrics/), or | |
| [métricas](/docs/concepts/signals/metrics/), ou |
| [propague](/docs/concepts/context-propagation/#propagation) qualquer dado que você | ||
| goste ao lado[contexto](/docs/concepts/context-propagation/#context). | ||
| Bagagem significa que você pode passar dados entre serviços e processos, | ||
| tornando-os disponíveis para adicionar[traços](/docs/concepts/signals/traces/), |
There was a problem hiding this comment.
| tornando-os disponíveis para adicionar[traços](/docs/concepts/signals/traces/), | |
| tornando-os disponíveis para adicionar aos [rastros](/docs/concepts/signals/traces/), |
| [metricas](/docs/concepts/signals/metrics/), or | ||
| [logs](/docs/concepts/signals/logs/) nesses serviços. | ||
|
|
||
| ## Example |
There was a problem hiding this comment.
| ## Example | |
| ## Exemplo |
| Por exemplo, imagine que você tem um `clientId` no início de uma solicitação, | ||
| mas, você gostaria que esse ID estivesse disponível em todos os trechos em um | ||
| rastreamento, algumas métricas em outro serviço, e alguns logs ao longo do caminho. | ||
| Porque os rastros podem ter vários trechos em multiplos serviços, você precisa de |
There was a problem hiding this comment.
| Porque os rastros podem ter vários trechos em multiplos serviços, você precisa de | |
| Porque os rastros podem ter vários trechos em múltiplos serviços, você precisa de |
| na sua base de código. | ||
|
|
||
| Ao usar. | ||
| [Contexto Propagação](/docs/concepts/signals/traces/#context-propagation) para |
There was a problem hiding this comment.
| [Contexto Propagação](/docs/concepts/signals/traces/#context-propagation) para | |
| [Propagação de Contexto](/docs/concepts/signals/traces/#context-propagation) para |
| Baggage is best used to include information typically available only at the | ||
| start of a request further downstream. This can include things like Account | ||
| Identification, User IDs, Product IDs, and origin IPs, for example. | ||
|
|
||
| Propagating this information using baggage allows for deeper analysis of | ||
| telemetry in a backend. For example, if you include information like a User ID | ||
| on a span that tracks a database call, you can much more easily answer questions | ||
| like "which users are experiencing the slowest database calls?" You can also log | ||
| information about a downstream operation and include that same User ID in the | ||
| log data. | ||
|
|
||
|  | ||
|
|
||
| ## Baggage security considerations | ||
|
|
||
| Sensitive Baggage items can be shared with unintended resources, like | ||
| third-party APIs. This is because automatic instrumentation includes Baggage in | ||
| most of your service’s network requests. Specifically, Baggage and other parts | ||
| of trace context are sent in HTTP headers, making it visible to anyone | ||
| inspecting your network traffic. If traffic is restricted within your network, | ||
| then this risk may not apply, but keep in mind that downstream services could | ||
| propagate Baggage outside your network. | ||
|
|
||
| Also, there are no built-in integrity checks to ensure that Baggage items are | ||
| yours, so exercise caution when reading them. | ||
|
|
||
| ## Baggage is not the same as attributes | ||
|
|
||
| An important thing to note about baggage is that it is a separate key-value | ||
| store and is unassociated with attributes on spans, metrics, or logs without | ||
| explicitly adding them. | ||
|
|
||
| To add baggage entries to attributes, you need to explicitly read the data from | ||
| baggage and add it as attributes to your spans, metrics, or logs. | ||
|
|
||
| Because a common use cases for Baggage is to add data to | ||
| [Span Attributes](/docs/concepts/signals/traces/#attributes) across a whole | ||
| trace, several languages have Baggage Span Processors that add data from baggage | ||
| as attributes on span creation. | ||
|
|
||
| > For more information, see the [baggage specification][]. | ||
|
|
||
| [baggage specification]: /docs/specs/otel/overview/#baggage-signal |
There was a problem hiding this comment.
Acho que isso veio no commit por engano.
| @@ -0,0 +1,79 @@ | |||
| --- | |||
| title: Baggage | |||
There was a problem hiding this comment.
Acho que isso veio no commit por engano.
| @@ -0,0 +1,244 @@ | |||
| --- | |||
| title: Logs | |||
There was a problem hiding this comment.
Acho que isso veio no commit por engano.
| @@ -0,0 +1,122 @@ | |||
| --- | |||
| title: Metrics | |||
There was a problem hiding this comment.
Acho que isso veio no commit por engano.
| @@ -0,0 +1,388 @@ | |||
| --- | |||
| title: Traces | |||
There was a problem hiding this comment.
Acho que isso veio no commit por engano.
|
@leandrocarpenter gentle remind: você ainda está trabalhando nesse PR ou outra pessoa pode assumir de onde você parou? |
| Bagagem é uma loja de chave-valor, o que significa que permite que você context. | ||
| [propague](/docs/concepts/context-propagation/#propagation) qualquer dado que você | ||
| goste ao lado[contexto](/docs/concepts/context-propagation/#context). | ||
| Bagagem significa que você pode passar dados entre serviços e processos, |
There was a problem hiding this comment.
Bagagem significa que você pode passar dados entre serviços e processos
| Bagagem significa que você pode passar dados entre serviços e processos, | |
| Bagagem significa que você pode transportar dados entre serviços e processos, |
|
@leandrocarpenter vou puxar a continuidade dessa localização. |
|
Pessoal, me desculpem, não consegui dar continuidade. |
|
@leandrocarpenter fica tranquilo, no último encontro o time decidiu fechar a tradução dos conceitos e seguir para próxima etapa. |
Docs PR Checklist
This PR is for a documentation page whose authoritative copy is in the
opentelemetry.io repository.
Primeira tradução da pagina de signals.