From 4641bcb3b04bd5574a664504f6d89bb1a772a2bf Mon Sep 17 00:00:00 2001 From: Vitor Vasconcellos Date: Mon, 3 Feb 2025 20:46:18 -0300 Subject: [PATCH 1/5] [pt] Update localized content on content/pt/docs/concepts/sampling/index.md (#6160) Co-authored-by: opentelemetrybot <107717825+opentelemetrybot@users.noreply.github.com> Co-authored-by: Patrice Chalin --- content/pt/docs/concepts/sampling/index.md | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/content/pt/docs/concepts/sampling/index.md b/content/pt/docs/concepts/sampling/index.md index 3288147887ca..85ff98c3537d 100644 --- a/content/pt/docs/concepts/sampling/index.md +++ b/content/pt/docs/concepts/sampling/index.md @@ -4,7 +4,7 @@ description: Aprenda sobre amostragem e explore as diferentes opções disponíveis no OpenTelemetry. weight: 80 -default_lang_commit: de60a8e2c5098e47eda3e12b006c5490bdb8a94e +default_lang_commit: 49879d0c00a4a28c963a76998f7213af7b539c77 --- Com [rastros](/docs/concepts/signals/traces), você pode observar as requisições @@ -19,7 +19,7 @@ da amostragem correta. ![Ilustração mostrando que nem todos os dados precisam ser rastreados, e que uma amostra de dados é suficiente](traces-venn-diagram.png) -## Terminologia +## Terminologia {#terminology} É importante usar uma terminologia consistente ao discutir amostragem. Um rastro ou trecho é considerado "amostrado" (_sampled_) ou "não amostrado" (_not @@ -35,7 +35,7 @@ sampled_): dizendo que está "amostrando dados" ou que os dados não processados ou exportados são considerados "amostrados". Essas afirmações estão incorretas. -## Por que usar amostragem? +## Por que usar amostragem? {#why-sampling} A amostragem é uma das formas mais eficazes de reduzir os custos de observabilidade sem perder visibilidade. Embora existam outras maneiras de @@ -53,7 +53,7 @@ ter uma amostra representativa. Para sistemas de alto volume, é muito comum que uma taxa de amostragem de 1% ou menos represente com bastante precisão os outros 99% dos dados. -## Quando usar amostragem +### Quando usar amostragem {#when-to-sample} Considere usar amostragem se você atender a qualquer um dos seguintes critérios: @@ -75,7 +75,7 @@ Por fim, considere seu orçamento em geral. Se você tem um orçamento limitado para observabilidade, mas pode dedicar tempo para realizar uma amostragem eficaz, então a amostragem geralmente vale a pena. -## Quando não usar amostragem +### Quando não usar amostragem {#when-not-to-sample} A amostragem pode não servir para você. Você talvez queira evitar a amostragem se atender a qualquer um dos seguintes critérios: @@ -130,7 +130,7 @@ não pode garantir que todos os rastros com um erro sejam amostrados apenas com amostragem pela cabeça. Para essa situação e muitas outras, você precisa da amostragem pela cauda. -## Amostragem pela Cauda +## Amostragem pela Cauda {#tail-sampling} A amostragem pela cauda (_tail sampling_) é onde a decisão de amostrar um rastro acontece considerando todos ou a maioria dos trechos dentro do rastro. A @@ -188,7 +188,7 @@ tomar decisões de amostragem mais sofisticadas antes de exportar para um _backend_. Isso é frequentemente feito com o intuito de proteger o _pipeline_ de telemetria contra sobrecarga. -## Suporte +## Suporte {#support} ### Collector @@ -197,7 +197,7 @@ O OpenTelemetry Collector inclui os seguintes processadores de amostragem: - [Processador de Amostragem Probabilística](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/main/processor/probabilisticsamplerprocessor) - [Processador de Amostragem pela Cauda](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/main/processor/tailsamplingprocessor) -### SDKs de Linguagens de programação +### SDKs de Linguagens de programação {#language-sdks} Para as implementações específicas de cada linguagem da API e SDK do OpenTelemetry, você vai encontrar suporte para amostragem nas respectivas @@ -205,7 +205,7 @@ páginas de documentação: {{% sampling-support-list " " %}} -### Fornecedores +### Fornecedores {#vendors} Muitos [fornecedores](/ecosystem/vendors) oferecem soluções abrangentes de amostragem que incorporam amostragem pela cabeça, amostragem pela cauda e outros From 14223bd4bb29f5a29552f5ca0b8e8f93bb1d696c Mon Sep 17 00:00:00 2001 From: Vitor Vasconcellos Date: Mon, 3 Feb 2025 20:49:00 -0300 Subject: [PATCH 2/5] [pt] Update localized content under content/pt/docs/concepts/signals (#6157) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Emídio Neto <9735060+emdneto@users.noreply.github.com> --- content/pt/docs/concepts/signals/_index.md | 40 +++++++++++++-------- content/pt/docs/concepts/signals/baggage.md | 38 ++++++++++---------- content/pt/docs/concepts/signals/logs.md | 6 ++-- content/pt/docs/concepts/signals/metrics.md | 14 ++++---- content/pt/docs/concepts/signals/traces.md | 24 +++++++------ 5 files changed, 66 insertions(+), 56 deletions(-) diff --git a/content/pt/docs/concepts/signals/_index.md b/content/pt/docs/concepts/signals/_index.md index 7589c1e38338..d10c960ca502 100644 --- a/content/pt/docs/concepts/signals/_index.md +++ b/content/pt/docs/concepts/signals/_index.md @@ -3,23 +3,33 @@ title: Sinais description: Aprenda sobre as categorias de telemetria suportadas pelo OpenTelemetry weight: 11 -default_lang_commit: 08e13eb62f2869300301670675969be705db59ae +default_lang_commit: 7c0e4db0b6c39b0ca0e7efb17df5610d1b77b8a3 --- -O propósito do OpenTelemetry é coletar, processar e exportar **[sinais][]**. -Sinais são dados emitidos que descrevem a atividade subjacente do sistema -operacional e das aplicações que estão sendo executadas em uma plataforma. Um -sinal pode ser algo que você deseja medir em um momento específico, como a -temperatura ou o uso de memória, ou um evento que passa pelos componentes do seu -sistema distribuído e que você gostaria de rastrear. Você pode agrupar -diferentes sinais para observar o funcionamento interno de uma mesma tecnologia -sob diferentes ângulos. +O propósito do OpenTelemetry é coletar, processar e exportar [sinais]. Sinais +são dados emitidos que descrevem a atividade subjacente do sistema operacional e +das aplicações que estão sendo executadas em uma plataforma. Um sinal pode ser +algo que você deseja medir em um momento específico, como a temperatura ou o uso +de memória, ou um evento que passa pelos componentes do seu sistema distribuído +e que você gostaria de rastrear. Você pode agrupar diferentes sinais para +observar o funcionamento interno de uma mesma tecnologia sob diferentes ângulos. -O OpenTelemetry atualmente suporta [rastros](/docs/concepts/signals/traces), -[métricas](/docs/concepts/signals/metrics), [logs](/docs/concepts/signals/logs) -e [bagagem](/docs/concepts/signals/baggage). Eventos são um tipo específico de -log, e o -[perfilamento está sendo trabalhado](https://github.com/open-telemetry/opentelemetry-specification/blob/main/oteps/profiles/0212-profiling-vision.md) -pelo Grupo de Trabalho de Perfilamento _(Profiling Working Group)_. +O OpenTelemetry atualmente suporta: +- [Rastros](traces) +- [Métricas](metrics) +- [Logs](logs) +- [Bagagem](baggage) + +Também em desenvolvimento ou na fase de [proposta]: + +- [Eventos], um tipo específico de [log](logs) +- [Perfilamento] está sendo trabalhado pelo Grupo de Trabalho de Perfilamento + _(Profiling Working Group)_. + +[Eventos]: /docs/specs/otel/logs/data-model/#events +[Perfilamento]: + https://github.com/open-telemetry/opentelemetry-specification/blob/main/oteps/profiles/0212-profiling-vision.md +[proposta]: + https://github.com/open-telemetry/opentelemetry-specification/tree/main/oteps/#readme [sinais]: /docs/specs/otel/glossary/#signals diff --git a/content/pt/docs/concepts/signals/baggage.md b/content/pt/docs/concepts/signals/baggage.md index 525ac0b12e36..dbd1bab422a7 100644 --- a/content/pt/docs/concepts/signals/baggage.md +++ b/content/pt/docs/concepts/signals/baggage.md @@ -2,21 +2,19 @@ title: Bagagem weight: 4 description: Informações contextuais que são propagadas entre sinais -default_lang_commit: 896255cae4fea454ffc4c559ea29b08ccebbfcb2 +default_lang_commit: 7c0e4db0b6c39b0ca0e7efb17df5610d1b77b8a3 --- 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](../../context-propagation/#propagation) quaisquer dados junto com o +[contexto](../../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. +tornando-os acessíveis para serem adicionados a [rastros](../traces/), +[métricas](../metrics/) ou [logs](../logs/) ao longo desses serviços. -## Exemplo +## Exemplo {#example} Bagagem é frequentemente usada em rastreamento para propagar dados adicionais entre serviços. @@ -27,14 +25,14 @@ algumas métricas de outro serviço, e em alguns logs ao longo do caminho. Como 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ê. +Usando a [Propagação de Contexto](../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](../otel-baggage.svg) -## Para que a Bagagem do OTel deve ser usada? +## Para que a Bagagem do OTel deve ser usada? {#what-should-otel-baggage-be-used-for} A Bagagem é mais adequada para incluir informações que normalmente estão 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. ![OTel Baggage](../otel-baggage-2.svg) -## Considerações de segurança da Bagagem +## Considerações de segurança da Bagagem {#baggage-security-considerations} Itens sensíveis da Bagagem podem ser compartilhados com recursos não intencionais, como APIs de terceiros. Isso ocorre porque a instrumentação @@ -65,7 +63,7 @@ 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 +## Bagagem não é o mesmo que atributos {#baggage-is-not-the-same-as-attributes} É 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 @@ -76,10 +74,10 @@ 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. +[Atributos de Trecho](../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][]. +Para mais informações, consulte a [especificação da Bagagem]. [especificação da Bagagem]: /docs/specs/otel/overview/#baggage-signal diff --git a/content/pt/docs/concepts/signals/logs.md b/content/pt/docs/concepts/signals/logs.md index ada95cef2f3c..d554fce2ac68 100644 --- a/content/pt/docs/concepts/signals/logs.md +++ b/content/pt/docs/concepts/signals/logs.md @@ -2,7 +2,7 @@ title: Logs description: Um registro de um evento. weight: 3 -default_lang_commit: ebc9a3a9f07278110677f4f8f69291a02704746b +default_lang_commit: 7c0e4db0b6c39b0ca0e7efb17df5610d1b77b8a3 cSpell:ignore: filelogreceiver semistructured transformprocessor --- @@ -18,7 +18,7 @@ O OpenTelemetry não possui uma especificação de API ou SDK própria para gera logs. Em vez disso, os logs no OpenTelemetry são os logs que você já possui, que foram gerados por um framework de _logging_ ou componente de infraestrutura. Os SDKs e a autoinstrumentação do OpenTelemetry utilizam vários componentes para -correlacionar automaticamente logs com [rastros](/docs/concepts/signals/traces). +correlacionar automaticamente logs com [rastros](../traces). O suporte do OpenTelemetry para logs é projetado para ser totalmente compatível com o que você já possui, oferecendo a capacidade de adicionar contextos a esses @@ -27,7 +27,7 @@ comum, abrangendo diversas fontes. ### Logs do OpenTelemetry no OpenTelemetry Collector {#opentelemetry-logs-in-the-opentelemetry-collector} -O [OpenTelemetry Collector](/docs/collector) fornece várias ferramentas para +O [OpenTelemetry Collector](/docs/collector/) fornece várias ferramentas para trabalhar com logs: - Vários _receivers_ que analisam logs de fontes específicas e conhecidas de diff --git a/content/pt/docs/concepts/signals/metrics.md b/content/pt/docs/concepts/signals/metrics.md index 8236e4fe487f..cd25ec507f8f 100644 --- a/content/pt/docs/concepts/signals/metrics.md +++ b/content/pt/docs/concepts/signals/metrics.md @@ -2,7 +2,7 @@ title: Métricas weight: 2 description: Uma medição capturada em tempo de execução. -default_lang_commit: eb19d1dd5ab2f66343ec76adbfb31f81024da3a1 +default_lang_commit: 7c0e4db0b6c39b0ca0e7efb17df5610d1b77b8a3 --- 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: tenha acesso às mudanças contínuas, mas apenas ao valor agregado (ex., atual tamanho da fila). - **Gauge**: Mede o valor atual no momento da leitura. Um exemplo seria um - medidor de tanque de combustível de um veículo. Gauges são assíncronos. + medidor de tanque de combustível de um veículo. Gauges são síncronos. - **Asynchronous Gauge**: Assim como o **Gauge**, porém é coletado uma vez a cada exportação. Pode ser usado em casos onde você não tenha acesso às 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 _Views_. Por padrão, o projeto OpenTelemetry visa fornecer agregações que sejam suportadas por diferentes visualizadores e backends de telemetria. -Ao contrário dos [rastros](/docs/concepts/signals/traces/), que são destinados a -capturar os ciclos de vida das requisições e fornecer o contexto para as partes -individuais de uma requisição, as métricas são destinadas a fornecer informações -estatísticas em forma de dados agregados. Alguns exemplos de caso de uso para as -métricas incluem: +Ao contrário dos [rastros](../traces/), que são destinados a capturar os ciclos +de vida das requisições e fornecer o contexto para as partes individuais de uma +requisição, as métricas são destinadas a fornecer informações estatísticas em +forma de dados agregados. Alguns exemplos de caso de uso para as métricas +incluem: - Reportar o número total de _bytes_ lidos por um serviço, por tipo de protocolo. diff --git a/content/pt/docs/concepts/signals/traces.md b/content/pt/docs/concepts/signals/traces.md index f96ad916dd5e..f3dfa6f09de9 100644 --- a/content/pt/docs/concepts/signals/traces.md +++ b/content/pt/docs/concepts/signals/traces.md @@ -2,7 +2,7 @@ title: Rastros weight: 1 description: O caminho de uma solicitação através do seu aplicativo. -default_lang_commit: 57cd4f78d61cc1642ce56089aeec7ae278544194 +default_lang_commit: 7c0e4db0b6c39b0ca0e7efb17df5610d1b77b8a3 --- Os **rastros** nos fornecem uma visão geral do que acontece quando uma @@ -27,8 +27,8 @@ trecho `olá`: { "name": "olá", "context": { - "trace_id": "0x5b8aa5a2d2c872e8321cf37308d69df2", - "span_id": "0x051581bf3cb55c13" + "trace_id": "5b8aa5a2d2c872e8321cf37308d69df2", + "span_id": "051581bf3cb55c13" }, "parent_id": null, "start_time": "2022-04-29T18:52:58.114201Z", @@ -58,10 +58,10 @@ O trecho `olá-cumprimentos`: { "name": "olá-cumprimentos", "context": { - "trace_id": "0x5b8aa5a2d2c872e8321cf37308d69df2", + "trace_id": "5b8aa5a2d2c872e8321cf37308d69df2", "span_id": "0x5fb397be34d26b51" }, - "parent_id": "0x051581bf3cb55c13", + "parent_id": "051581bf3cb55c13", "start_time": "2022-04-29T18:52:58.114304Z", "end_time": "2022-04-29T22:52:58.114561Z", "attributes": { @@ -97,10 +97,10 @@ O trecho `olá-saudações`: { "name": "olá-saudações", "context": { - "trace_id": "0x5b8aa5a2d2c872e8321cf37308d69df2", - "span_id": "0x93564f51e1abe1c2" + "trace_id": "5b8aa5a2d2c872e8321cf37308d69df2", + "span_id": "5fb397be34d26b51" }, - "parent_id": "0x051581bf3cb55c13", + "parent_id": "051581bf3cb55c13", "start_time": "2022-04-29T18:52:58.114492Z", "end_time": "2022-04-29T18:52:58.114631Z", "attributes": { @@ -163,7 +163,7 @@ A propagação de contexto é o conceito central que possibilita o rastreamento distribuído. Com a propagação de contexto, trechos podem ser correlacionados entre si e montados em um rastro, independentemente de onde os trechos são gerados. Para saber mais sobre este tópico, consulte a página de conceitos sobre -[Propagação de Contexto](/docs/concepts/context-propagation). +[Propagação de Contexto](../../context-propagation). ## Trechos {#spans} @@ -234,8 +234,7 @@ O contexto do trecho é um objeto imutável em cada trecho que contém o seguint rastro específicos do fornecedor O contexto do trecho é a parte de um trecho que é serializada e propagada junto -com a [propagação de contexto](#context-propagation) e -[baggage](/docs/concepts/signals/baggage). +com a [Propagação de Contexto](#context-propagation) e [Baggage](../baggage). Como o contexto do trecho contém o trace ID, o trace ID é usado ao criar [links de trechos](#span-links). @@ -318,6 +317,9 @@ segundo rastro. Agora, eles estão causalmente associados entre si. Os links são opcionais, mas servem como uma boa maneira de associar trechos de rastro uns aos outros. +Para mais informações sobre Links de Trechos, consulte +[Link](/docs/specs/otel/trace/api/#link). + ### O estado do Trecho {#span-status} Cada trecho tem um estado. Os três valores possíveis são: From a312d0ef3cb3dfa071d539e4a5cc1914e85b6592 Mon Sep 17 00:00:00 2001 From: Vitor Vasconcellos Date: Mon, 3 Feb 2025 20:50:13 -0300 Subject: [PATCH 3/5] [pt] Update localized content on content/pt/docs/concepts/glossary.md (#6156) Co-authored-by: Marylia Gutierrez --- content/pt/docs/concepts/glossary.md | 195 +++++++++++++++------------ 1 file changed, 110 insertions(+), 85 deletions(-) diff --git a/content/pt/docs/concepts/glossary.md b/content/pt/docs/concepts/glossary.md index 9d10d82caa46..dbe526bacc6f 100644 --- a/content/pt/docs/concepts/glossary.md +++ b/content/pt/docs/concepts/glossary.md @@ -1,80 +1,82 @@ --- title: Glossário description: >- - Terminologias utilizadas pelo projeto OpenTelemetry que você pode ou não estar - familiarizado. + Definições e convenções para termos de telemetria conforme usados no + OpenTelemetry. weight: 200 -default_lang_commit: 926e23631291ed0ba85563cdaf344a134d0edd8d +default_lang_commit: f37118d8489a60d73dd881645f317d866b53b418 --- -O projeto OpenTelemetry usa terminologias que você talvez não conheça. Além -disso, o projeto também define algumas terminologias de uma maneira diferente de -outros lugares. Esta página reúne as terminologias utilizadas no projeto e seus -respectivos significados. +Esse glossário define termos e [conceitos](/docs/concepts/) que são novos no +projeto do OpenTelemetry e esclarece os usos de termos específicos do +OpenTelemetry, comuns no universo de observabilidade. -## Terminologia Genérica {#generic-terminology} +Também comentamos sobre ortografia e capitalização, quando útil. Por exemplo, +consulte [OpenTelemetry](#opentelemetry) e [OTel](#otel). -### **Agregação** {#aggregation} +## Termos {#terms} + +### Agregação {#aggregation} O processo de combinar múltiplas medições em estatísticas exatas ou estimadas sobre as medições que aconteceram durante um intervalo de tempo, durante a execução do programa. Utilizado pela [Fonte de Dados](#data-source) de uma [Métrica](#metric). -### **Amostragem** {#sampling} +### Amostragem {#sampling} Um mecanismo para controlar a quantidade de dados exportados. Usado mais comumente com a [Fonte de Dados](#data-source) de [Rastros](#trace). Consulte [mais informações][sampling]. -### **API** +### API Interface de Programação de Aplicações (_Application Programming Interface_). No projeto OpenTelemetry, é utilizada para definir como os dados de telemetria são gerados pela [Fonte de Dados](#data-source). -### **Aplicação** {#application} +### Aplicação {#application} Um ou mais [Serviços](#service) destinados a usuários finais ou outras aplicações. -### **Aplicação lado do cliente** {#client-side-app} +### Aplicação lado do cliente {#client-side-app} Um componente de uma [Aplicação](#application) que não está sendo executado dentro de uma infraestrutura privada e é normalmente usado diretamente por usuários finais. Exemplos de aplicações client-side incluem aplicativos de navegador, aplicativos móveis e aplicativos executados em dispositivos IoT. -### **APM** +### APM O Monitoramento de Desempenho de Aplicações (_Application Performance Monitoring_) envolve monitorar aplicações de software, sua performance (velocidade, confiabilidade, disponibilidade, etc.) para detectar problemas, alertar e fornecer ferramentas que permitam encontrar a causa raiz. -### **Atributo** {#attribute} +### Atributo {#attribute} Termo do OpenTelemetry para [Metadados](#metadata). Adiciona informações chave-valor à entidade que está produzindo telemetria. Usado em [Sinais](#signal) e [Recursos](#resource). Consulte a [especificação de atributos][attribute]. -### **Bagagem** {#baggage} +### Bagagem {#baggage} Um mecanismo para propagar [Metadados](#metadata) para ajudar a estabelecer uma relação casual entre eventos e serviços. Consulte as [especificações de Bagagem][baggage]. -### **Biblioteca** {#library} +### Biblioteca {#library} Uma coleção específica da linguagem com comportamento invocado por uma interface. -### **Biblioteca de cliente** {#client-library} +### Biblioteca de cliente {#client-library} Consulte a seção [Biblioteca instrumentada](#instrumented-library). -### **Biblioteca de instrumentação** {#instrumentation-library} +### Biblioteca de instrumentação {#instrumentation-library} Indica a [Biblioteca](#library) que fornece a instrumentação para uma determinada [Biblioteca instrumentada](#instrumented-library). A @@ -83,13 +85,13 @@ determinada [Biblioteca instrumentada](#instrumented-library). A [Biblioteca](#library) caso esta possua instrumentação OpenTelemetry incorporada. Consulte [a especificação da biblioteca][spec-instrumentation-lib]. -### **Biblioteca instrumentada** {#instrumented-library} +### Biblioteca instrumentada {#instrumented-library} Indica a [Biblioteca](#library) para a qual os sinais telemétricos ([Rastros](#trace), [Métricas](#metric), [Logs](#log)) são coletados. Consulte [mais informações][spec-instrumented-lib]. -### **Campo** {#field} +### Campo {#field} Um termo utilizado especificamente por [Registros de Log](#log-record). [Metadados](#metadata) podem ser adicionados por meio de campos definidos, @@ -97,53 +99,58 @@ incluindo [Atributos](#attribute) e [Recursos](#resource). Outros campos também podem ser considerados `Metadados`, incluindo severidade e informações de rastreamento. Consulte a [especificação de campos][field]. -### **Collector** +### Collector + +O [OpenTelemetry Collector], ou simplesmente Collector, é uma implementação +neutra em relação a fornecedores sobre como receber, processar e exportar dados +de telemetria. Um único binário que pode ser implementado como um agente ou +_gateway_. -Uma implementação neutra em relação a fornecedores sobre como receber, processar -e exportar dados de telemetria. Um único binário que pode ser implementado como -um agente ou gateway. +> **Ortografia**: Ao referir-se ao [OpenTelemetry Collector], sempre capitalize +> a palavra "Collector". Utilize apenas o termo "Collector" caso esteja +> utilizando Collector como um adjetivo — por exemplo, "Configuração do +> Collector". -Também conhecido como OpenTelemetry Collector. Mais detalhes sobre o Collector -podem ser encontrados [aqui][collector]. +[OpenTelemetry Collector]: /docs/collector/ -### **Contrib** +### Contrib Diversas [Bibliotecas Instrumentadas](#instrumentation-library) e o [Collector](#collector) oferecem um conjunto de funcionalidades principais, assim como um repositório contrib dedicado para funcionalidades não essenciais, incluindo `Exporters` de fornecedores. -### **Convenções semânticas** {#semantic-conventions} +### Convenções semânticas {#semantic-conventions} Define nomes e valores padrão de [Metadados](#metadata) para fornecer dados telemétricos neutros em relação a fornecedores. -### **DAG** +### DAG [Grafos acíclicos dirigidos][dag]. -### **Dimensão** {#dimension} +### Dimensão {#dimension} Termo utilizado especialmente por [Métricas](#metric). Consulte [Atributo](#attribute). -### **Distribuição** {#distribution} +### Distribuição {#distribution} Uma distribuição é um encapsulamento em torno de um repositório upstream do OpenTelemetry com algumas personalizações. Consulte [mais detalhes][distribution]. -### **Especificação** {#specification} +### Especificação {#specification} Descreve os requisitos e expectativas para implementações em todas as linguagens. Consulte [mais informações][specification]. -### **Evento** {#event} +### Evento {#event} Algo que aconteceu cuja representação depende da [Fonte de dados](#data-source). Por exemplo, [Trecho](#span). -### **Exporter** +### Exporter Fornece funcionalidades para emitir dados telemétricos aos consumidores. Exporters podem ser push-based ou pull-based. @@ -152,30 +159,30 @@ Exporters podem ser push-based ou pull-based. Veja [Sinal](#signal) -### **gRPC** +### gRPC Um framework [RPC](#rpc) de alta performance e open source. Mais sobre gRPC [aqui](https://grpc.io). -### **HTTP** +### HTTP Abreviação para [Hypertext Transfer Protocol][http]. -### **Instrumentação automática** {#automatic-instrumentation} +### Instrumentação automática {#automatic-instrumentation} Refere-se a métodos de coleta de telemetria que não exigem que o usuário final modifique o código-fonte da aplicação. Os métodos variam conforme a linguagem de programação e os exemplos incluem injeção de _bytecode_ ou _monkey patching_. -### **JSON** +### JSON Abreviação para [JavaScript Object Notation][json]. -### **Linguagem** +### Linguagem Linguagem de programação. -### **Log** +### Log Às vezes usado para se referir a uma coleção de [Registros de Log](#log-record). Pode ser ambíguo, uma vez que as pessoas também costumam usar [Log](#log) para @@ -183,7 +190,7 @@ se referir a um único [Registro de Log](#log-record). Quando a ambiguidade é possível, utilize qualificadores adicionais, por exemplo, `Registro de Log`. Consulte [mais informações][log]. -### **Metadados** {#metadata} +### Metadados {#metadata} Um par de chave-valor, por exemplo, `foo="bar"`, adicionado a uma entidade que produz dados telemétricos. O OpenTelemetry chama esses pares de @@ -191,39 +198,51 @@ produz dados telemétricos. O OpenTelemetry chama esses pares de [Dimensões](#dimension) e [Rótulos](#label), enquanto os [Logs](#log) têm [Campos](#field). -### **Métrica** {#metric} +### Métrica {#metric} Registra um ponto de dados, seja medições brutas ou agregações pré-definidas, como séries temporais com [Metadados](#metadata). Consulte [mais informações][metric]. -### **OC** +### OC Abreviação para [OpenCensus](#opencensus). ### OpAMP -[Conteúdo será adicionado posteriormente] +Abreviação para o +[Protocolo de Gerenciamento de Agentes Abertos _(Open Agent Management Protocol)_](/docs/collector/management/#opamp). -### **OpenCensus** +> **Ortografia**: Escreva OpAMP, e não `OPAMP` ou `opamp` em descrições ou +> instruções. -Um conjunto de bibliotecas para várias linguagens que permite coletar métricas -de aplicações e rastreamentos distribuídos, transferindo os dados para um -backend de sua preferência em tempo real. -[Precursor do OpenTelemetry](/docs/what-is-opentelemetry/#history). Consulte -[mais informações][opencensus]. +### OpenCensus + +Precursor do OpenTelemetry. Para mais detalhes, consulte +[História](/docs/what-is-opentelemetry/#history). ### OpenTelemetry -[Conteúdo será adicionado posteriormente] +Formado por meio de uma [fusão] dos projetos [OpenTracing](#opentracing) e +[OpenCensus](#opencensus), o OpenTelemetry — o tema deste site — é +uma coleção de [APIs](#api), [SDKs](#sdk) e ferramentas que você pode utilizar +para [instrumentar](/docs/concepts/instrumentation/), gerar, +[coletar](/docs/concepts/components/#collector) e +[exportar](/docs/concepts/components/#exporters) +[dados de telemetria](/docs/concepts/signals/), como [métricas](#metric), +[logs](#log) e [rastros](#trace). + +> **Ortografia**: OpenTelemetry deve ser sempre uma única palavra, sem hífen, e +> capitalizada como mostrado. -### **OpenTracing** +[fusão]: /docs/what-is-opentelemetry/#history -APIs e instrumentações neutras em relação a fornecedores de rastreamento -distribuído. [Precursor do OpenTelemetry](/docs/what-is-opentelemetry/#history). -Consulte [mais informações][opentracing]. +### OpenTracing -### **OT** +Precursor do OpenTelemetry. Para mais detalhes, consulte +[História](/docs/what-is-opentelemetry/#history). + +### OT Abreviação para [OpenTracing](#opentracing). @@ -231,47 +250,56 @@ Abreviação para [OpenTracing](#opentracing). Abreviação para [OpenTelemetry](/docs/what-is-opentelemetry/). -### **OTelCol** +> **Ortografia**: Escreva OTel, e não `OTEL`. + +### OTelCol Abreviação para [OpenTelemetry Collector](#collector). ### OTEP -[Conteúdo será adicionado posteriormente] +Um acrônimo para [Proposta de Melhoria do OpenTelemetry _(OpenTelemetry +Enhancement Proposal)_]. + +> **Spelling**: Escreva "OTEPs" como um plural. Não escreva `OTep` ou `otep` em +> descrições. + +[Proposta de Melhoria do OpenTelemetry _(OpenTelemetry Enhancement Proposal)_]: + https://github.com/open-telemetry/opentelemetry-specification/blob/main/oteps/README.md -### **OTLP** +### OTLP Abreviação para [OpenTelemetry Protocol](/docs/specs/otlp/). -### **Propagação de Contexto** {#context-propagation} +### Propagação de Contexto {#context-propagation} Permite que todas as [Fontes de dados](#data-source) compartilhem um mecanismo subjacente de contexto para armazenar um estado e acessar dados ao longo do ciclo de vida de uma [Transação](#transaction). Consulte a [especificação de propagação de contexto][context propagation]. -### **Propagators** +### Propagators Usado para serializar e desserializar partes específicas de dados telemétricos, como contexto de span e [bagagem](#baggage) em [Spans](#span). Consulte [mais informações][propagators]. -### **Proto** +### Proto Tipos de interface independentes de linguagem. Consulte [mais informações][proto]. -### **Rastreador** {#tracer} +### Rastreador {#tracer} Responsável pela criação de [Trecho](#span). Consulte [mais informações][tracer]. -### **Rastro** {#trace} +### Rastro {#trace} Um [DAG](#dag) de [Trechos](#span), onde os limites entre os [Trechos](#span) são definidos como uma relação de pai-filho. Consulte [mais informações][trace]. -### **Rastro distribuído** {#distributed-tracing} +### Rastro distribuído {#distributed-tracing} Acompanha a progressão de uma única [Requisição](#request), chamada de [Rastro](#trace), conforme é processada pelos [Serviços](#service) que compõem @@ -280,13 +308,13 @@ atravessa limites de processo, rede e segurança. Consulte [Rastreamento distribuído][distributed tracing]. -### **Receiver** +### Receiver Termo utilizado pelo [Collector](/docs/collector/configuration/#receivers) para definir como os dados telemétricos são recebidos. Receivers podem ser push-based ou pull-based. Consulte [mais informações][receiver]. -### **Recurso** {#resource} +### Recurso {#resource} Captura informações sobre a entidade que produz dados telemétricos como [Atributos](#attribute). Por exemplo, um processo que gera telemetria e está @@ -294,72 +322,72 @@ sendo executado em um contêiner no Kubernetes possui um nome de processo, um nome de pod, um namespace e, possivelmente, um nome de deployment. Todos esses atributos podem ser incluídos no `Recurso`. -### **Registro de log** {#log-record} +### Registro de log {#log-record} Uma gravação de um [Evento](#event). Normalmente, o registro inclui um carimbo de data/hora indicando quando o [Evento](#event) ocorreu, além de outros dados que descrevem o que aconteceu, onde aconteceu, e assim por diante. Consulte [mais informações][log record]. -### **REST** +### REST Abreviação para [Representational State Transfer][rest]. -### **Requisição** {#request} +### Requisição {#request} Veja [Rastro distribuído](#distributed-tracing). -### **Rótulo** {#label} +### Rótulo {#label} Um termo utilizado especificamente por [Métricas](#metric). Veja [Metadados](#metadata). -### **RPC** +### RPC Abreviação para [Remote Procedure Call][rpc]. -### **SDK** +### SDK Abreviação para Software Development Kit. Refere-se a um SDK de telemetria que indica uma [Biblioteca](#library) que implementa a [API](#api) do OpenTelemetry. -### **Serviço** {#service} +### Serviço {#service} Um componente de uma [Aplicação](#application). Múltiplas instâncias de um [Serviço](#service) são tipicamente implantadas para que tenham alta disponibilidade e escalabilidade. Um [Serviço](#service) pode ser implantado em múltiplas localizações. -### **Sinal** {#signal} +### Sinal {#signal} Um dos [Rastros](#trace), [Métricas](#metric) ou [Logs](#log). Mais sobre Sinais [aqui][signals]. -### **Span link** +### Span link Um span link é uma conexão entre spans relacionados casualmente. Para detalhes, consulte [Links entre spans](/docs/specs/otel/overview#links-between-spans) e [Especificando Links](/docs/specs/otel/trace/api#specifying-links). -### **Status** +### Status O resultado de uma operação. Normalmente usado para indicar se ocorreu um erro. Consulte [mais informações][status]. -### **Tag** +### Tag Consulte [Metadados](#metadata). -### **Transação** {#transaction} +### Transação {#transaction} Consulte [Rastro distribuído](#distributed-tracing). -### **Trecho** {#span} +### Trecho {#span} Representa uma única operação dentro de um [Rastro](#trace). Consulte mais detalhes [aqui][span]. -### **zPages** +### zPages Uma alternativa interna aos exportadores externos. Quando incluídos, eles coletam e agregam informações de rastros e métricas em segundo plano; estes @@ -368,7 +396,6 @@ informações][zpages]. [baggage]: /docs/specs/otel/baggage/api/ [attribute]: /docs/specs/otel/common/#attributes -[collector]: /docs/collector [context propagation]: /docs/specs/otel/overview#context-propagation [dag]: https://en.wikipedia.org/wiki/Directed_acyclic_graph [distributed tracing]: /docs/concepts/signals/traces/ @@ -379,8 +406,6 @@ informações][zpages]. [log]: /docs/specs/otel/glossary#log [log record]: /docs/specs/otel/glossary#log-record [metric]: /docs/concepts/signals/metrics/ -[opencensus]: https://opencensus.io -[opentracing]: https://opentracing.io [propagators]: /docs/languages/go/instrumentation/#propagators-and-context [proto]: https://github.com/open-telemetry/opentelemetry-proto [receiver]: /docs/collector/configuration/#receivers From 4575bd5942b09eb2da66bace9a5e267524340490 Mon Sep 17 00:00:00 2001 From: OpenTelemetry Bot <107717825+opentelemetrybot@users.noreply.github.com> Date: Mon, 3 Feb 2025 20:59:34 -0800 Subject: [PATCH 4/5] Auto-update registry versions (85fb02749cc9e52b206dd68b288d7c1a2a9dfb13) (#6192) --- data/registry/collector-builder.yml | 2 +- data/registry/collector-confmap-provider-envprovider.yml | 2 +- data/registry/collector-confmap-provider-fileprovider.yml | 2 +- data/registry/collector-confmap-provider-httpprovider.yml | 2 +- data/registry/collector-confmap-provider-httpsprovider.yml | 2 +- data/registry/collector-confmap-provider-yamlprovider.yml | 2 +- data/registry/collector-exporter-debug.yml | 2 +- data/registry/collector-exporter-nop.yml | 2 +- data/registry/collector-exporter-otlp.yml | 2 +- data/registry/collector-extension-memorylimiter.yml | 2 +- data/registry/collector-processor-batch.yml | 2 +- data/registry/collector-receiver-nop.yml | 2 +- data/registry/collector-receiver-otlp.yml | 2 +- data/registry/exporter-dotnet-geneva.yml | 2 +- 14 files changed, 14 insertions(+), 14 deletions(-) diff --git a/data/registry/collector-builder.yml b/data/registry/collector-builder.yml index a7307f05af6c..3520a4c99822 100644 --- a/data/registry/collector-builder.yml +++ b/data/registry/collector-builder.yml @@ -17,5 +17,5 @@ createdAt: 2023-12-18 package: registry: go name: go.opentelemetry.io/collector/cmd/builder - version: v0.118.0 + version: v0.119.0 quickInstall: false diff --git a/data/registry/collector-confmap-provider-envprovider.yml b/data/registry/collector-confmap-provider-envprovider.yml index 5264a1116365..339a73308957 100644 --- a/data/registry/collector-confmap-provider-envprovider.yml +++ b/data/registry/collector-confmap-provider-envprovider.yml @@ -19,4 +19,4 @@ createdAt: 2024-11-20 package: registry: go-collector name: go.opentelemetry.io/collector/confmap/provider/envprovider - version: v1.24.0 + version: v1.25.0 diff --git a/data/registry/collector-confmap-provider-fileprovider.yml b/data/registry/collector-confmap-provider-fileprovider.yml index d65d84b46dfc..ab5aa2935ac7 100644 --- a/data/registry/collector-confmap-provider-fileprovider.yml +++ b/data/registry/collector-confmap-provider-fileprovider.yml @@ -18,4 +18,4 @@ createdAt: 2024-11-20 package: registry: go-collector name: go.opentelemetry.io/collector/confmap/provider/fileprovider - version: v1.24.0 + version: v1.25.0 diff --git a/data/registry/collector-confmap-provider-httpprovider.yml b/data/registry/collector-confmap-provider-httpprovider.yml index d4a3773d2536..bb9ff1e11b7c 100644 --- a/data/registry/collector-confmap-provider-httpprovider.yml +++ b/data/registry/collector-confmap-provider-httpprovider.yml @@ -18,4 +18,4 @@ createdAt: 2024-11-20 package: registry: go-collector name: go.opentelemetry.io/collector/confmap/provider/httpprovider - version: v1.24.0 + version: v1.25.0 diff --git a/data/registry/collector-confmap-provider-httpsprovider.yml b/data/registry/collector-confmap-provider-httpsprovider.yml index a958156ddd58..86f2cf62cf62 100644 --- a/data/registry/collector-confmap-provider-httpsprovider.yml +++ b/data/registry/collector-confmap-provider-httpsprovider.yml @@ -18,4 +18,4 @@ createdAt: 2024-11-20 package: registry: go-collector name: go.opentelemetry.io/collector/confmap/provider/httpsprovider - version: v1.24.0 + version: v1.25.0 diff --git a/data/registry/collector-confmap-provider-yamlprovider.yml b/data/registry/collector-confmap-provider-yamlprovider.yml index f5a11112d7e8..123a6c08edd6 100644 --- a/data/registry/collector-confmap-provider-yamlprovider.yml +++ b/data/registry/collector-confmap-provider-yamlprovider.yml @@ -18,4 +18,4 @@ createdAt: 2024-11-20 package: registry: go-collector name: go.opentelemetry.io/collector/confmap/provider/yamlprovider - version: v1.24.0 + version: v1.25.0 diff --git a/data/registry/collector-exporter-debug.yml b/data/registry/collector-exporter-debug.yml index 7551668b1015..8fbc87c0408b 100644 --- a/data/registry/collector-exporter-debug.yml +++ b/data/registry/collector-exporter-debug.yml @@ -16,4 +16,4 @@ createdAt: 2020-11-05 package: registry: go-collector name: go.opentelemetry.io/collector/exporter/debugexporter - version: v0.118.0 + version: v0.119.0 diff --git a/data/registry/collector-exporter-nop.yml b/data/registry/collector-exporter-nop.yml index 5dc6f3045ccd..e363167286e3 100644 --- a/data/registry/collector-exporter-nop.yml +++ b/data/registry/collector-exporter-nop.yml @@ -19,4 +19,4 @@ createdAt: 2024-04-18 package: registry: go-collector name: go.opentelemetry.io/collector/exporter/nopexporter - version: v0.118.0 + version: v0.119.0 diff --git a/data/registry/collector-exporter-otlp.yml b/data/registry/collector-exporter-otlp.yml index 665542e390c2..18b3e4174618 100644 --- a/data/registry/collector-exporter-otlp.yml +++ b/data/registry/collector-exporter-otlp.yml @@ -16,4 +16,4 @@ createdAt: 2020-11-05 package: registry: go-collector name: go.opentelemetry.io/collector/exporter/otlpexporter - version: v0.118.0 + version: v0.119.0 diff --git a/data/registry/collector-extension-memorylimiter.yml b/data/registry/collector-extension-memorylimiter.yml index 69f45f189e7a..3ac1ed0f5224 100644 --- a/data/registry/collector-extension-memorylimiter.yml +++ b/data/registry/collector-extension-memorylimiter.yml @@ -18,4 +18,4 @@ createdAt: 2024-04-18 package: registry: go-collector name: go.opentelemetry.io/collector/extension/memorylimiterextension - version: v0.118.0 + version: v0.119.0 diff --git a/data/registry/collector-processor-batch.yml b/data/registry/collector-processor-batch.yml index c29fd0b81e59..15f591ab31ba 100644 --- a/data/registry/collector-processor-batch.yml +++ b/data/registry/collector-processor-batch.yml @@ -18,4 +18,4 @@ createdAt: 2021-02-24 package: registry: go-collector name: go.opentelemetry.io/collector/processor/batchprocessor - version: v0.118.0 + version: v0.119.0 diff --git a/data/registry/collector-receiver-nop.yml b/data/registry/collector-receiver-nop.yml index 3e78977c064e..b9d6141d774c 100644 --- a/data/registry/collector-receiver-nop.yml +++ b/data/registry/collector-receiver-nop.yml @@ -18,4 +18,4 @@ createdAt: 2024-04-18 package: registry: go-collector name: go.opentelemetry.io/collector/receiver/nopreceiver - version: v0.118.0 + version: v0.119.0 diff --git a/data/registry/collector-receiver-otlp.yml b/data/registry/collector-receiver-otlp.yml index 06c2b3177ec6..613d405f66f0 100644 --- a/data/registry/collector-receiver-otlp.yml +++ b/data/registry/collector-receiver-otlp.yml @@ -16,4 +16,4 @@ createdAt: 2020-11-05 package: registry: go-collector name: go.opentelemetry.io/collector/receiver/otlpreceiver - version: v0.118.0 + version: v0.119.0 diff --git a/data/registry/exporter-dotnet-geneva.yml b/data/registry/exporter-dotnet-geneva.yml index 0251c315f930..865fdae40035 100644 --- a/data/registry/exporter-dotnet-geneva.yml +++ b/data/registry/exporter-dotnet-geneva.yml @@ -17,4 +17,4 @@ createdAt: 2022-11-07 package: registry: nuget name: OpenTelemetry.Exporter.Geneva - version: 1.10.0 + version: 1.11.0 From 57676e2e4b59b78e05d10ff186b2a76fc94b83d9 Mon Sep 17 00:00:00 2001 From: Guspan Tanadi <36249910+guspan-tanadi@users.noreply.github.com> Date: Tue, 4 Feb 2025 19:29:51 +0700 Subject: [PATCH 5/5] docs(languages/java/intro): current section links BOM (#6180) Co-authored-by: opentelemetrybot <107717825+opentelemetrybot@users.noreply.github.com> --- content/en/docs/languages/java/intro.md | 2 +- static/refcache.json | 4 ++++ 2 files changed, 5 insertions(+), 1 deletion(-) diff --git a/content/en/docs/languages/java/intro.md b/content/en/docs/languages/java/intro.md index b1d4beee2a02..b13717564c1f 100644 --- a/content/en/docs/languages/java/intro.md +++ b/content/en/docs/languages/java/intro.md @@ -106,7 +106,7 @@ dependency structure: ## Dependencies and BOMs A -[bill of materials](https://maven.apache.org/guides/introduction/introduction-to-dependency-mechanism.html#bill-of-materials-bom-poms), +[bill of materials](https://maven.apache.org/guides/introduction/introduction-to-dependency-mechanism.html#Bill_of_Materials_.28BOM.29_POMs), or BOM for short, is an artifact that helps keep the versions of related dependencies aligned. OpenTelemetry Java publishes several BOMs catering to different use cases, listed below in order of increasing scope. We highly diff --git a/static/refcache.json b/static/refcache.json index d36acd82e08d..d9637fbc6341 100644 --- a/static/refcache.json +++ b/static/refcache.json @@ -13407,6 +13407,10 @@ "StatusCode": 200, "LastSeen": "2025-02-01T06:58:09.358-05:00" }, + "https://maven.apache.org/guides/introduction/introduction-to-dependency-mechanism.html#Bill_of_Materials_.28BOM.29_POMs": { + "StatusCode": 206, + "LastSeen": "2025-02-04T01:52:41.254397285Z" + }, "https://maven.apache.org/guides/introduction/introduction-to-dependency-mechanism.html#bill-of-materials-bom-poms": { "StatusCode": 206, "LastSeen": "2025-01-30T16:59:49.463144-05:00"