Skip to content

Commit 14223bd

Browse files
vitorvascemdneto
andauthored
[pt] Update localized content under content/pt/docs/concepts/signals (#6157)
Co-authored-by: Emídio Neto <[email protected]>
1 parent 4641bcb commit 14223bd

File tree

5 files changed

+66
-56
lines changed

5 files changed

+66
-56
lines changed

content/pt/docs/concepts/signals/_index.md

+25-15
Original file line numberDiff line numberDiff line change
@@ -3,23 +3,33 @@ title: Sinais
33
description:
44
Aprenda sobre as categorias de telemetria suportadas pelo OpenTelemetry
55
weight: 11
6-
default_lang_commit: 08e13eb62f2869300301670675969be705db59ae
6+
default_lang_commit: 7c0e4db0b6c39b0ca0e7efb17df5610d1b77b8a3
77
---
88

9-
O propósito do OpenTelemetry é coletar, processar e exportar **[sinais][]**.
10-
Sinais são dados emitidos que descrevem a atividade subjacente do sistema
11-
operacional e das aplicações que estão sendo executadas em uma plataforma. Um
12-
sinal pode ser algo que você deseja medir em um momento específico, como a
13-
temperatura ou o uso de memória, ou um evento que passa pelos componentes do seu
14-
sistema distribuído e que você gostaria de rastrear. Você pode agrupar
15-
diferentes sinais para observar o funcionamento interno de uma mesma tecnologia
16-
sob diferentes ângulos.
9+
O propósito do OpenTelemetry é coletar, processar e exportar [sinais]. Sinais
10+
são dados emitidos que descrevem a atividade subjacente do sistema operacional e
11+
das aplicações que estão sendo executadas em uma plataforma. Um sinal pode ser
12+
algo que você deseja medir em um momento específico, como a temperatura ou o uso
13+
de memória, ou um evento que passa pelos componentes do seu sistema distribuído
14+
e que você gostaria de rastrear. Você pode agrupar diferentes sinais para
15+
observar o funcionamento interno de uma mesma tecnologia sob diferentes ângulos.
1716

18-
O OpenTelemetry atualmente suporta [rastros](/docs/concepts/signals/traces),
19-
[métricas](/docs/concepts/signals/metrics), [logs](/docs/concepts/signals/logs)
20-
e [bagagem](/docs/concepts/signals/baggage). Eventos são um tipo específico de
21-
log, e o
22-
[perfilamento está sendo trabalhado](https://github.com/open-telemetry/opentelemetry-specification/blob/main/oteps/profiles/0212-profiling-vision.md)
23-
pelo Grupo de Trabalho de Perfilamento _(Profiling Working Group)_.
17+
O OpenTelemetry atualmente suporta:
2418

19+
- [Rastros](traces)
20+
- [Métricas](metrics)
21+
- [Logs](logs)
22+
- [Bagagem](baggage)
23+
24+
Também em desenvolvimento ou na fase de [proposta]:
25+
26+
- [Eventos], um tipo específico de [log](logs)
27+
- [Perfilamento] está sendo trabalhado pelo Grupo de Trabalho de Perfilamento
28+
_(Profiling Working Group)_.
29+
30+
[Eventos]: /docs/specs/otel/logs/data-model/#events
31+
[Perfilamento]:
32+
https://github.com/open-telemetry/opentelemetry-specification/blob/main/oteps/profiles/0212-profiling-vision.md
33+
[proposta]:
34+
https://github.com/open-telemetry/opentelemetry-specification/tree/main/oteps/#readme
2535
[sinais]: /docs/specs/otel/glossary/#signals

content/pt/docs/concepts/signals/baggage.md

+18-20
Original file line numberDiff line numberDiff line change
@@ -2,21 +2,19 @@
22
title: Bagagem
33
weight: 4
44
description: Informações contextuais que são propagadas entre sinais
5-
default_lang_commit: 896255cae4fea454ffc4c559ea29b08ccebbfcb2
5+
default_lang_commit: 7c0e4db0b6c39b0ca0e7efb17df5610d1b77b8a3
66
---
77

88
No OpenTelemetry, Bagagem é uma informação contextual que acompanha o contexto.
99
Bagagem é uma estrutura de armazenamento chave-valor, que te permite
10-
[propagar](/docs/concepts/context-propagation/#propagation) quaisquer dados
11-
junto com o [contexto](/docs/concepts/context-propagation/#context).
10+
[propagar](../../context-propagation/#propagation) quaisquer dados junto com o
11+
[contexto](../../context-propagation/#context).
1212

1313
A Bagagem permite a transferência de dados entre serviços e processos,
14-
tornando-os acessíveis para serem adicionados a
15-
[rastros](/docs/concepts/signals/traces/),
16-
[métricas](/docs/concepts/signals/metrics/) ou
17-
[logs](/docs/concepts/signals/logs/) ao longo desses serviços.
14+
tornando-os acessíveis para serem adicionados a [rastros](../traces/),
15+
[métricas](../metrics/) ou [logs](../logs/) ao longo desses serviços.
1816

19-
## Exemplo
17+
## Exemplo {#example}
2018

2119
Bagagem é frequentemente usada em rastreamento para propagar dados adicionais
2220
entre serviços.
@@ -27,14 +25,14 @@ algumas métricas de outro serviço, e em alguns logs ao longo do caminho. Como
2725
rastro pode abranger vários serviços, você precisa de uma maneira de propagar
2826
esses dados sem copiar o `clientId` em diversos pontos do seu código.
2927

30-
Usando a
31-
[Propagação de Contexto](/docs/concepts/signals/traces/#context-propagation)
32-
para passar a bagagem entre esses serviços, o `clientId` estará disponível para
33-
ser adicionado a quaisquer trechos, métricas ou logs. Além disso, as
34-
instrumentações automaticamente propagam a Bagagem para você.
28+
Usando a [Propagação de Contexto](../traces/#context-propagation) para passar a
29+
bagagem entre esses serviços, o `clientId` estará disponível para ser adicionado
30+
a quaisquer trechos, métricas ou logs. Além disso, as instrumentações
31+
automaticamente propagam a Bagagem para você.
32+
3533
![OTel Baggage](../otel-baggage.svg)
3634

37-
## Para que a Bagagem do OTel deve ser usada?
35+
## Para que a Bagagem do OTel deve ser usada? {#what-should-otel-baggage-be-used-for}
3836

3937
A Bagagem é mais adequada para incluir informações que normalmente estão
4038
disponíveis apenas no início de uma requisição e que precisam ser propagadas
@@ -51,7 +49,7 @@ usuário nos dados do log.
5149

5250
![OTel Baggage](../otel-baggage-2.svg)
5351

54-
## Considerações de segurança da Bagagem
52+
## Considerações de segurança da Bagagem {#baggage-security-considerations}
5553

5654
Itens sensíveis da Bagagem podem ser compartilhados com recursos não
5755
intencionais, como APIs de terceiros. Isso ocorre porque a instrumentação
@@ -65,7 +63,7 @@ podem propagar a Bagagem fora da sua rede.
6563
Além disso, não há verificações de integridade automáticas para garantir que os
6664
itens de Bagagem sejam legítimos, portanto, tenha cautela ao acessá-los.
6765

68-
## Bagagem não é o mesmo que atributos
66+
## Bagagem não é o mesmo que atributos {#baggage-is-not-the-same-as-attributes}
6967

7068
É importante destacar que a Bagagem é um armazenamento de chave-valor separado e
7169
não está ligada aos atributos de trechos, métricas ou logs sem que seja
@@ -76,10 +74,10 @@ explicitamente os dados da Bagagem e adicioná-los como atributos aos seus
7674
trechos, métricas ou logs.
7775

7876
Como um dos casos de uso comum da Bagagem é adicionar dados aos
79-
[Atributos de Trecho](/docs/concepts/signals/traces/#attributes) ao longo de
80-
todo um rastro, várias linguagens possuem Processadores de Trecho de Bagagem que
81-
adicionam dados da Bagagem como atributos na criação de trechos.
77+
[Atributos de Trecho](../traces/#attributes) ao longo de todo um rastro, várias
78+
linguagens possuem Processadores de Trecho de Bagagem que adicionam dados da
79+
Bagagem como atributos na criação de trechos.
8280

83-
Para mais informações, consulte a [especificação da Bagagem][].
81+
Para mais informações, consulte a [especificação da Bagagem].
8482

8583
[especificação da Bagagem]: /docs/specs/otel/overview/#baggage-signal

content/pt/docs/concepts/signals/logs.md

+3-3
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: Logs
33
description: Um registro de um evento.
44
weight: 3
5-
default_lang_commit: ebc9a3a9f07278110677f4f8f69291a02704746b
5+
default_lang_commit: 7c0e4db0b6c39b0ca0e7efb17df5610d1b77b8a3
66
cSpell:ignore: filelogreceiver semistructured transformprocessor
77
---
88

@@ -18,7 +18,7 @@ O OpenTelemetry não possui uma especificação de API ou SDK própria para gera
1818
logs. Em vez disso, os logs no OpenTelemetry são os logs que você já possui, que
1919
foram gerados por um framework de _logging_ ou componente de infraestrutura. Os
2020
SDKs e a autoinstrumentação do OpenTelemetry utilizam vários componentes para
21-
correlacionar automaticamente logs com [rastros](/docs/concepts/signals/traces).
21+
correlacionar automaticamente logs com [rastros](../traces).
2222

2323
O suporte do OpenTelemetry para logs é projetado para ser totalmente compatível
2424
com o que você já possui, oferecendo a capacidade de adicionar contextos a esses
@@ -27,7 +27,7 @@ comum, abrangendo diversas fontes.
2727

2828
### Logs do OpenTelemetry no OpenTelemetry Collector {#opentelemetry-logs-in-the-opentelemetry-collector}
2929

30-
O [OpenTelemetry Collector](/docs/collector) fornece várias ferramentas para
30+
O [OpenTelemetry Collector](/docs/collector/) fornece várias ferramentas para
3131
trabalhar com logs:
3232

3333
- Vários _receivers_ que analisam logs de fontes específicas e conhecidas de

content/pt/docs/concepts/signals/metrics.md

+7-7
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: Métricas
33
weight: 2
44
description: Uma medição capturada em tempo de execução.
5-
default_lang_commit: eb19d1dd5ab2f66343ec76adbfb31f81024da3a1
5+
default_lang_commit: 7c0e4db0b6c39b0ca0e7efb17df5610d1b77b8a3
66
---
77

88
Uma métrica é uma medição de um serviço capturada em tempo de execução. O
@@ -71,7 +71,7 @@ O tipo de instrumento deve ser um dos seguintes:
7171
tenha acesso às mudanças contínuas, mas apenas ao valor agregado (ex., atual
7272
tamanho da fila).
7373
- **Gauge**: Mede o valor atual no momento da leitura. Um exemplo seria um
74-
medidor de tanque de combustível de um veículo. Gauges são assíncronos.
74+
medidor de tanque de combustível de um veículo. Gauges são síncronos.
7575
- **Asynchronous Gauge**: Assim como o **Gauge**, porém é coletado uma vez a
7676
cada exportação. Pode ser usado em casos onde você não tenha acesso às
7777
mudanças contínuas, mas apenas ao valor agregado.
@@ -94,11 +94,11 @@ para cada instrumento de medição, que podem ser sobrescritas com o uso de
9494
_Views_. Por padrão, o projeto OpenTelemetry visa fornecer agregações que sejam
9595
suportadas por diferentes visualizadores e backends de telemetria.
9696

97-
Ao contrário dos [rastros](/docs/concepts/signals/traces/), que são destinados a
98-
capturar os ciclos de vida das requisições e fornecer o contexto para as partes
99-
individuais de uma requisição, as métricas são destinadas a fornecer informações
100-
estatísticas em forma de dados agregados. Alguns exemplos de caso de uso para as
101-
métricas incluem:
97+
Ao contrário dos [rastros](../traces/), que são destinados a capturar os ciclos
98+
de vida das requisições e fornecer o contexto para as partes individuais de uma
99+
requisição, as métricas são destinadas a fornecer informações estatísticas em
100+
forma de dados agregados. Alguns exemplos de caso de uso para as métricas
101+
incluem:
102102

103103
- Reportar o número total de _bytes_ lidos por um serviço, por tipo de
104104
protocolo.

content/pt/docs/concepts/signals/traces.md

+13-11
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: Rastros
33
weight: 1
44
description: O caminho de uma solicitação através do seu aplicativo.
5-
default_lang_commit: 57cd4f78d61cc1642ce56089aeec7ae278544194
5+
default_lang_commit: 7c0e4db0b6c39b0ca0e7efb17df5610d1b77b8a3
66
---
77

88
Os **rastros** nos fornecem uma visão geral do que acontece quando uma
@@ -27,8 +27,8 @@ trecho `olá`:
2727
{
2828
"name": "olá",
2929
"context": {
30-
"trace_id": "0x5b8aa5a2d2c872e8321cf37308d69df2",
31-
"span_id": "0x051581bf3cb55c13"
30+
"trace_id": "5b8aa5a2d2c872e8321cf37308d69df2",
31+
"span_id": "051581bf3cb55c13"
3232
},
3333
"parent_id": null,
3434
"start_time": "2022-04-29T18:52:58.114201Z",
@@ -58,10 +58,10 @@ O trecho `olá-cumprimentos`:
5858
{
5959
"name": "olá-cumprimentos",
6060
"context": {
61-
"trace_id": "0x5b8aa5a2d2c872e8321cf37308d69df2",
61+
"trace_id": "5b8aa5a2d2c872e8321cf37308d69df2",
6262
"span_id": "0x5fb397be34d26b51"
6363
},
64-
"parent_id": "0x051581bf3cb55c13",
64+
"parent_id": "051581bf3cb55c13",
6565
"start_time": "2022-04-29T18:52:58.114304Z",
6666
"end_time": "2022-04-29T22:52:58.114561Z",
6767
"attributes": {
@@ -97,10 +97,10 @@ O trecho `olá-saudações`:
9797
{
9898
"name": "olá-saudações",
9999
"context": {
100-
"trace_id": "0x5b8aa5a2d2c872e8321cf37308d69df2",
101-
"span_id": "0x93564f51e1abe1c2"
100+
"trace_id": "5b8aa5a2d2c872e8321cf37308d69df2",
101+
"span_id": "5fb397be34d26b51"
102102
},
103-
"parent_id": "0x051581bf3cb55c13",
103+
"parent_id": "051581bf3cb55c13",
104104
"start_time": "2022-04-29T18:52:58.114492Z",
105105
"end_time": "2022-04-29T18:52:58.114631Z",
106106
"attributes": {
@@ -163,7 +163,7 @@ A propagação de contexto é o conceito central que possibilita o rastreamento
163163
distribuído. Com a propagação de contexto, trechos podem ser correlacionados
164164
entre si e montados em um rastro, independentemente de onde os trechos são
165165
gerados. Para saber mais sobre este tópico, consulte a página de conceitos sobre
166-
[Propagação de Contexto](/docs/concepts/context-propagation).
166+
[Propagação de Contexto](../../context-propagation).
167167

168168
## Trechos {#spans}
169169

@@ -234,8 +234,7 @@ O contexto do trecho é um objeto imutável em cada trecho que contém o seguint
234234
rastro específicos do fornecedor
235235

236236
O contexto do trecho é a parte de um trecho que é serializada e propagada junto
237-
com a [propagação de contexto](#context-propagation) e
238-
[baggage](/docs/concepts/signals/baggage).
237+
com a [Propagação de Contexto](#context-propagation) e [Baggage](../baggage).
239238

240239
Como o contexto do trecho contém o trace ID, o trace ID é usado ao criar
241240
[links de trechos](#span-links).
@@ -318,6 +317,9 @@ segundo rastro. Agora, eles estão causalmente associados entre si.
318317
Os links são opcionais, mas servem como uma boa maneira de associar trechos de
319318
rastro uns aos outros.
320319

320+
Para mais informações sobre Links de Trechos, consulte
321+
[Link](/docs/specs/otel/trace/api/#link).
322+
321323
### O estado do Trecho {#span-status}
322324

323325
Cada trecho tem um estado. Os três valores possíveis são:

0 commit comments

Comments
 (0)