From b7623b4659d7bc1c86cb6c8244c1c542c7a5432b Mon Sep 17 00:00:00 2001 From: Ezzio Moreira Date: Thu, 12 Sep 2024 21:25:40 -0300 Subject: [PATCH 1/7] feat: add pt-br baggage --- content/pt/docs/concepts/signals/baggage.md | 85 +++++++++++++++++++++ 1 file changed, 85 insertions(+) create mode 100644 content/pt/docs/concepts/signals/baggage.md diff --git a/content/pt/docs/concepts/signals/baggage.md b/content/pt/docs/concepts/signals/baggage.md new file mode 100644 index 000000000000..e9bb914c6686 --- /dev/null +++ b/content/pt/docs/concepts/signals/baggage.md @@ -0,0 +1,85 @@ +--- +title: Bagagem +weight: 4 +description: Informações contextuais que são passadas entre sinais +default_lang_commit: 896255cae4fea454ffc4c559ea29b08ccebbfcb2 +--- + +No OpenTelemetry, Bagagem é uma informação contextual que acompanha o contexto. +Bagagem é uma estrutura de armazenamento de chave-valor, que permite você +[propagar](/docs/concepts/context-propagation/#propagation) quaisquer dados +junto com o [contexto](/docs/concepts/context-propagation/#context). + +A Bagagem permite a transferência de dados entre serviços e processos, +tornando-os acessíveis para serem adicionados a +[rastros](/docs/concepts/signals/traces/), +[métricas](/docs/concepts/signals/metrics/) ou +[logs](/docs/concepts/signals/logs/) ao longo desses serviços. + +## Exemplo + +Bagagem é frequentemente usada em rastreamento para propagar dados adicionais +entre serviços. + +Por exemplo, imagine que você tem um `clientId` no início de uma requisição, mas +deseja que esse ID esteja disponível em todos os trechos de um rastro, em +algumas métricas de outro serviço, e em alguns logs ao longo do caminho. Como o +rastreamento pode abranger vários serviços, você precisa de uma maneira de +propagar esses dados sem copiar o `clientId` em diversos pontos do seu código. + +Usando a +[Propagação de Contexto](/docs/concepts/signals/traces/#context-propagation) +para passar a bagagem entre esses serviços, o `clientId` estará disponível para +ser adicionado a quaisquer trechos, métricas ou logs. Além disso, as +instrumentações automaticamente propagam a Bagagem para você. +![OTel Baggage](/img/otel-baggage.svg) + +## Para que a Bagagem do OTel deve ser usada? + +A Bagagem é mais adequada para incluir informações que normalmente estão +disponíveis apenas no início de uma solicitação e que precisam ser propagadas +para estágios posteriores. Isso pode incluir, por exemplo, coisas como +identificação de conta, IDs de usuários, IDs de produtos e IPs de origem. + +Propagar essas informações usando Bagagem permite uma análise mais profunda da +telemetria em um sistema de _backend_. Por exemplo, se você incluir uma +informação como o ID do usuário em um trecho que rastreia uma chamada de banco +de dados, fica muito mais fácil responder a perguntas como "quais usuários estão +enfrentando as chamadas de banco de dados mais lentas?". Você também pode +registrar informações sobre uma operação posterior e incluir esse mesmo ID de +usuário nos dados do log. + +![OTel Baggage](/img/otel-baggage-2.svg) + +## Considerações de segurança da Bagagem + +Itens de Bagagem sensíveis podem ser compartilhados com recursos não +intencionais, como APIs de terceiros. Isso ocorre porque a instrumentação +automática inclui Bagagem na maioria das requisições de rede do seu serviço. +Especificamente, a Bagagem e outras partes do contexto do rastro são enviadas +nos cabeçalhos HTTP, tornando-os visíveis para qualquer pessoa que esteja +inspecionando o tráfego de rede. Se o tráfego estiver restrito dentro da sua +rede, esse risco pode não se aplicar, mas lembre-se de que serviços _downstream_ +podem propagar a Bagagem fora da sua rede. + +Além disso, não há verificações de integridade automáticas para garantir que os +itens de Bagagem sejam legítimos, portanto, tenha cautela ao acessá-los. + +## Bagagem não é o mesmo que atributos + +É importante salientar que a Bagagem é um armazenamento de chave-valor separado +e não está ligada aos atributos de trechos, métricas ou logs sem que esses sejam +adicionados de forma explícita. + +Para adicionar entradas de Bagagem como atributos, é necessário ler +explicitamente os dados da Bagagem e adicioná-los como atributos aos seus +trechos, métricas ou logs. + +Como um dos casos de uso comum da Bagagem é adicionar dados aos +[Atributos de Trecho](/docs/concepts/signals/traces/#attributes) ao longo de +todo um rastro, várias linguagens possuem Processadores de Trecho de Bagagem que +adicionam dados da Bagagem como atributos na criação de trechos. + +Para mais informações, consulte a [especificação da Bagagem][]. + +[especificação da Bagagem]: /docs/specs/otel/overview/#baggage-signal From cf977b0b9e3fbb6c63fd6d9c7633f78c35eba1c3 Mon Sep 17 00:00:00 2001 From: Ezzio Moreira Date: Sat, 14 Sep 2024 10:04:26 -0300 Subject: [PATCH 2/7] fix: apply suggestions from code review Co-authored-by: Marylia Gutierrez --- content/pt/docs/concepts/signals/baggage.md | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/content/pt/docs/concepts/signals/baggage.md b/content/pt/docs/concepts/signals/baggage.md index e9bb914c6686..9d06725e5e69 100644 --- a/content/pt/docs/concepts/signals/baggage.md +++ b/content/pt/docs/concepts/signals/baggage.md @@ -6,7 +6,7 @@ default_lang_commit: 896255cae4fea454ffc4c559ea29b08ccebbfcb2 --- No OpenTelemetry, Bagagem é uma informação contextual que acompanha o contexto. -Bagagem é uma estrutura de armazenamento de chave-valor, que permite você +Bagagem é uma estrutura de armazenamento chave-valor, que te permite [propagar](/docs/concepts/context-propagation/#propagation) quaisquer dados junto com o [contexto](/docs/concepts/context-propagation/#context). @@ -24,7 +24,7 @@ entre serviços. Por exemplo, imagine que você tem um `clientId` no início de uma requisição, mas deseja que esse ID esteja disponível em todos os trechos de um rastro, em algumas métricas de outro serviço, e em alguns logs ao longo do caminho. Como o -rastreamento pode abranger vários serviços, você precisa de uma maneira de +rastro pode abranger vários serviços, você precisa de uma maneira de propagar esses dados sem copiar o `clientId` em diversos pontos do seu código. Usando a @@ -42,7 +42,7 @@ para estágios posteriores. Isso pode incluir, por exemplo, coisas como identificação de conta, IDs de usuários, IDs de produtos e IPs de origem. Propagar essas informações usando Bagagem permite uma análise mais profunda da -telemetria em um sistema de _backend_. Por exemplo, se você incluir uma +telemetria em um sistema de backend. Por exemplo, se você incluir uma informação como o ID do usuário em um trecho que rastreia uma chamada de banco de dados, fica muito mais fácil responder a perguntas como "quais usuários estão enfrentando as chamadas de banco de dados mais lentas?". Você também pode @@ -53,9 +53,9 @@ usuário nos dados do log. ## Considerações de segurança da Bagagem -Itens de Bagagem sensíveis podem ser compartilhados com recursos não +Itens sensíveis da Bagagem podem ser compartilhados com recursos não intencionais, como APIs de terceiros. Isso ocorre porque a instrumentação -automática inclui Bagagem na maioria das requisições de rede do seu serviço. +automática inclui a Bagagem na maioria das requisições de rede do seu serviço. Especificamente, a Bagagem e outras partes do contexto do rastro são enviadas nos cabeçalhos HTTP, tornando-os visíveis para qualquer pessoa que esteja inspecionando o tráfego de rede. Se o tráfego estiver restrito dentro da sua @@ -68,10 +68,10 @@ itens de Bagagem sejam legítimos, portanto, tenha cautela ao acessá-los. ## Bagagem não é o mesmo que atributos É importante salientar que a Bagagem é um armazenamento de chave-valor separado -e não está ligada aos atributos de trechos, métricas ou logs sem que esses sejam -adicionados de forma explícita. +e não está ligada aos atributos de trechos, métricas ou logs sem que seja +adicionada de forma explícita. -Para adicionar entradas de Bagagem como atributos, é necessário ler +Para adicionar valores da Bagagem como atributos, é necessário ler explicitamente os dados da Bagagem e adicioná-los como atributos aos seus trechos, métricas ou logs. From 004dbb68bcaa5f6574cfa11e23818eb5ea5c2cd7 Mon Sep 17 00:00:00 2001 From: Ezzio Moreira Date: Sat, 14 Sep 2024 10:07:37 -0300 Subject: [PATCH 3/7] fix: run lint local --- content/pt/docs/concepts/signals/baggage.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/content/pt/docs/concepts/signals/baggage.md b/content/pt/docs/concepts/signals/baggage.md index 9d06725e5e69..2ac7903cc9df 100644 --- a/content/pt/docs/concepts/signals/baggage.md +++ b/content/pt/docs/concepts/signals/baggage.md @@ -24,8 +24,8 @@ entre serviços. Por exemplo, imagine que você tem um `clientId` no início de uma requisição, mas deseja que esse ID esteja disponível em todos os trechos de um rastro, em algumas métricas de outro serviço, e em alguns logs ao longo do caminho. Como o -rastro pode abranger vários serviços, você precisa de uma maneira de -propagar esses dados sem copiar o `clientId` em diversos pontos do seu código. +rastro pode abranger vários serviços, você precisa de uma maneira de propagar +esses dados sem copiar o `clientId` em diversos pontos do seu código. Usando a [Propagação de Contexto](/docs/concepts/signals/traces/#context-propagation) @@ -42,9 +42,9 @@ para estágios posteriores. Isso pode incluir, por exemplo, coisas como identificação de conta, IDs de usuários, IDs de produtos e IPs de origem. Propagar essas informações usando Bagagem permite uma análise mais profunda da -telemetria em um sistema de backend. Por exemplo, se você incluir uma -informação como o ID do usuário em um trecho que rastreia uma chamada de banco -de dados, fica muito mais fácil responder a perguntas como "quais usuários estão +telemetria em um sistema de backend. Por exemplo, se você incluir uma informação +como o ID do usuário em um trecho que rastreia uma chamada de banco de dados, +fica muito mais fácil responder a perguntas como "quais usuários estão enfrentando as chamadas de banco de dados mais lentas?". Você também pode registrar informações sobre uma operação posterior e incluir esse mesmo ID de usuário nos dados do log. From 433c51ee9b95f57a85061910450e949ce098b293 Mon Sep 17 00:00:00 2001 From: Ezzio Moreira Date: Tue, 17 Sep 2024 07:35:50 -0300 Subject: [PATCH 4/7] fix: apply suggestions from code review --- content/pt/docs/concepts/signals/baggage.md | 22 ++++++++++----------- 1 file changed, 11 insertions(+), 11 deletions(-) diff --git a/content/pt/docs/concepts/signals/baggage.md b/content/pt/docs/concepts/signals/baggage.md index 2ac7903cc9df..ba2550d3c8ff 100644 --- a/content/pt/docs/concepts/signals/baggage.md +++ b/content/pt/docs/concepts/signals/baggage.md @@ -1,20 +1,20 @@ --- title: Bagagem weight: 4 -description: Informações contextuais que são passadas entre sinais +description: Informações contextuais que são propagadas entre sinais default_lang_commit: 896255cae4fea454ffc4c559ea29b08ccebbfcb2 --- No OpenTelemetry, Bagagem é uma informação contextual que acompanha o contexto. Bagagem é uma estrutura de armazenamento chave-valor, que te permite -[propagar](/docs/concepts/context-propagation/#propagation) quaisquer dados -junto com o [contexto](/docs/concepts/context-propagation/#context). +[propagar](pt/docs/concepts/context-propagation/#propagation) quaisquer dados +junto com o [contexto](pt/docs/concepts/context-propagation/#context). A Bagagem permite a transferência de dados entre serviços e processos, tornando-os acessíveis para serem adicionados a -[rastros](/docs/concepts/signals/traces/), -[métricas](/docs/concepts/signals/metrics/) ou -[logs](/docs/concepts/signals/logs/) ao longo desses serviços. +[rastros](pt/docs/concepts/signals/traces/), +[métricas](pt/docs/concepts/signals/metrics/) ou +[logs](pt/docs/concepts/signals/logs/) ao longo desses serviços. ## Exemplo @@ -28,7 +28,7 @@ rastro pode abranger vários serviços, você precisa de uma maneira de propagar esses dados sem copiar o `clientId` em diversos pontos do seu código. Usando a -[Propagação de Contexto](/docs/concepts/signals/traces/#context-propagation) +[Propagação de Contexto](pt/docs/concepts/signals/traces/#context-propagation) para passar a bagagem entre esses serviços, o `clientId` estará disponível para ser adicionado a quaisquer trechos, métricas ou logs. Além disso, as instrumentações automaticamente propagam a Bagagem para você. @@ -37,7 +37,7 @@ instrumentações automaticamente propagam a Bagagem para você. ## Para que a Bagagem do OTel deve ser usada? A Bagagem é mais adequada para incluir informações que normalmente estão -disponíveis apenas no início de uma solicitação e que precisam ser propagadas +disponíveis apenas no início de uma requisição e que precisam ser propagadas para estágios posteriores. Isso pode incluir, por exemplo, coisas como identificação de conta, IDs de usuários, IDs de produtos e IPs de origem. @@ -67,8 +67,8 @@ itens de Bagagem sejam legítimos, portanto, tenha cautela ao acessá-los. ## Bagagem não é o mesmo que atributos -É importante salientar que a Bagagem é um armazenamento de chave-valor separado -e não está ligada aos atributos de trechos, métricas ou logs sem que seja +É importante destacar que a Bagagem é um armazenamento de chave-valor separado e +não está ligada aos atributos de trechos, métricas ou logs sem que seja adicionada de forma explícita. Para adicionar valores da Bagagem como atributos, é necessário ler @@ -76,7 +76,7 @@ explicitamente os dados da Bagagem e adicioná-los como atributos aos seus trechos, métricas ou logs. Como um dos casos de uso comum da Bagagem é adicionar dados aos -[Atributos de Trecho](/docs/concepts/signals/traces/#attributes) ao longo de +[Atributos de Trecho](pt/docs/concepts/signals/traces/#attributes) ao longo de todo um rastro, várias linguagens possuem Processadores de Trecho de Bagagem que adicionam dados da Bagagem como atributos na criação de trechos. From 610e84076e113232ce3696274cb1b712f511710e Mon Sep 17 00:00:00 2001 From: Ezzio Moreira Date: Tue, 17 Sep 2024 07:45:20 -0300 Subject: [PATCH 5/7] fix: revert path /pt --- content/pt/docs/concepts/signals/baggage.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/content/pt/docs/concepts/signals/baggage.md b/content/pt/docs/concepts/signals/baggage.md index ba2550d3c8ff..07997674e7d5 100644 --- a/content/pt/docs/concepts/signals/baggage.md +++ b/content/pt/docs/concepts/signals/baggage.md @@ -7,14 +7,14 @@ default_lang_commit: 896255cae4fea454ffc4c559ea29b08ccebbfcb2 No OpenTelemetry, Bagagem é uma informação contextual que acompanha o contexto. Bagagem é uma estrutura de armazenamento chave-valor, que te permite -[propagar](pt/docs/concepts/context-propagation/#propagation) quaisquer dados -junto com o [contexto](pt/docs/concepts/context-propagation/#context). +[propagar](docs/concepts/context-propagation/#propagation) quaisquer dados +junto com o [contexto](docs/concepts/context-propagation/#context). A Bagagem permite a transferência de dados entre serviços e processos, tornando-os acessíveis para serem adicionados a -[rastros](pt/docs/concepts/signals/traces/), -[métricas](pt/docs/concepts/signals/metrics/) ou -[logs](pt/docs/concepts/signals/logs/) ao longo desses serviços. +[rastros](docs/concepts/signals/traces/), +[métricas](docs/concepts/signals/metrics/) ou +[logs](docs/concepts/signals/logs/) ao longo desses serviços. ## Exemplo @@ -28,7 +28,7 @@ rastro pode abranger vários serviços, você precisa de uma maneira de propagar esses dados sem copiar o `clientId` em diversos pontos do seu código. Usando a -[Propagação de Contexto](pt/docs/concepts/signals/traces/#context-propagation) +[Propagação de Contexto](docs/concepts/signals/traces/#context-propagation) para passar a bagagem entre esses serviços, o `clientId` estará disponível para ser adicionado a quaisquer trechos, métricas ou logs. Além disso, as instrumentações automaticamente propagam a Bagagem para você. @@ -76,7 +76,7 @@ explicitamente os dados da Bagagem e adicioná-los como atributos aos seus trechos, métricas ou logs. Como um dos casos de uso comum da Bagagem é adicionar dados aos -[Atributos de Trecho](pt/docs/concepts/signals/traces/#attributes) ao longo de +[Atributos de Trecho](docs/concepts/signals/traces/#attributes) ao longo de todo um rastro, várias linguagens possuem Processadores de Trecho de Bagagem que adicionam dados da Bagagem como atributos na criação de trechos. From 19ba274cf437a4be4ad5bfb763c1e39a1d2d869f Mon Sep 17 00:00:00 2001 From: Ezzio Moreira Date: Tue, 17 Sep 2024 07:54:25 -0300 Subject: [PATCH 6/7] fix: run lint local --- content/pt/docs/concepts/signals/baggage.md | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/content/pt/docs/concepts/signals/baggage.md b/content/pt/docs/concepts/signals/baggage.md index 07997674e7d5..b81353c20e4c 100644 --- a/content/pt/docs/concepts/signals/baggage.md +++ b/content/pt/docs/concepts/signals/baggage.md @@ -7,8 +7,8 @@ default_lang_commit: 896255cae4fea454ffc4c559ea29b08ccebbfcb2 No OpenTelemetry, Bagagem é uma informação contextual que acompanha o contexto. Bagagem é uma estrutura de armazenamento chave-valor, que te permite -[propagar](docs/concepts/context-propagation/#propagation) quaisquer dados -junto com o [contexto](docs/concepts/context-propagation/#context). +[propagar](docs/concepts/context-propagation/#propagation) quaisquer dados junto +com o [contexto](docs/concepts/context-propagation/#context). A Bagagem permite a transferência de dados entre serviços e processos, tornando-os acessíveis para serem adicionados a @@ -28,10 +28,10 @@ rastro pode abranger vários serviços, você precisa de uma maneira de propagar esses dados sem copiar o `clientId` em diversos pontos do seu código. Usando a -[Propagação de Contexto](docs/concepts/signals/traces/#context-propagation) -para passar a bagagem entre esses serviços, o `clientId` estará disponível para -ser adicionado a quaisquer trechos, métricas ou logs. Além disso, as -instrumentações automaticamente propagam a Bagagem para você. +[Propagação de Contexto](docs/concepts/signals/traces/#context-propagation) para +passar a bagagem entre esses serviços, o `clientId` estará disponível para ser +adicionado a quaisquer trechos, métricas ou logs. Além disso, as instrumentações +automaticamente propagam a Bagagem para você. ![OTel Baggage](/img/otel-baggage.svg) ## Para que a Bagagem do OTel deve ser usada? @@ -76,8 +76,8 @@ explicitamente os dados da Bagagem e adicioná-los como atributos aos seus trechos, métricas ou logs. Como um dos casos de uso comum da Bagagem é adicionar dados aos -[Atributos de Trecho](docs/concepts/signals/traces/#attributes) ao longo de -todo um rastro, várias linguagens possuem Processadores de Trecho de Bagagem que +[Atributos de Trecho](docs/concepts/signals/traces/#attributes) ao longo de todo +um rastro, várias linguagens possuem Processadores de Trecho de Bagagem que adicionam dados da Bagagem como atributos na criação de trechos. Para mais informações, consulte a [especificação da Bagagem][]. From 1f73899530b0532b8e12fbe004ccaadd70c64ab5 Mon Sep 17 00:00:00 2001 From: Ezzio Moreira Date: Thu, 19 Sep 2024 20:20:01 -0300 Subject: [PATCH 7/7] fix: run lint local --- content/pt/docs/concepts/signals/baggage.md | 22 ++++++++++----------- 1 file changed, 11 insertions(+), 11 deletions(-) diff --git a/content/pt/docs/concepts/signals/baggage.md b/content/pt/docs/concepts/signals/baggage.md index b81353c20e4c..b4f27c9039d0 100644 --- a/content/pt/docs/concepts/signals/baggage.md +++ b/content/pt/docs/concepts/signals/baggage.md @@ -7,14 +7,14 @@ default_lang_commit: 896255cae4fea454ffc4c559ea29b08ccebbfcb2 No OpenTelemetry, Bagagem é uma informação contextual que acompanha o contexto. Bagagem é uma estrutura de armazenamento chave-valor, que te permite -[propagar](docs/concepts/context-propagation/#propagation) quaisquer dados junto -com o [contexto](docs/concepts/context-propagation/#context). +[propagar](/docs/concepts/context-propagation/#propagation) quaisquer dados +junto com o [contexto](/docs/concepts/context-propagation/#context). A Bagagem permite a transferência de dados entre serviços e processos, tornando-os acessíveis para serem adicionados a -[rastros](docs/concepts/signals/traces/), -[métricas](docs/concepts/signals/metrics/) ou -[logs](docs/concepts/signals/logs/) ao longo desses serviços. +[rastros](/docs/concepts/signals/traces/), +[métricas](/docs/concepts/signals/metrics/) ou +[logs](/docs/concepts/signals/logs/) ao longo desses serviços. ## Exemplo @@ -28,10 +28,10 @@ rastro pode abranger vários serviços, você precisa de uma maneira de propagar esses dados sem copiar o `clientId` em diversos pontos do seu código. Usando a -[Propagação de Contexto](docs/concepts/signals/traces/#context-propagation) para -passar a bagagem entre esses serviços, o `clientId` estará disponível para ser -adicionado a quaisquer trechos, métricas ou logs. Além disso, as instrumentações -automaticamente propagam a Bagagem para você. +[Propagação de Contexto](/docs/concepts/signals/traces/#context-propagation) +para passar a bagagem entre esses serviços, o `clientId` estará disponível para +ser adicionado a quaisquer trechos, métricas ou logs. Além disso, as +instrumentações automaticamente propagam a Bagagem para você. ![OTel Baggage](/img/otel-baggage.svg) ## Para que a Bagagem do OTel deve ser usada? @@ -76,8 +76,8 @@ explicitamente os dados da Bagagem e adicioná-los como atributos aos seus trechos, métricas ou logs. Como um dos casos de uso comum da Bagagem é adicionar dados aos -[Atributos de Trecho](docs/concepts/signals/traces/#attributes) ao longo de todo -um rastro, várias linguagens possuem Processadores de Trecho de Bagagem que +[Atributos de Trecho](/docs/concepts/signals/traces/#attributes) ao longo de +todo um rastro, várias linguagens possuem Processadores de Trecho de Bagagem que adicionam dados da Bagagem como atributos na criação de trechos. Para mais informações, consulte a [especificação da Bagagem][].