From 2bc1eec817e2bccb50d400d535416fcd3ec42d57 Mon Sep 17 00:00:00 2001 From: Vinaum8 Date: Sat, 25 Jan 2025 15:15:45 -0300 Subject: [PATCH 001/129] first day of traduction. --- .../pt/docs/languages/java/instrumentation.md | 219 ++++++++++++++++++ 1 file changed, 219 insertions(+) create mode 100644 content/pt/docs/languages/java/instrumentation.md diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md new file mode 100644 index 000000000000..13dcd34ae9ba --- /dev/null +++ b/content/pt/docs/languages/java/instrumentation.md @@ -0,0 +1,219 @@ +--- +title: Ecossistema de Instrumentação +aliases: + - /docs/java/getting_started + - /docs/java/manual_instrumentation + - manual + - manual_instrumentation + - libraries +weight: 10 +description: Ecossistema de Instrumentação no OpenTelemetry Java +cSpell:ignore: Logback logback +--- + + + +A instrumentação registra a telemetria usando a [API](../api/). O [SDK](../sdk/) +é a implementação de referência embutida na API, e é +[configurada](../configuration/) para processar e exportar a telemetrira produzia pelas chamadas de instrumentação da API. Esta página discute o ecossistema de instrumentação no OpenTelemetry Java, incluíndo recursos para usuários finais e tópicos relacionados com instrumentação: + +- [Categorias de instrumentação](#instrumentation-categories): Existem diversas categorias de instrumentação para cada tipo de caso de uso e para cada padrão de instalação. +- [Propagação de Contexto](#context-propagation): Propagação de Contexto provê uma correlação entre traces, metrics, e logs, permitindo que os sinais complementem cada um deles. +- [Convensão semântica](#semantic-conventions): A Convensão semântica define como produzir telemetria para operações padronizadas. +- [Log instrumentation](#log-instrumentation): A Convensão semântica define como produzir telemetria para operações padronizadas. + +{{% alert %}} Enquanto [Categorias de instrumentação](#instrumentation-categories) +mostram diversas opções para instrumentar uma aplicação, nós recomendamos que os usuários iniciem com a página [Agente Java](#zero-code-java-agent). O agente do Java possui uma instalação simples, e automaticamente instala e detecta a instrumentação para uma grande variedade de bibliotecas. {{% /alert %}} + +## Categorias de instrumentação + +Existem diversas categorias de instrumentação: + +- [Zero-code: Agente Java](#zero-code-java-agent) é uma forma de instrumentação sem código **[1]** que manipula dinamicamente o bytecode da aplicação. +- [Zero-code: Spring Boot starter](#zero-code-spring-boot-starter) é uma forma de instrumentação sem código **[1]** que utiliza a autoconfiguração do spring para instalar [biblioteca de instrumentação](#library-instrumentation). +- [Biblioteca de instrumentação](#library-instrumentation) envolve ou utiliza pontos de extensão para instrumentar uma biblioteca, exigindo que os usuários instalem e/ou adaptem o uso da biblioteca. +- [Instrumentação nativa](#native-instrumentation) is built directly into libraries and frameworks. +- [Manual instrumentation](#manual-instrumentation) is written by application authors, and typically specific to the application domain. +- [Shims](#shims) bridge data from one observability library to another, + typically _from_ some library into OpenTelemetry. + +**[1]**: instrumentação sem código is installed automatically based on detected +libraries / frameworks. + +The +[opentelemetry-java-instrumentation](https://github.com/open-telemetry/opentelemetry-java-instrumentation) +project contains the source code for Agente Java, Spring Boot starter, and +Biblioteca de instrumentação. + +### Zero-code: Agente Java + +O agente do Java is a form of zero-code +[automatic instrumentation](/docs/specs/otel/glossary/#automatic-instrumentation) +that dynamically manipulates application bytecode. + +For a list of libraries instrumented by O agente do Java, see the +"Auto-instrumented versions" column on +[supported libraries](https://github.com/open-telemetry/opentelemetry-java-instrumentation/blob/main/docs/supported-libraries.md). + +See [Agente Java](/docs/zero-code/java/agent/) for more details. + +### Zero-code: Spring Boot starter + +The Spring Boot starter is a form of zero-code +[automatic instrumentation](/docs/specs/otel/glossary/#automatic-instrumentation) +that leverages spring autoconfigure to install +[biblioteca de instrumentação](#library-instrumentation). + +See [Spring Boot starter](/docs/zero-code/java/spring-boot-starter/) for +details. + +### Biblioteca de instrumentação + +[Biblioteca de instrumentação](/docs/specs/otel/glossary/#instrumentation-library) +wraps or uses extension points to instrument a library, requiring users to +install and/or adapt library usage. + +For a list of instrumentation libraries, see the "Standalone Library +Instrumentation" column on +[supported libraries](https://github.com/open-telemetry/opentelemetry-java-instrumentation/blob/main/docs/supported-libraries.md). + +### Instrumentação nativa + +[Instrumentação nativa](/docs/specs/otel/glossary/#natively-instrumented) is +built directly into libraries or frameworks. OpenTelemetry encourages library +authors to add instrumentação nativa using the [API](../api/). In the long +term, we hope the instrumentação nativa becomes the norm, and view the +instrumentation maintained by OpenTelemetry in +[opentelemetry-java-instrumentation](https://github.com/open-telemetry/opentelemetry-java-instrumentation) +as a temporary means of filling the gap. + +{{% docs/languages/native-libraries "java" %}} + +### Manual instrumentation + +[Manual instrumentation](/docs/specs/otel/glossary/#manual-instrumentation) is +written by application authors, and typically specific to the application +domain. + +### Shims + +A shim is instrumentation that bridges data from one observability library to +another, typically _from_ some library into OpenTelemetry. + +Shims maintained in the OpenTelemetry Java ecosystem: + +| Description | Documentation | Signal(s) | Artifact | +| ------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------- | ------------------------------------------------------------------------------------------------------------------------------- | +| Bridge [OpenTracing](https://opentracing.io/) into OpenTelemetry | [README](https://github.com/open-telemetry/opentelemetry-java/tree/main/opentracing-shim) | Traces | `io.opentelemetry:opentelemetry-opentracing-shim:{{% param vers.otel %}}` | +| Bridge [Opencensus](https://opencensus.io/) into OpenTelemetry | [README](https://github.com/open-telemetry/opentelemetry-java/tree/main/opencensus-shim) | Traces, Metrics | `io.opentelemetry:opentelemetry-opencensus-shim:{{% param vers.otel %}}-alpha` | +| Bridge [Micrometer](https://micrometer.io/) into OpenTelemetry | [README](https://github.com/open-telemetry/opentelemetry-java-instrumentation/tree/main/instrumentation/micrometer/micrometer-1.5/library) | Metrics | `io.opentelemetry.instrumentation:opentelemetry-micrometer-1.5:{{% param vers.instrumentation %}}-alpha` | +| Bridge [JMX](https://docs.oracle.com/javase/7/docs/technotes/guides/management/agent.html) into OpenTelemetry | [README](https://github.com/open-telemetry/opentelemetry-java-instrumentation/blob/main/instrumentation/jmx-metrics/javaagent/README.md) | Metrics | `io.opentelemetry.instrumentation:opentelemetry-jmx-metrics:{{% param vers.instrumentation %}}-alpha` | +| Bridge OpenTelemetry into [Prometheus Java client](https://github.com/prometheus/client_java) | [README](https://github.com/open-telemetry/opentelemetry-java-contrib/tree/main/prometheus-client-bridge) | Metrics | `io.opentelemetry.contrib:opentelemetry-prometheus-client-bridge:{{% param vers.contrib %}}-alpha` | +| Bridge OpenTelemetry into [Micrometer](https://micrometer.io/) | [README](https://github.com/open-telemetry/opentelemetry-java-contrib/tree/main/micrometer-meter-provider) | Metrics | `io.opentelemetry.contrib:opentelemetry-micrometer-meter-provider:{{% param vers.contrib %}}-alpha` | +| Bridge [Log4j](https://logging.apache.org/log4j/2.x/index.html) into OpenTelemetry | [README](https://github.com/open-telemetry/opentelemetry-java-instrumentation/tree/main/instrumentation/log4j/log4j-appender-2.17/library) | Logs | `io.opentelemetry.instrumentation:opentelemetry-log4j-appender-2.17:{{% param vers.instrumentation %}}-alpha` | +| Bridge [Logback](https://logback.qos.ch/) into OpenTelemetry | [README](https://github.com/open-telemetry/opentelemetry-java-instrumentation/tree/main/instrumentation/logback/logback-appender-1.0/library) | Logs | `io.opentelemetry.instrumentation:opentelemetry-logback-appender-1.0:{{% param vers.instrumentation %}}-alpha` | +| Bridge OpenTelemetry context into [Log4j](https://logging.apache.org/log4j/2.x/index.html) | [README](https://github.com/open-telemetry/opentelemetry-java-instrumentation/tree/main/instrumentation/log4j/log4j-context-data/log4j-context-data-2.17/library-autoconfigure) | Context | `io.opentelemetry.instrumentation:opentelemetry-log4j-context-data-2.17-autoconfigure:{{% param vers.instrumentation %}}-alpha` | +| Bridge OpenTelemetry context into [Logback](https://logback.qos.ch/) | [README](https://github.com/open-telemetry/opentelemetry-java-instrumentation/tree/main/instrumentation/logback/logback-mdc-1.0/library) | Context | `io.opentelemetry.instrumentation:opentelemetry-logback-mdc-1.0:{{% param vers.instrumentation %}}-alpha` | + +## Propagação de Contexto + +The OpenTelemetry APIs are designed to be complementary, with the whole greater +than the sum of the parts. Each signal has its own strengths, and collectively +stitch together a compelling observability story. + +Importantly, the data from the various signals are linked together through trace +context: + +- Spans are related to other spans through span parent and links, which each + record trace context of related spans. +- Metrics are related to spans through + [exemplars](/docs/specs/otel/metrics/data-model/#exemplars), which record + trace context of a particular measurement. +- Logs are related to spans by recording trace context on log records. + +For this correlation to work, trace context must be propagated throughout an +application (across function calls and threads), and across application +boundaries. The [context API](../api/#context-api) facilitates this. +Instrumentation needs to be written in a manner which is context aware: + +- Libraries that represent the entry point to an application (i.e. HTTP servers, + message consumers, etc.) should [extract context](../api/#contextpropagators) + from incoming messages. +- Libraries that represent an exit point from an application (i.e. HTTP clients, + message producers, etc.) should [inject context](../api/#contextpropagators) + into outgoing messages. +- Libraries should implicitly or explicitly pass [Context](../api/#context) + through the callstack and across any threads. + +## Convensão semântica + +The [Convensão semântica](/docs/specs/semconv/) define how to produce telemetry +for standard operations. Among other things, A Convensão semântica specify +span names, span kinds, metric instruments, metric units, metric types, and +attribute key, value, and requirement levels. + +When writing instrumentation, consult A Convensão semântica and conform to +any which are applicable to the domain. + +OpenTelemetry Java [publishes artifacts](../api/#semantic-attributes) to assist +in conforming to A Convensão semântica, including generated constants for +attribute keys and values. + +TODO: discuss instrumentation API and how it helps conform to semantic +conventions + +## Log instrumentation + +While the [LoggerProvider](../api/#loggerprovider) / [Logger](../api/#logger) +APIs are structurally similar to the equivalent [trace](../api/#tracerprovider) +and [metric](../api/#meterprovider) APIs, they serve a different use case. As of +now, `LoggerProvider` / `Logger` and associated classes represent the +[Log Bridge API](/docs/specs/otel/logs/api/), which exists to write log +appenders to bridge logs recorded through other log APIs / frameworks into +OpenTelemetry. They are not intended for end user use as a replacement for Log4j +/ SLF4J / Logback / etc. + +There are two typical workflows for consuming log instrumentation in +OpenTelemetry catering to different application requirements: + +### Direct to collector + +In the direct to collector workflow, logs are emitted directly from an +application to a collector using a network protocol (e.g. OTLP). This workflow +is simple to set up as it doesn't require any additional log forwarding +components, and allows an application to easily emit structured logs that +conform to the [log data model](/docs/specs/otel/logs/data-model/). However, the +overhead required for applications to queue and export logs to a network +location may not be suitable for all applications. + +To use this workflow: + +- Install appropriate log appender. **[1]** +- Configure the OpenTelemetry [Log SDK](../sdk/#sdkloggerprovider) to export log + records to desired target destination (the + [collector](https://github.com/open-telemetry/opentelemetry-collector) or + other). + +**[1]**: Log appenders are a type of [shim](#shims) which bridges logs from a +log framework into the OpenTelemetry log SDK. See "Bridge Log4j into +OpenTelemetry", "Bridge Logback into OpenTelemetry" entries. See +[Log Appender example](https://github.com/open-telemetry/opentelemetry-java-docs/tree/main/log-appender) +for demonstration of a variety of scenarios. + +### Via file or stdout + +In the file or stdout workflow, logs are written to files or standout output. +Another component (e.g. FluentBit) is responsible for reading / tailing the +logs, parsing them to more structured format, and forwarding them a target, such +as the collector. This workflow may be preferable in situations where +application requirements do not permit additional overhead from +[direct to collector](#direct-to-collector). However, it requires that all log +fields required down stream are encoded into the logs, and that the component +reading the logs parse the data into the +[log data model](/docs/specs/otel/logs/data-model). The installation and +configuration of log forwarding components is outside the scope of this +document. + +Log correlation with traces is available by installing a [shim](#shims) to +bridge OpenTelemetry context into the log framework. See "Bridge OpenTelemetry +context into Log4j", "Bridge OpenTelemetry context into Logback" entries. From ae139aae07a485b4539e7b8ec8face6fee089fc9 Mon Sep 17 00:00:00 2001 From: Vinaum8 Date: Sat, 25 Jan 2025 18:55:15 -0300 Subject: [PATCH 002/129] first day of traduction. --- .../pt/docs/languages/java/instrumentation.md | 237 +++++++----------- 1 file changed, 89 insertions(+), 148 deletions(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index 13dcd34ae9ba..b244d7dd880c 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -13,17 +13,15 @@ cSpell:ignore: Logback logback -A instrumentação registra a telemetria usando a [API](../api/). O [SDK](../sdk/) -é a implementação de referência embutida na API, e é -[configurada](../configuration/) para processar e exportar a telemetrira produzia pelas chamadas de instrumentação da API. Esta página discute o ecossistema de instrumentação no OpenTelemetry Java, incluíndo recursos para usuários finais e tópicos relacionados com instrumentação: +A instrumentação registra a telemetria usando a [API](../api/). O [SDK](../sdk/) é a implementação de referência embutida na API, e é +[configurada](../configuration/) para processar e exportar a telemetrira produzida pelas chamadas de instrumentação da API. Esta página discute o ecossistema de instrumentação no OpenTelemetry Java, incluíndo recursos para usuários finais e tópicos relacionados com instrumentação: - [Categorias de instrumentação](#instrumentation-categories): Existem diversas categorias de instrumentação para cada tipo de caso de uso e para cada padrão de instalação. -- [Propagação de Contexto](#context-propagation): Propagação de Contexto provê uma correlação entre traces, metrics, e logs, permitindo que os sinais complementem cada um deles. +- [Propagação de Contexto](#context-propagation): Propagação de Contexto provê uma correlação entre rastros, métricas, e logs, permitindo que os sinais complementem cada um deles. - [Convensão semântica](#semantic-conventions): A Convensão semântica define como produzir telemetria para operações padronizadas. - [Log instrumentation](#log-instrumentation): A Convensão semântica define como produzir telemetria para operações padronizadas. -{{% alert %}} Enquanto [Categorias de instrumentação](#instrumentation-categories) -mostram diversas opções para instrumentar uma aplicação, nós recomendamos que os usuários iniciem com a página [Agente Java](#zero-code-java-agent). O agente do Java possui uma instalação simples, e automaticamente instala e detecta a instrumentação para uma grande variedade de bibliotecas. {{% /alert %}} +{{% alert %}} Enquanto [categorias de instrumentação](#instrumentation-categories) mostram diversas opções para instrumentar uma aplicação, nós recomendamos que os usuários iniciem com a página [Agente Java](#zero-code-java-agent). O agente do Java possui uma instalação simples, e automaticamente instala e detecta a instrumentação para uma grande variedade de bibliotecas. {{% /alert %}} ## Categorias de instrumentação @@ -32,188 +30,131 @@ Existem diversas categorias de instrumentação: - [Zero-code: Agente Java](#zero-code-java-agent) é uma forma de instrumentação sem código **[1]** que manipula dinamicamente o bytecode da aplicação. - [Zero-code: Spring Boot starter](#zero-code-spring-boot-starter) é uma forma de instrumentação sem código **[1]** que utiliza a autoconfiguração do spring para instalar [biblioteca de instrumentação](#library-instrumentation). - [Biblioteca de instrumentação](#library-instrumentation) envolve ou utiliza pontos de extensão para instrumentar uma biblioteca, exigindo que os usuários instalem e/ou adaptem o uso da biblioteca. -- [Instrumentação nativa](#native-instrumentation) is built directly into libraries and frameworks. -- [Manual instrumentation](#manual-instrumentation) is written by application authors, and typically specific to the application domain. -- [Shims](#shims) bridge data from one observability library to another, - typically _from_ some library into OpenTelemetry. +- [Instrumentação nativa](#native-instrumentation) é incorporada diretamente em bibliotecas e frameworks. +- [Instrumentação manual](#manual-instrumentation) é escrito pelos autores das aplicações, e normalmente específico para o domínio da aplicação. +- [Shims](#shims) conectam dados de uma biblioteca de observabilidade a outra, normalmente _de_ alguma biblioteca para o OpenTelemetry. -**[1]**: instrumentação sem código is installed automatically based on detected -libraries / frameworks. +**[1]**: A instrumentação sem código é instalada automaticamente baseado nas bibliotecas e frameworks detectados. -The -[opentelemetry-java-instrumentation](https://github.com/open-telemetry/opentelemetry-java-instrumentation) -project contains the source code for Agente Java, Spring Boot starter, and -Biblioteca de instrumentação. +O projeto [opentelemetry-java-instrumentation](https://github.com/open-telemetry/opentelemetry-java-instrumentation) contém o código fonte do Agente Java, inicializar Spring Boot, e Biblioteca de instrumentação. ### Zero-code: Agente Java -O agente do Java is a form of zero-code -[automatic instrumentation](/docs/specs/otel/glossary/#automatic-instrumentation) -that dynamically manipulates application bytecode. +O agente do Java é uma forma de [instrumentação automática](/docs/specs/otel/glossary/#automatic-instrumentation) zero código +que manipula dinâmicamente o bytecode da aplicação. -For a list of libraries instrumented by O agente do Java, see the -"Auto-instrumented versions" column on -[supported libraries](https://github.com/open-telemetry/opentelemetry-java-instrumentation/blob/main/docs/supported-libraries.md). +Para uma lista de bibliotecas instrumentadas pelo agente do Java, observe a coluna "Auto-instrumented versions" em +[bibliotecas suportadas](https://github.com/open-telemetry/opentelemetry-java-instrumentation/blob/main/docs/supported-libraries.md). -See [Agente Java](/docs/zero-code/java/agent/) for more details. +Veja [Agente Java](/docs/zero-code/java/agent/) para mais detalhes. ### Zero-code: Spring Boot starter -The Spring Boot starter is a form of zero-code -[automatic instrumentation](/docs/specs/otel/glossary/#automatic-instrumentation) -that leverages spring autoconfigure to install +O Spring Boot starter é uma forma de [instrumentação automática](/docs/specs/otel/glossary/#automatic-instrumentation) zero código +que aproveita a autoconfiguração do spring para instalar a [biblioteca de instrumentação](#library-instrumentation). -See [Spring Boot starter](/docs/zero-code/java/spring-boot-starter/) for -details. +Veja [Spring Boot starter](/docs/zero-code/java/spring-boot-starter/) para detalhes. ### Biblioteca de instrumentação [Biblioteca de instrumentação](/docs/specs/otel/glossary/#instrumentation-library) -wraps or uses extension points to instrument a library, requiring users to -install and/or adapt library usage. +envolve ou usa os pontos de extensão para instrumentar a biblioteca,obrigando os usuários a instalar e/ou adaptar o uso da biblioteca. -For a list of instrumentation libraries, see the "Standalone Library -Instrumentation" column on -[supported libraries](https://github.com/open-telemetry/opentelemetry-java-instrumentation/blob/main/docs/supported-libraries.md). +Para uma lista de instrumentação de bibliotecas, veja a coluna "Standalone Library Instrumentation [1]" em [bibliotecas suportadas](https://github.com/open-telemetry/opentelemetry-java-instrumentation/blob/main/docs/supported-libraries.md). ### Instrumentação nativa -[Instrumentação nativa](/docs/specs/otel/glossary/#natively-instrumented) is -built directly into libraries or frameworks. OpenTelemetry encourages library -authors to add instrumentação nativa using the [API](../api/). In the long -term, we hope the instrumentação nativa becomes the norm, and view the -instrumentation maintained by OpenTelemetry in -[opentelemetry-java-instrumentation](https://github.com/open-telemetry/opentelemetry-java-instrumentation) -as a temporary means of filling the gap. +[Instrumentação nativa](/docs/specs/otel/glossary/#natively-instrumented) é pré definido diretamente nas bibliotecas ou frameworks. OpenTelemetry encorage os autores de bibliotecas para adicionar instrumentação nativa usando a [API](../api/). No longo prazo, nós esperamos que a instrumentação nativa seja o padrão, e veja a instrumentação mantida pelo OpenTelemetry em +[opentelemetry-java-instrumentação](https://github.com/open-telemetry/opentelemetry-java-instrumentation) +como um meio temporário de preencher a lacuna. {{% docs/languages/native-libraries "java" %}} -### Manual instrumentation +### Instrumentação manual -[Manual instrumentation](/docs/specs/otel/glossary/#manual-instrumentation) is -written by application authors, and typically specific to the application -domain. +[Instrumentação manual](/docs/specs/otel/glossary/#manual-instrumentation) é escrito pelos autores das aplicações, e normalmente específico para o domínio da aplicação. ### Shims -A shim is instrumentation that bridges data from one observability library to -another, typically _from_ some library into OpenTelemetry. +Um shim é uma instrumentação que conecta dados de uma biblioteca de observabilidade até outra, normalmente _de_ alguma biblioteca para o OpenTelemetry. -Shims maintained in the OpenTelemetry Java ecosystem: +Shims mantidos no ecossistema OpenTelemetry Java: -| Description | Documentation | Signal(s) | Artifact | +| Descrição | Documentação | Sinal(s) | Artefato | | ------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------- | ------------------------------------------------------------------------------------------------------------------------------- | -| Bridge [OpenTracing](https://opentracing.io/) into OpenTelemetry | [README](https://github.com/open-telemetry/opentelemetry-java/tree/main/opentracing-shim) | Traces | `io.opentelemetry:opentelemetry-opentracing-shim:{{% param vers.otel %}}` | -| Bridge [Opencensus](https://opencensus.io/) into OpenTelemetry | [README](https://github.com/open-telemetry/opentelemetry-java/tree/main/opencensus-shim) | Traces, Metrics | `io.opentelemetry:opentelemetry-opencensus-shim:{{% param vers.otel %}}-alpha` | -| Bridge [Micrometer](https://micrometer.io/) into OpenTelemetry | [README](https://github.com/open-telemetry/opentelemetry-java-instrumentation/tree/main/instrumentation/micrometer/micrometer-1.5/library) | Metrics | `io.opentelemetry.instrumentation:opentelemetry-micrometer-1.5:{{% param vers.instrumentation %}}-alpha` | -| Bridge [JMX](https://docs.oracle.com/javase/7/docs/technotes/guides/management/agent.html) into OpenTelemetry | [README](https://github.com/open-telemetry/opentelemetry-java-instrumentation/blob/main/instrumentation/jmx-metrics/javaagent/README.md) | Metrics | `io.opentelemetry.instrumentation:opentelemetry-jmx-metrics:{{% param vers.instrumentation %}}-alpha` | -| Bridge OpenTelemetry into [Prometheus Java client](https://github.com/prometheus/client_java) | [README](https://github.com/open-telemetry/opentelemetry-java-contrib/tree/main/prometheus-client-bridge) | Metrics | `io.opentelemetry.contrib:opentelemetry-prometheus-client-bridge:{{% param vers.contrib %}}-alpha` | -| Bridge OpenTelemetry into [Micrometer](https://micrometer.io/) | [README](https://github.com/open-telemetry/opentelemetry-java-contrib/tree/main/micrometer-meter-provider) | Metrics | `io.opentelemetry.contrib:opentelemetry-micrometer-meter-provider:{{% param vers.contrib %}}-alpha` | -| Bridge [Log4j](https://logging.apache.org/log4j/2.x/index.html) into OpenTelemetry | [README](https://github.com/open-telemetry/opentelemetry-java-instrumentation/tree/main/instrumentation/log4j/log4j-appender-2.17/library) | Logs | `io.opentelemetry.instrumentation:opentelemetry-log4j-appender-2.17:{{% param vers.instrumentation %}}-alpha` | -| Bridge [Logback](https://logback.qos.ch/) into OpenTelemetry | [README](https://github.com/open-telemetry/opentelemetry-java-instrumentation/tree/main/instrumentation/logback/logback-appender-1.0/library) | Logs | `io.opentelemetry.instrumentation:opentelemetry-logback-appender-1.0:{{% param vers.instrumentation %}}-alpha` | -| Bridge OpenTelemetry context into [Log4j](https://logging.apache.org/log4j/2.x/index.html) | [README](https://github.com/open-telemetry/opentelemetry-java-instrumentation/tree/main/instrumentation/log4j/log4j-context-data/log4j-context-data-2.17/library-autoconfigure) | Context | `io.opentelemetry.instrumentation:opentelemetry-log4j-context-data-2.17-autoconfigure:{{% param vers.instrumentation %}}-alpha` | -| Bridge OpenTelemetry context into [Logback](https://logback.qos.ch/) | [README](https://github.com/open-telemetry/opentelemetry-java-instrumentation/tree/main/instrumentation/logback/logback-mdc-1.0/library) | Context | `io.opentelemetry.instrumentation:opentelemetry-logback-mdc-1.0:{{% param vers.instrumentation %}}-alpha` | +| Bridge [OpenTracing](https://opentracing.io/) no OpenTelemetry | [LEIA-ME](https://github.com/open-telemetry/opentelemetry-java/tree/main/opentracing-shim) | Rastros | `io.opentelemetry:opentelemetry-opentracing-shim:{{% param vers.otel %}}` | +| Bridge [Opencensus](https://opencensus.io/) no OpenTelemetry | [LEIA-ME](https://github.com/open-telemetry/opentelemetry-java/tree/main/opencensus-shim) | Rastros, Métricas | `io.opentelemetry:opentelemetry-opencensus-shim:{{% param vers.otel %}}-alpha` | +| Bridge [Micrometer](https://micrometer.io/) no OpenTelemetry | [LEIA-ME](https://github.com/open-telemetry/opentelemetry-java-instrumentation/tree/main/instrumentation/micrometer/micrometer-1.5/library) | Métricas | `io.opentelemetry.instrumentation:opentelemetry-micrometer-1.5:{{% param vers.instrumentation %}}-alpha` | +| Bridge [JMX](https://docs.oracle.com/javase/7/docs/technotes/guides/management/agent.html) no OpenTelemetry | [LEIA-ME](https://github.com/open-telemetry/opentelemetry-java-instrumentation/blob/main/instrumentation/jmx-metrics/javaagent/LEIA-ME.md) | Métricas | `io.opentelemetry.instrumentation:opentelemetry-jmx-metrics:{{% param vers.instrumentation %}}-alpha` | +| Bridge OpenTelemetry no [Prometheus Java client](https://github.com/prometheus/client_java) | [LEIA-ME](https://github.com/open-telemetry/opentelemetry-java-contrib/tree/main/prometheus-client-bridge) | Métricas | `io.opentelemetry.contrib:opentelemetry-prometheus-client-bridge:{{% param vers.contrib %}}-alpha` | +| Bridge OpenTelemetry no [Micrometer](https://micrometer.io/) | [LEIA-ME](https://github.com/open-telemetry/opentelemetry-java-contrib/tree/main/micrometer-meter-provider) | Métricas | `io.opentelemetry.contrib:opentelemetry-micrometer-meter-provider:{{% param vers.contrib %}}-alpha` | +| Bridge [Log4j](https://logging.apache.org/log4j/2.x/index.html) no OpenTelemetry | [LEIA-ME](https://github.com/open-telemetry/opentelemetry-java-instrumentation/tree/main/instrumentation/log4j/log4j-appender-2.17/library) | Logs | `io.opentelemetry.instrumentation:opentelemetry-log4j-appender-2.17:{{% param vers.instrumentation %}}-alpha` | +| Bridge [Logback](https://logback.qos.ch/) no OpenTelemetry | [LEIA-ME](https://github.com/open-telemetry/opentelemetry-java-instrumentation/tree/main/instrumentation/logback/logback-appender-1.0/library) | Logs | `io.opentelemetry.instrumentation:opentelemetry-logback-appender-1.0:{{% param vers.instrumentation %}}-alpha` | +| Bridge OpenTelemetry context no [Log4j](https://logging.apache.org/log4j/2.x/index.html) | [LEIA-ME](https://github.com/open-telemetry/opentelemetry-java-instrumentation/tree/main/instrumentation/log4j/log4j-context-data/log4j-context-data-2.17/library-autoconfigure) | Context | `io.opentelemetry.instrumentation:opentelemetry-log4j-context-data-2.17-autoconfigure:{{% param vers.instrumentation %}}-alpha` | +| Bridge OpenTelemetry context no [Logback](https://logback.qos.ch/) | [LEIA-ME](https://github.com/open-telemetry/opentelemetry-java-instrumentation/tree/main/instrumentation/logback/logback-mdc-1.0/library) | Context | `io.opentelemetry.instrumentation:opentelemetry-logback-mdc-1.0:{{% param vers.instrumentation %}}-alpha` | ## Propagação de Contexto -The OpenTelemetry APIs are designed to be complementary, with the whole greater -than the sum of the parts. Each signal has its own strengths, and collectively -stitch together a compelling observability story. - -Importantly, the data from the various signals are linked together through trace -context: - -- Spans are related to other spans through span parent and links, which each - record trace context of related spans. -- Metrics are related to spans through - [exemplars](/docs/specs/otel/metrics/data-model/#exemplars), which record - trace context of a particular measurement. -- Logs are related to spans by recording trace context on log records. - -For this correlation to work, trace context must be propagated throughout an -application (across function calls and threads), and across application -boundaries. The [context API](../api/#context-api) facilitates this. -Instrumentation needs to be written in a manner which is context aware: - -- Libraries that represent the entry point to an application (i.e. HTTP servers, - message consumers, etc.) should [extract context](../api/#contextpropagators) - from incoming messages. -- Libraries that represent an exit point from an application (i.e. HTTP clients, - message producers, etc.) should [inject context](../api/#contextpropagators) - into outgoing messages. -- Libraries should implicitly or explicitly pass [Context](../api/#context) - through the callstack and across any threads. +As APIs do OpenTelemetry foram desenhados para complementar, com o todos sendo maior que a soma das partes. Cada signal tem seus pontos fortes , e unidos formam uma visão convincente de uma história de observabilidade. + +Importante, os dados de vários sinais são *linkados* juntos através do contecto de rastreamento: + +- Spans são relacionas com outros spans através do span parent e links, que registram os contextos de rastreamento dos spans relacionados. +- Métricas são relacionadas a spans através de [exemplares](/docs/specs/otel/metrics/data-model/#exemplars), que registram o contexto de rastreamento de uma medição específica. +- Logs são relacionados a spans ao registrar o contexto de rastreamento nos registros de logs. + +Para essa correlação funcionar, o contexto de rastreamento precisa ser propagado através da aplicação (entre chamada de funções e threads), e entre fronteiras da aplicação. O [context API](../api/#context-api) facilita isso. + +Instrumentação precisa ser escrita de uma maneira que seja reconhedida pelo contexto: + +- Bibliotecas que representam um ponto de entrada da aplicação (i.e. Servidores HTTP, + Consumidores de Mensagens, etc.) deve [extrair o context](../api/#contextpropagators) + de mensagens recebidas. +- Bibliotecas que representam um ponto de saída de uma aplicação (i.e. Clientes HTTP, + Produtores de Mensagens, etc.) devem [injetar o context](../api/#contextpropagators) + em mensagens de saída. +- Bibliotecas devem passar implicitamente ou explicitamente o [context](../api/#context) + através da pilha de chamadas e entre qualquer threads. ## Convensão semântica -The [Convensão semântica](/docs/specs/semconv/) define how to produce telemetry -for standard operations. Among other things, A Convensão semântica specify -span names, span kinds, metric instruments, metric units, metric types, and -attribute key, value, and requirement levels. +A [Convensão semântica](/docs/specs/semconv/) define como produzir telemetria para os padrões de operação. Entre outras coisas, a convensão semântica especifica nomes de spans, tipos de sans, métricas instrumentadas, unidades de métricas, tipos de métricas, e atributos chave, valor, e níveis de requisitos. -When writing instrumentation, consult A Convensão semântica and conform to -any which are applicable to the domain. +Ao escrever instrumentação, consulte a convensão semântica e confirme que quaisquer convenções aplicáveis ao domínio estejam sendo seguidas. -OpenTelemetry Java [publishes artifacts](../api/#semantic-attributes) to assist -in conforming to A Convensão semântica, including generated constants for -attribute keys and values. +OpenTelemetry Java [publica artefatos](../api/#semantic-attributes) para auxiliar an conformidade com a convensão semântica, incluindo constantes geradas para chaves e valores de atributos. -TODO: discuss instrumentation API and how it helps conform to semantic -conventions +TODO: Discutir instrumentação API e como isso ajuda a conformidade com a convenção semântica. -## Log instrumentation +## Instrumentação de Log -While the [LoggerProvider](../api/#loggerprovider) / [Logger](../api/#logger) -APIs are structurally similar to the equivalent [trace](../api/#tracerprovider) -and [metric](../api/#meterprovider) APIs, they serve a different use case. As of -now, `LoggerProvider` / `Logger` and associated classes represent the -[Log Bridge API](/docs/specs/otel/logs/api/), which exists to write log -appenders to bridge logs recorded through other log APIs / frameworks into -OpenTelemetry. They are not intended for end user use as a replacement for Log4j +Enquanto o [LoggerProvider](../api/#loggerprovider) / [Logger](../api/#logger) +APIs são estruturalmente similares ou equivalentes [trace](../api/#tracerprovider) +e [métricas](../api/#meterprovider) APIs, servem para diferentes casos de uso. A partir de agora, `LoggerProvider` / `Logger` e as classes associadas representam o +[Log Bridge API](/docs/specs/otel/logs/api/), que existe para escrever aplicadores de logs para conectar logs registrados através de outras APIs de log / frameworks no OpenTelemetry. Eles não são destinados para usuários finais como um substituto para Log4j / SLF4J / Logback / etc. -There are two typical workflows for consuming log instrumentation in -OpenTelemetry catering to different application requirements: - -### Direct to collector - -In the direct to collector workflow, logs are emitted directly from an -application to a collector using a network protocol (e.g. OTLP). This workflow -is simple to set up as it doesn't require any additional log forwarding -components, and allows an application to easily emit structured logs that -conform to the [log data model](/docs/specs/otel/logs/data-model/). However, the -overhead required for applications to queue and export logs to a network -location may not be suitable for all applications. - -To use this workflow: - -- Install appropriate log appender. **[1]** -- Configure the OpenTelemetry [Log SDK](../sdk/#sdkloggerprovider) to export log - records to desired target destination (the - [collector](https://github.com/open-telemetry/opentelemetry-collector) or - other). - -**[1]**: Log appenders are a type of [shim](#shims) which bridges logs from a -log framework into the OpenTelemetry log SDK. See "Bridge Log4j into -OpenTelemetry", "Bridge Logback into OpenTelemetry" entries. See -[Log Appender example](https://github.com/open-telemetry/opentelemetry-java-docs/tree/main/log-appender) -for demonstration of a variety of scenarios. - -### Via file or stdout - -In the file or stdout workflow, logs are written to files or standout output. -Another component (e.g. FluentBit) is responsible for reading / tailing the -logs, parsing them to more structured format, and forwarding them a target, such -as the collector. This workflow may be preferable in situations where -application requirements do not permit additional overhead from -[direct to collector](#direct-to-collector). However, it requires that all log -fields required down stream are encoded into the logs, and that the component -reading the logs parse the data into the -[log data model](/docs/specs/otel/logs/data-model). The installation and -configuration of log forwarding components is outside the scope of this -document. - -Log correlation with traces is available by installing a [shim](#shims) to -bridge OpenTelemetry context into the log framework. See "Bridge OpenTelemetry -context into Log4j", "Bridge OpenTelemetry context into Logback" entries. +Eles são dois típicos fluxos de trabalho para consumir instrumentação de logs no OpenTelemetry atendendo a diferentes requisitos de aplicação: + +### Direto para o Coletor + +No fluxo de trabalho direto para o coletor, logs são emitidos diretamente da aplicação para o coletor usando um protocolo de rede (e.g. OTLP). Este fluxo de trabalho é simples para configurar e não requer nenhum componente de encaminhamento de log adicional, e permite que uma facilmente emita logs estruturados em conformidade com o [modelo de dados de log](/docs/specs/otel/logs/data-model/). No entanto, a sobrecarga necessária para as aplicações enfileirarem e exportarem os logs para um local rede pode não ser adequada para todas os aplicativos. + +Para usar este fluxo de trabalho: + +- Instale apropriados aplicadores de logs. **[1]** +- Configure o OpenTelemetry [Log SDK](../sdk/#sdkloggerprovider) para exportar registros de logs para o destino desejado (o + [coletor](https://github.com/open-telemetry/opentelemetry-collector) ou outro). + +**[1]**: Aplicadores de Logs são um tipo de [shim](#shims) que conecta logs de um framework no OpenTelemetry log SDK. Veja "Bridge Log4j em +OpenTelemetry", "Bridge Logback em OpenTelemetry" entradas. Veja +[Exemplo de aplicadores de Logs](https://github.com/open-telemetry/opentelemetry-java-docs/tree/main/log-appender) +para demonstração de uma variedade de cenários. + +### Via arquivo ou stdout + +No fluxo de trabalho arquivo ou stdout, logs são escritos para arquivos ou saída *standout*. +Outro componente (e.g. FluentBit) é responsável por ler os logs, interpretar para um formato estruturado, e encaminhar para um destino, como um coletor. Este fluxo de trabalho pode ser preferido em situações onde os requisitos da aplicação não permitem sobrecarga adicional da abordagem [direto para o coletor](#direct-to-collector). No entanto, isso requer que todos os campos de logs necessários para processamento posterior sejam codificados em logs, e este componente leia os dados de logs interpretados em [modelo de dados de log](/docs/specs/otel/logs/data-model). A instalação e configuração dos componentes de encaminhamento de log está fora do escopo deste documento. + +Correlação de Logs com rastros está disponível instalando um [shim](#shims) para conectar o contexto do OpenTelemetry no log framework. Veja "Bridge OpenTelemetry contexto em Log4j", "Bridge OpenTelemetry contexto em Logback" entradas. From 178d7ce8f886995c3bae35ac8bb2d5fc7c4a81ad Mon Sep 17 00:00:00 2001 From: Vinaum8 Date: Sat, 25 Jan 2025 19:02:24 -0300 Subject: [PATCH 003/129] Publish Branch to Review - Prettier --- .../pt/docs/languages/java/instrumentation.md | 249 ++++++++++++------ 1 file changed, 168 insertions(+), 81 deletions(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index b244d7dd880c..d83071577727 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -13,59 +13,97 @@ cSpell:ignore: Logback logback -A instrumentação registra a telemetria usando a [API](../api/). O [SDK](../sdk/) é a implementação de referência embutida na API, e é -[configurada](../configuration/) para processar e exportar a telemetrira produzida pelas chamadas de instrumentação da API. Esta página discute o ecossistema de instrumentação no OpenTelemetry Java, incluíndo recursos para usuários finais e tópicos relacionados com instrumentação: - -- [Categorias de instrumentação](#instrumentation-categories): Existem diversas categorias de instrumentação para cada tipo de caso de uso e para cada padrão de instalação. -- [Propagação de Contexto](#context-propagation): Propagação de Contexto provê uma correlação entre rastros, métricas, e logs, permitindo que os sinais complementem cada um deles. -- [Convensão semântica](#semantic-conventions): A Convensão semântica define como produzir telemetria para operações padronizadas. -- [Log instrumentation](#log-instrumentation): A Convensão semântica define como produzir telemetria para operações padronizadas. - -{{% alert %}} Enquanto [categorias de instrumentação](#instrumentation-categories) mostram diversas opções para instrumentar uma aplicação, nós recomendamos que os usuários iniciem com a página [Agente Java](#zero-code-java-agent). O agente do Java possui uma instalação simples, e automaticamente instala e detecta a instrumentação para uma grande variedade de bibliotecas. {{% /alert %}} +A instrumentação registra a telemetria usando a [API](../api/). O [SDK](../sdk/) +é a implementação de referência embutida na API, e é +[configurada](../configuration/) para processar e exportar a telemetrira +produzida pelas chamadas de instrumentação da API. Esta página discute o +ecossistema de instrumentação no OpenTelemetry Java, incluíndo recursos para +usuários finais e tópicos relacionados com instrumentação: + +- [Categorias de instrumentação](#instrumentation-categories): Existem diversas + categorias de instrumentação para cada tipo de caso de uso e para cada padrão + de instalação. +- [Propagação de Contexto](#context-propagation): Propagação de Contexto provê + uma correlação entre rastros, métricas, e logs, permitindo que os sinais + complementem cada um deles. +- [Convensão semântica](#semantic-conventions): A Convensão semântica define + como produzir telemetria para operações padronizadas. +- [Log instrumentation](#log-instrumentation): A Convensão semântica define como + produzir telemetria para operações padronizadas. + +{{% alert %}} Enquanto +[categorias de instrumentação](#instrumentation-categories) mostram diversas +opções para instrumentar uma aplicação, nós recomendamos que os usuários iniciem +com a página [Agente Java](#zero-code-java-agent). O agente do Java possui uma +instalação simples, e automaticamente instala e detecta a instrumentação para +uma grande variedade de bibliotecas. {{% /alert %}} ## Categorias de instrumentação Existem diversas categorias de instrumentação: -- [Zero-code: Agente Java](#zero-code-java-agent) é uma forma de instrumentação sem código **[1]** que manipula dinamicamente o bytecode da aplicação. -- [Zero-code: Spring Boot starter](#zero-code-spring-boot-starter) é uma forma de instrumentação sem código **[1]** que utiliza a autoconfiguração do spring para instalar [biblioteca de instrumentação](#library-instrumentation). -- [Biblioteca de instrumentação](#library-instrumentation) envolve ou utiliza pontos de extensão para instrumentar uma biblioteca, exigindo que os usuários instalem e/ou adaptem o uso da biblioteca. -- [Instrumentação nativa](#native-instrumentation) é incorporada diretamente em bibliotecas e frameworks. -- [Instrumentação manual](#manual-instrumentation) é escrito pelos autores das aplicações, e normalmente específico para o domínio da aplicação. -- [Shims](#shims) conectam dados de uma biblioteca de observabilidade a outra, normalmente _de_ alguma biblioteca para o OpenTelemetry. - -**[1]**: A instrumentação sem código é instalada automaticamente baseado nas bibliotecas e frameworks detectados. - -O projeto [opentelemetry-java-instrumentation](https://github.com/open-telemetry/opentelemetry-java-instrumentation) contém o código fonte do Agente Java, inicializar Spring Boot, e Biblioteca de instrumentação. +- [Zero-code: Agente Java](#zero-code-java-agent) é uma forma de instrumentação + sem código **[1]** que manipula dinamicamente o bytecode da aplicação. +- [Zero-code: Spring Boot starter](#zero-code-spring-boot-starter) é uma forma + de instrumentação sem código **[1]** que utiliza a autoconfiguração do spring + para instalar [biblioteca de instrumentação](#library-instrumentation). +- [Biblioteca de instrumentação](#library-instrumentation) envolve ou utiliza + pontos de extensão para instrumentar uma biblioteca, exigindo que os usuários + instalem e/ou adaptem o uso da biblioteca. +- [Instrumentação nativa](#native-instrumentation) é incorporada diretamente em + bibliotecas e frameworks. +- [Instrumentação manual](#manual-instrumentation) é escrito pelos autores das + aplicações, e normalmente específico para o domínio da aplicação. +- [Shims](#shims) conectam dados de uma biblioteca de observabilidade a outra, + normalmente _de_ alguma biblioteca para o OpenTelemetry. + +**[1]**: A instrumentação sem código é instalada automaticamente baseado nas +bibliotecas e frameworks detectados. + +O projeto +[opentelemetry-java-instrumentation](https://github.com/open-telemetry/opentelemetry-java-instrumentation) +contém o código fonte do Agente Java, inicializar Spring Boot, e Biblioteca de +instrumentação. ### Zero-code: Agente Java -O agente do Java é uma forma de [instrumentação automática](/docs/specs/otel/glossary/#automatic-instrumentation) zero código -que manipula dinâmicamente o bytecode da aplicação. +O agente do Java é uma forma de +[instrumentação automática](/docs/specs/otel/glossary/#automatic-instrumentation) +zero código que manipula dinâmicamente o bytecode da aplicação. -Para uma lista de bibliotecas instrumentadas pelo agente do Java, observe a coluna "Auto-instrumented versions" em +Para uma lista de bibliotecas instrumentadas pelo agente do Java, observe a +coluna "Auto-instrumented versions" em [bibliotecas suportadas](https://github.com/open-telemetry/opentelemetry-java-instrumentation/blob/main/docs/supported-libraries.md). Veja [Agente Java](/docs/zero-code/java/agent/) para mais detalhes. ### Zero-code: Spring Boot starter -O Spring Boot starter é uma forma de [instrumentação automática](/docs/specs/otel/glossary/#automatic-instrumentation) zero código -que aproveita a autoconfiguração do spring para instalar a +O Spring Boot starter é uma forma de +[instrumentação automática](/docs/specs/otel/glossary/#automatic-instrumentation) +zero código que aproveita a autoconfiguração do spring para instalar a [biblioteca de instrumentação](#library-instrumentation). -Veja [Spring Boot starter](/docs/zero-code/java/spring-boot-starter/) para detalhes. +Veja [Spring Boot starter](/docs/zero-code/java/spring-boot-starter/) para +detalhes. ### Biblioteca de instrumentação [Biblioteca de instrumentação](/docs/specs/otel/glossary/#instrumentation-library) -envolve ou usa os pontos de extensão para instrumentar a biblioteca,obrigando os usuários a instalar e/ou adaptar o uso da biblioteca. +envolve ou usa os pontos de extensão para instrumentar a biblioteca,obrigando os +usuários a instalar e/ou adaptar o uso da biblioteca. -Para uma lista de instrumentação de bibliotecas, veja a coluna "Standalone Library Instrumentation [1]" em [bibliotecas suportadas](https://github.com/open-telemetry/opentelemetry-java-instrumentation/blob/main/docs/supported-libraries.md). +Para uma lista de instrumentação de bibliotecas, veja a coluna "Standalone +Library Instrumentation [1]" em +[bibliotecas suportadas](https://github.com/open-telemetry/opentelemetry-java-instrumentation/blob/main/docs/supported-libraries.md). ### Instrumentação nativa -[Instrumentação nativa](/docs/specs/otel/glossary/#natively-instrumented) é pré definido diretamente nas bibliotecas ou frameworks. OpenTelemetry encorage os autores de bibliotecas para adicionar instrumentação nativa usando a [API](../api/). No longo prazo, nós esperamos que a instrumentação nativa seja o padrão, e veja a instrumentação mantida pelo OpenTelemetry em +[Instrumentação nativa](/docs/specs/otel/glossary/#natively-instrumented) é pré +definido diretamente nas bibliotecas ou frameworks. OpenTelemetry encorage os +autores de bibliotecas para adicionar instrumentação nativa usando a +[API](../api/). No longo prazo, nós esperamos que a instrumentação nativa seja o +padrão, e veja a instrumentação mantida pelo OpenTelemetry em [opentelemetry-java-instrumentação](https://github.com/open-telemetry/opentelemetry-java-instrumentation) como um meio temporário de preencher a lacuna. @@ -73,88 +111,137 @@ como um meio temporário de preencher a lacuna. ### Instrumentação manual -[Instrumentação manual](/docs/specs/otel/glossary/#manual-instrumentation) é escrito pelos autores das aplicações, e normalmente específico para o domínio da aplicação. +[Instrumentação manual](/docs/specs/otel/glossary/#manual-instrumentation) é +escrito pelos autores das aplicações, e normalmente específico para o domínio da +aplicação. ### Shims -Um shim é uma instrumentação que conecta dados de uma biblioteca de observabilidade até outra, normalmente _de_ alguma biblioteca para o OpenTelemetry. +Um shim é uma instrumentação que conecta dados de uma biblioteca de +observabilidade até outra, normalmente _de_ alguma biblioteca para o +OpenTelemetry. Shims mantidos no ecossistema OpenTelemetry Java: -| Descrição | Documentação | Sinal(s) | Artefato | -| ------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------- | ------------------------------------------------------------------------------------------------------------------------------- | -| Bridge [OpenTracing](https://opentracing.io/) no OpenTelemetry | [LEIA-ME](https://github.com/open-telemetry/opentelemetry-java/tree/main/opentracing-shim) | Rastros | `io.opentelemetry:opentelemetry-opentracing-shim:{{% param vers.otel %}}` | +| Descrição | Documentação | Sinal(s) | Artefato | +| ----------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------- | ------------------------------------------------------------------------------------------------------------------------------- | +| Bridge [OpenTracing](https://opentracing.io/) no OpenTelemetry | [LEIA-ME](https://github.com/open-telemetry/opentelemetry-java/tree/main/opentracing-shim) | Rastros | `io.opentelemetry:opentelemetry-opentracing-shim:{{% param vers.otel %}}` | | Bridge [Opencensus](https://opencensus.io/) no OpenTelemetry | [LEIA-ME](https://github.com/open-telemetry/opentelemetry-java/tree/main/opencensus-shim) | Rastros, Métricas | `io.opentelemetry:opentelemetry-opencensus-shim:{{% param vers.otel %}}-alpha` | -| Bridge [Micrometer](https://micrometer.io/) no OpenTelemetry | [LEIA-ME](https://github.com/open-telemetry/opentelemetry-java-instrumentation/tree/main/instrumentation/micrometer/micrometer-1.5/library) | Métricas | `io.opentelemetry.instrumentation:opentelemetry-micrometer-1.5:{{% param vers.instrumentation %}}-alpha` | -| Bridge [JMX](https://docs.oracle.com/javase/7/docs/technotes/guides/management/agent.html) no OpenTelemetry | [LEIA-ME](https://github.com/open-telemetry/opentelemetry-java-instrumentation/blob/main/instrumentation/jmx-metrics/javaagent/LEIA-ME.md) | Métricas | `io.opentelemetry.instrumentation:opentelemetry-jmx-metrics:{{% param vers.instrumentation %}}-alpha` | -| Bridge OpenTelemetry no [Prometheus Java client](https://github.com/prometheus/client_java) | [LEIA-ME](https://github.com/open-telemetry/opentelemetry-java-contrib/tree/main/prometheus-client-bridge) | Métricas | `io.opentelemetry.contrib:opentelemetry-prometheus-client-bridge:{{% param vers.contrib %}}-alpha` | -| Bridge OpenTelemetry no [Micrometer](https://micrometer.io/) | [LEIA-ME](https://github.com/open-telemetry/opentelemetry-java-contrib/tree/main/micrometer-meter-provider) | Métricas | `io.opentelemetry.contrib:opentelemetry-micrometer-meter-provider:{{% param vers.contrib %}}-alpha` | -| Bridge [Log4j](https://logging.apache.org/log4j/2.x/index.html) no OpenTelemetry | [LEIA-ME](https://github.com/open-telemetry/opentelemetry-java-instrumentation/tree/main/instrumentation/log4j/log4j-appender-2.17/library) | Logs | `io.opentelemetry.instrumentation:opentelemetry-log4j-appender-2.17:{{% param vers.instrumentation %}}-alpha` | -| Bridge [Logback](https://logback.qos.ch/) no OpenTelemetry | [LEIA-ME](https://github.com/open-telemetry/opentelemetry-java-instrumentation/tree/main/instrumentation/logback/logback-appender-1.0/library) | Logs | `io.opentelemetry.instrumentation:opentelemetry-logback-appender-1.0:{{% param vers.instrumentation %}}-alpha` | -| Bridge OpenTelemetry context no [Log4j](https://logging.apache.org/log4j/2.x/index.html) | [LEIA-ME](https://github.com/open-telemetry/opentelemetry-java-instrumentation/tree/main/instrumentation/log4j/log4j-context-data/log4j-context-data-2.17/library-autoconfigure) | Context | `io.opentelemetry.instrumentation:opentelemetry-log4j-context-data-2.17-autoconfigure:{{% param vers.instrumentation %}}-alpha` | -| Bridge OpenTelemetry context no [Logback](https://logback.qos.ch/) | [LEIA-ME](https://github.com/open-telemetry/opentelemetry-java-instrumentation/tree/main/instrumentation/logback/logback-mdc-1.0/library) | Context | `io.opentelemetry.instrumentation:opentelemetry-logback-mdc-1.0:{{% param vers.instrumentation %}}-alpha` | +| Bridge [Micrometer](https://micrometer.io/) no OpenTelemetry | [LEIA-ME](https://github.com/open-telemetry/opentelemetry-java-instrumentation/tree/main/instrumentation/micrometer/micrometer-1.5/library) | Métricas | `io.opentelemetry.instrumentation:opentelemetry-micrometer-1.5:{{% param vers.instrumentation %}}-alpha` | +| Bridge [JMX](https://docs.oracle.com/javase/7/docs/technotes/guides/management/agent.html) no OpenTelemetry | [LEIA-ME](https://github.com/open-telemetry/opentelemetry-java-instrumentation/blob/main/instrumentation/jmx-metrics/javaagent/LEIA-ME.md) | Métricas | `io.opentelemetry.instrumentation:opentelemetry-jmx-metrics:{{% param vers.instrumentation %}}-alpha` | +| Bridge OpenTelemetry no [Prometheus Java client](https://github.com/prometheus/client_java) | [LEIA-ME](https://github.com/open-telemetry/opentelemetry-java-contrib/tree/main/prometheus-client-bridge) | Métricas | `io.opentelemetry.contrib:opentelemetry-prometheus-client-bridge:{{% param vers.contrib %}}-alpha` | +| Bridge OpenTelemetry no [Micrometer](https://micrometer.io/) | [LEIA-ME](https://github.com/open-telemetry/opentelemetry-java-contrib/tree/main/micrometer-meter-provider) | Métricas | `io.opentelemetry.contrib:opentelemetry-micrometer-meter-provider:{{% param vers.contrib %}}-alpha` | +| Bridge [Log4j](https://logging.apache.org/log4j/2.x/index.html) no OpenTelemetry | [LEIA-ME](https://github.com/open-telemetry/opentelemetry-java-instrumentation/tree/main/instrumentation/log4j/log4j-appender-2.17/library) | Logs | `io.opentelemetry.instrumentation:opentelemetry-log4j-appender-2.17:{{% param vers.instrumentation %}}-alpha` | +| Bridge [Logback](https://logback.qos.ch/) no OpenTelemetry | [LEIA-ME](https://github.com/open-telemetry/opentelemetry-java-instrumentation/tree/main/instrumentation/logback/logback-appender-1.0/library) | Logs | `io.opentelemetry.instrumentation:opentelemetry-logback-appender-1.0:{{% param vers.instrumentation %}}-alpha` | +| Bridge OpenTelemetry context no [Log4j](https://logging.apache.org/log4j/2.x/index.html) | [LEIA-ME](https://github.com/open-telemetry/opentelemetry-java-instrumentation/tree/main/instrumentation/log4j/log4j-context-data/log4j-context-data-2.17/library-autoconfigure) | Context | `io.opentelemetry.instrumentation:opentelemetry-log4j-context-data-2.17-autoconfigure:{{% param vers.instrumentation %}}-alpha` | +| Bridge OpenTelemetry context no [Logback](https://logback.qos.ch/) | [LEIA-ME](https://github.com/open-telemetry/opentelemetry-java-instrumentation/tree/main/instrumentation/logback/logback-mdc-1.0/library) | Context | `io.opentelemetry.instrumentation:opentelemetry-logback-mdc-1.0:{{% param vers.instrumentation %}}-alpha` | ## Propagação de Contexto -As APIs do OpenTelemetry foram desenhados para complementar, com o todos sendo maior que a soma das partes. Cada signal tem seus pontos fortes , e unidos formam uma visão convincente de uma história de observabilidade. - -Importante, os dados de vários sinais são *linkados* juntos através do contecto de rastreamento: - -- Spans são relacionas com outros spans através do span parent e links, que registram os contextos de rastreamento dos spans relacionados. -- Métricas são relacionadas a spans através de [exemplares](/docs/specs/otel/metrics/data-model/#exemplars), que registram o contexto de rastreamento de uma medição específica. -- Logs são relacionados a spans ao registrar o contexto de rastreamento nos registros de logs. - -Para essa correlação funcionar, o contexto de rastreamento precisa ser propagado através da aplicação (entre chamada de funções e threads), e entre fronteiras da aplicação. O [context API](../api/#context-api) facilita isso. - -Instrumentação precisa ser escrita de uma maneira que seja reconhedida pelo contexto: - -- Bibliotecas que representam um ponto de entrada da aplicação (i.e. Servidores HTTP, - Consumidores de Mensagens, etc.) deve [extrair o context](../api/#contextpropagators) - de mensagens recebidas. -- Bibliotecas que representam um ponto de saída de uma aplicação (i.e. Clientes HTTP, - Produtores de Mensagens, etc.) devem [injetar o context](../api/#contextpropagators) - em mensagens de saída. -- Bibliotecas devem passar implicitamente ou explicitamente o [context](../api/#context) - através da pilha de chamadas e entre qualquer threads. +As APIs do OpenTelemetry foram desenhados para complementar, com o todos sendo +maior que a soma das partes. Cada signal tem seus pontos fortes , e unidos +formam uma visão convincente de uma história de observabilidade. + +Importante, os dados de vários sinais são _linkados_ juntos através do contecto +de rastreamento: + +- Spans são relacionas com outros spans através do span parent e links, que + registram os contextos de rastreamento dos spans relacionados. +- Métricas são relacionadas a spans através de + [exemplares](/docs/specs/otel/metrics/data-model/#exemplars), que registram o + contexto de rastreamento de uma medição específica. +- Logs são relacionados a spans ao registrar o contexto de rastreamento nos + registros de logs. + +Para essa correlação funcionar, o contexto de rastreamento precisa ser propagado +através da aplicação (entre chamada de funções e threads), e entre fronteiras da +aplicação. O [context API](../api/#context-api) facilita isso. + +Instrumentação precisa ser escrita de uma maneira que seja reconhedida pelo +contexto: + +- Bibliotecas que representam um ponto de entrada da aplicação (i.e. Servidores + HTTP, Consumidores de Mensagens, etc.) deve + [extrair o context](../api/#contextpropagators) de mensagens recebidas. +- Bibliotecas que representam um ponto de saída de uma aplicação (i.e. Clientes + HTTP, Produtores de Mensagens, etc.) devem + [injetar o context](../api/#contextpropagators) em mensagens de saída. +- Bibliotecas devem passar implicitamente ou explicitamente o + [context](../api/#context) através da pilha de chamadas e entre qualquer + threads. ## Convensão semântica -A [Convensão semântica](/docs/specs/semconv/) define como produzir telemetria para os padrões de operação. Entre outras coisas, a convensão semântica especifica nomes de spans, tipos de sans, métricas instrumentadas, unidades de métricas, tipos de métricas, e atributos chave, valor, e níveis de requisitos. +A [Convensão semântica](/docs/specs/semconv/) define como produzir telemetria +para os padrões de operação. Entre outras coisas, a convensão semântica +especifica nomes de spans, tipos de sans, métricas instrumentadas, unidades de +métricas, tipos de métricas, e atributos chave, valor, e níveis de requisitos. -Ao escrever instrumentação, consulte a convensão semântica e confirme que quaisquer convenções aplicáveis ao domínio estejam sendo seguidas. +Ao escrever instrumentação, consulte a convensão semântica e confirme que +quaisquer convenções aplicáveis ao domínio estejam sendo seguidas. -OpenTelemetry Java [publica artefatos](../api/#semantic-attributes) para auxiliar an conformidade com a convensão semântica, incluindo constantes geradas para chaves e valores de atributos. +OpenTelemetry Java [publica artefatos](../api/#semantic-attributes) para +auxiliar an conformidade com a convensão semântica, incluindo constantes geradas +para chaves e valores de atributos. -TODO: Discutir instrumentação API e como isso ajuda a conformidade com a convenção semântica. +TODO: Discutir instrumentação API e como isso ajuda a conformidade com a +convenção semântica. ## Instrumentação de Log Enquanto o [LoggerProvider](../api/#loggerprovider) / [Logger](../api/#logger) -APIs são estruturalmente similares ou equivalentes [trace](../api/#tracerprovider) -e [métricas](../api/#meterprovider) APIs, servem para diferentes casos de uso. A partir de agora, `LoggerProvider` / `Logger` e as classes associadas representam o -[Log Bridge API](/docs/specs/otel/logs/api/), que existe para escrever aplicadores de logs para conectar logs registrados através de outras APIs de log / frameworks no OpenTelemetry. Eles não são destinados para usuários finais como um substituto para Log4j -/ SLF4J / Logback / etc. - -Eles são dois típicos fluxos de trabalho para consumir instrumentação de logs no OpenTelemetry atendendo a diferentes requisitos de aplicação: +APIs são estruturalmente similares ou equivalentes +[trace](../api/#tracerprovider) e [métricas](../api/#meterprovider) APIs, servem +para diferentes casos de uso. A partir de agora, `LoggerProvider` / `Logger` e +as classes associadas representam o +[Log Bridge API](/docs/specs/otel/logs/api/), que existe para escrever +aplicadores de logs para conectar logs registrados através de outras APIs de log +/ frameworks no OpenTelemetry. Eles não são destinados para usuários finais como +um substituto para Log4j / SLF4J / Logback / etc. + +Eles são dois típicos fluxos de trabalho para consumir instrumentação de logs no +OpenTelemetry atendendo a diferentes requisitos de aplicação: ### Direto para o Coletor -No fluxo de trabalho direto para o coletor, logs são emitidos diretamente da aplicação para o coletor usando um protocolo de rede (e.g. OTLP). Este fluxo de trabalho é simples para configurar e não requer nenhum componente de encaminhamento de log adicional, e permite que uma facilmente emita logs estruturados em conformidade com o [modelo de dados de log](/docs/specs/otel/logs/data-model/). No entanto, a sobrecarga necessária para as aplicações enfileirarem e exportarem os logs para um local rede pode não ser adequada para todas os aplicativos. +No fluxo de trabalho direto para o coletor, logs são emitidos diretamente da +aplicação para o coletor usando um protocolo de rede (e.g. OTLP). Este fluxo de +trabalho é simples para configurar e não requer nenhum componente de +encaminhamento de log adicional, e permite que uma facilmente emita logs +estruturados em conformidade com o +[modelo de dados de log](/docs/specs/otel/logs/data-model/). No entanto, a +sobrecarga necessária para as aplicações enfileirarem e exportarem os logs para +um local rede pode não ser adequada para todas os aplicativos. Para usar este fluxo de trabalho: - Instale apropriados aplicadores de logs. **[1]** -- Configure o OpenTelemetry [Log SDK](../sdk/#sdkloggerprovider) para exportar registros de logs para o destino desejado (o - [coletor](https://github.com/open-telemetry/opentelemetry-collector) ou outro). - -**[1]**: Aplicadores de Logs são um tipo de [shim](#shims) que conecta logs de um framework no OpenTelemetry log SDK. Veja "Bridge Log4j em -OpenTelemetry", "Bridge Logback em OpenTelemetry" entradas. Veja +- Configure o OpenTelemetry [Log SDK](../sdk/#sdkloggerprovider) para exportar + registros de logs para o destino desejado (o + [coletor](https://github.com/open-telemetry/opentelemetry-collector) ou + outro). + +**[1]**: Aplicadores de Logs são um tipo de [shim](#shims) que conecta logs de +um framework no OpenTelemetry log SDK. Veja "Bridge Log4j em OpenTelemetry", +"Bridge Logback em OpenTelemetry" entradas. Veja [Exemplo de aplicadores de Logs](https://github.com/open-telemetry/opentelemetry-java-docs/tree/main/log-appender) para demonstração de uma variedade de cenários. ### Via arquivo ou stdout -No fluxo de trabalho arquivo ou stdout, logs são escritos para arquivos ou saída *standout*. -Outro componente (e.g. FluentBit) é responsável por ler os logs, interpretar para um formato estruturado, e encaminhar para um destino, como um coletor. Este fluxo de trabalho pode ser preferido em situações onde os requisitos da aplicação não permitem sobrecarga adicional da abordagem [direto para o coletor](#direct-to-collector). No entanto, isso requer que todos os campos de logs necessários para processamento posterior sejam codificados em logs, e este componente leia os dados de logs interpretados em [modelo de dados de log](/docs/specs/otel/logs/data-model). A instalação e configuração dos componentes de encaminhamento de log está fora do escopo deste documento. - -Correlação de Logs com rastros está disponível instalando um [shim](#shims) para conectar o contexto do OpenTelemetry no log framework. Veja "Bridge OpenTelemetry contexto em Log4j", "Bridge OpenTelemetry contexto em Logback" entradas. +No fluxo de trabalho arquivo ou stdout, logs são escritos para arquivos ou saída +_standout_. Outro componente (e.g. FluentBit) é responsável por ler os logs, +interpretar para um formato estruturado, e encaminhar para um destino, como um +coletor. Este fluxo de trabalho pode ser preferido em situações onde os +requisitos da aplicação não permitem sobrecarga adicional da abordagem +[direto para o coletor](#direct-to-collector). No entanto, isso requer que todos +os campos de logs necessários para processamento posterior sejam codificados em +logs, e este componente leia os dados de logs interpretados em +[modelo de dados de log](/docs/specs/otel/logs/data-model). A instalação e +configuração dos componentes de encaminhamento de log está fora do escopo deste +documento. + +Correlação de Logs com rastros está disponível instalando um [shim](#shims) para +conectar o contexto do OpenTelemetry no log framework. Veja "Bridge +OpenTelemetry contexto em Log4j", "Bridge OpenTelemetry contexto em Logback" +entradas. From 18c581a8ad1be139823ce60fa65ed4bfbcb514d2 Mon Sep 17 00:00:00 2001 From: Vinaum8 Date: Mon, 27 Jan 2025 09:00:08 -0300 Subject: [PATCH 004/129] Add default lang commit id. --- content/pt/docs/languages/java/instrumentation.md | 1 + 1 file changed, 1 insertion(+) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index d83071577727..914f6a1e7d3c 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -8,6 +8,7 @@ aliases: - libraries weight: 10 description: Ecossistema de Instrumentação no OpenTelemetry Java +default_lang_commit: d65798034935fcfdbdc6599b6e6d3dd942fbe62c cSpell:ignore: Logback logback --- From 7d1a35ffce3b4a7c5c66ffc316394ae849516152 Mon Sep 17 00:00:00 2001 From: Vinaum8 Date: Mon, 27 Jan 2025 09:23:35 -0300 Subject: [PATCH 005/129] =?UTF-8?q?fix=20conven=C3=A7=C3=A3o=20name.?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- content/pt/docs/languages/java/instrumentation.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index 914f6a1e7d3c..1491cd59d66e 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -27,9 +27,9 @@ usuários finais e tópicos relacionados com instrumentação: - [Propagação de Contexto](#context-propagation): Propagação de Contexto provê uma correlação entre rastros, métricas, e logs, permitindo que os sinais complementem cada um deles. -- [Convensão semântica](#semantic-conventions): A Convensão semântica define +- [Convenção semântica](#semantic-conventions): A Convenção semântica define como produzir telemetria para operações padronizadas. -- [Log instrumentation](#log-instrumentation): A Convensão semântica define como +- [Log instrumentation](#log-instrumentation): A Convenção semântica define como produzir telemetria para operações padronizadas. {{% alert %}} Enquanto @@ -171,18 +171,18 @@ contexto: [context](../api/#context) através da pilha de chamadas e entre qualquer threads. -## Convensão semântica +## Convenção semântica -A [Convensão semântica](/docs/specs/semconv/) define como produzir telemetria -para os padrões de operação. Entre outras coisas, a convensão semântica +A [Convenção semântica](/docs/specs/semconv/) define como produzir telemetria +para os padrões de operação. Entre outras coisas, a convenção semântica especifica nomes de spans, tipos de sans, métricas instrumentadas, unidades de métricas, tipos de métricas, e atributos chave, valor, e níveis de requisitos. -Ao escrever instrumentação, consulte a convensão semântica e confirme que +Ao escrever instrumentação, consulte a convenção semântica e confirme que quaisquer convenções aplicáveis ao domínio estejam sendo seguidas. OpenTelemetry Java [publica artefatos](../api/#semantic-attributes) para -auxiliar an conformidade com a convensão semântica, incluindo constantes geradas +auxiliar an conformidade com a convenção semântica, incluindo constantes geradas para chaves e valores de atributos. TODO: Discutir instrumentação API e como isso ajuda a conformidade com a From 50eb1585c9eb68067bd42322b621ff40b08c3e76 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Mon, 27 Jan 2025 09:30:25 -0300 Subject: [PATCH 006/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Ezzio Moreira --- content/pt/docs/languages/java/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index 1491cd59d66e..7d197329ec8f 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -158,7 +158,7 @@ Para essa correlação funcionar, o contexto de rastreamento precisa ser propaga através da aplicação (entre chamada de funções e threads), e entre fronteiras da aplicação. O [context API](../api/#context-api) facilita isso. -Instrumentação precisa ser escrita de uma maneira que seja reconhedida pelo +Instrumentação precisa ser escrita de uma maneira que seja reconhecida pelo contexto: - Bibliotecas que representam um ponto de entrada da aplicação (i.e. Servidores From 9b73595944f9f73959efe64815d56b625de741ba Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Mon, 27 Jan 2025 09:30:37 -0300 Subject: [PATCH 007/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Ezzio Moreira --- content/pt/docs/languages/java/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index 7d197329ec8f..e38d402826cb 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -16,7 +16,7 @@ cSpell:ignore: Logback logback A instrumentação registra a telemetria usando a [API](../api/). O [SDK](../sdk/) é a implementação de referência embutida na API, e é -[configurada](../configuration/) para processar e exportar a telemetrira +[configurada](../configuration/) para processar e exportar a telemetria produzida pelas chamadas de instrumentação da API. Esta página discute o ecossistema de instrumentação no OpenTelemetry Java, incluíndo recursos para usuários finais e tópicos relacionados com instrumentação: From 2fe67c59127f9c7d36545098ea2eeaa828fe377b Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Mon, 27 Jan 2025 09:30:47 -0300 Subject: [PATCH 008/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Ezzio Moreira --- content/pt/docs/languages/java/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index e38d402826cb..78340038496e 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -18,7 +18,7 @@ A instrumentação registra a telemetria usando a [API](../api/). O [SDK](../sdk é a implementação de referência embutida na API, e é [configurada](../configuration/) para processar e exportar a telemetria produzida pelas chamadas de instrumentação da API. Esta página discute o -ecossistema de instrumentação no OpenTelemetry Java, incluíndo recursos para +ecossistema de instrumentação no OpenTelemetry Java, incluindo recursos para usuários finais e tópicos relacionados com instrumentação: - [Categorias de instrumentação](#instrumentation-categories): Existem diversas From 577a00b34fcc82d3f1a635136660ce1d95aeac04 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Mon, 27 Jan 2025 09:30:56 -0300 Subject: [PATCH 009/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Ezzio Moreira --- content/pt/docs/languages/java/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index 78340038496e..af211f8874c6 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -70,7 +70,7 @@ instrumentação. O agente do Java é uma forma de [instrumentação automática](/docs/specs/otel/glossary/#automatic-instrumentation) -zero código que manipula dinâmicamente o bytecode da aplicação. +zero código que manipula dinamicamente o bytecode da aplicação. Para uma lista de bibliotecas instrumentadas pelo agente do Java, observe a coluna "Auto-instrumented versions" em From 48e2635af2a9acff1120c99d49eb93658571f89c Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Mon, 27 Jan 2025 09:31:04 -0300 Subject: [PATCH 010/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Ezzio Moreira --- content/pt/docs/languages/java/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index af211f8874c6..25648d04b2a3 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -101,7 +101,7 @@ Library Instrumentation [1]" em ### Instrumentação nativa [Instrumentação nativa](/docs/specs/otel/glossary/#natively-instrumented) é pré -definido diretamente nas bibliotecas ou frameworks. OpenTelemetry encorage os +definido diretamente nas bibliotecas ou frameworks. OpenTelemetry encoraje os autores de bibliotecas para adicionar instrumentação nativa usando a [API](../api/). No longo prazo, nós esperamos que a instrumentação nativa seja o padrão, e veja a instrumentação mantida pelo OpenTelemetry em From 9e34db976ec5ef102654558beda2010ab16b101a Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Mon, 27 Jan 2025 09:31:17 -0300 Subject: [PATCH 011/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Ezzio Moreira --- content/pt/docs/languages/java/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index 25648d04b2a3..5989d69103ed 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -143,7 +143,7 @@ As APIs do OpenTelemetry foram desenhados para complementar, com o todos sendo maior que a soma das partes. Cada signal tem seus pontos fortes , e unidos formam uma visão convincente de uma história de observabilidade. -Importante, os dados de vários sinais são _linkados_ juntos através do contecto +Importante, os dados de vários sinais são lincados juntos através do contexto de rastreamento: - Spans são relacionas com outros spans através do span parent e links, que From e0b31f8223f8efed4bb1c7179816e8b2066c021d Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Mon, 27 Jan 2025 09:31:26 -0300 Subject: [PATCH 012/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Ezzio Moreira --- content/pt/docs/languages/java/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index 5989d69103ed..b3aa35cdc0e0 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -146,7 +146,7 @@ formam uma visão convincente de uma história de observabilidade. Importante, os dados de vários sinais são lincados juntos através do contexto de rastreamento: -- Spans são relacionas com outros spans através do span parent e links, que +- Trecho são relacionas com outros spans através do span parent e links, que registram os contextos de rastreamento dos spans relacionados. - Métricas são relacionadas a spans através de [exemplares](/docs/specs/otel/metrics/data-model/#exemplars), que registram o From 490026b2427ba1ceb02643841a5e6d58df080a09 Mon Sep 17 00:00:00 2001 From: Vinaum8 Date: Mon, 27 Jan 2025 09:35:04 -0300 Subject: [PATCH 013/129] =?UTF-8?q?Aplicado=20tradu=C3=A7=C3=A3o=20de=20sp?= =?UTF-8?q?ans=20para=20trechos.?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- content/pt/docs/languages/java/instrumentation.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index b3aa35cdc0e0..be151a993d51 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -146,12 +146,12 @@ formam uma visão convincente de uma história de observabilidade. Importante, os dados de vários sinais são lincados juntos através do contexto de rastreamento: -- Trecho são relacionas com outros spans através do span parent e links, que - registram os contextos de rastreamento dos spans relacionados. -- Métricas são relacionadas a spans através de +- Trecho são relacionas com outros trechos através do span parent e links, que + registram os contextos de rastreamento dos trechos relacionados. +- Métricas são relacionadas a trechos através de [exemplares](/docs/specs/otel/metrics/data-model/#exemplars), que registram o contexto de rastreamento de uma medição específica. -- Logs são relacionados a spans ao registrar o contexto de rastreamento nos +- Logs são relacionados a trechos ao registrar o contexto de rastreamento nos registros de logs. Para essa correlação funcionar, o contexto de rastreamento precisa ser propagado @@ -175,7 +175,7 @@ contexto: A [Convenção semântica](/docs/specs/semconv/) define como produzir telemetria para os padrões de operação. Entre outras coisas, a convenção semântica -especifica nomes de spans, tipos de sans, métricas instrumentadas, unidades de +especifica nomes de trechos, tipos de sans, métricas instrumentadas, unidades de métricas, tipos de métricas, e atributos chave, valor, e níveis de requisitos. Ao escrever instrumentação, consulte a convenção semântica e confirme que From 6e82c7d3571be1158ce3d2c0d5a715f8349ef501 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Mon, 27 Jan 2025 21:07:59 -0300 Subject: [PATCH 014/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Vitor Vasconcellos --- content/pt/docs/languages/java/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index be151a993d51..445caff033a2 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -43,7 +43,7 @@ uma grande variedade de bibliotecas. {{% /alert %}} Existem diversas categorias de instrumentação: -- [Zero-code: Agente Java](#zero-code-java-agent) é uma forma de instrumentação +- [Sem código: Agente Java](#zero-code-java-agent) é uma forma de instrumentação sem código **[1]** que manipula dinamicamente o bytecode da aplicação. - [Zero-code: Spring Boot starter](#zero-code-spring-boot-starter) é uma forma de instrumentação sem código **[1]** que utiliza a autoconfiguração do spring From 85b2a0d7fef6d81608e6cf21dc1645568df196c3 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Mon, 27 Jan 2025 21:08:15 -0300 Subject: [PATCH 015/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Vitor Vasconcellos --- content/pt/docs/languages/java/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index 445caff033a2..ea3186201c88 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -45,7 +45,7 @@ Existem diversas categorias de instrumentação: - [Sem código: Agente Java](#zero-code-java-agent) é uma forma de instrumentação sem código **[1]** que manipula dinamicamente o bytecode da aplicação. -- [Zero-code: Spring Boot starter](#zero-code-spring-boot-starter) é uma forma +- [Sem código: Spring Boot starter](#zero-code-spring-boot-starter) é uma forma de instrumentação sem código **[1]** que utiliza a autoconfiguração do spring para instalar [biblioteca de instrumentação](#library-instrumentation). - [Biblioteca de instrumentação](#library-instrumentation) envolve ou utiliza From e3746d9be30ab5dcde7a8c996a96c228d5e97621 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Mon, 27 Jan 2025 21:08:40 -0300 Subject: [PATCH 016/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Vitor Vasconcellos --- content/pt/docs/languages/java/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index ea3186201c88..c91cf4e4d3d7 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -230,7 +230,7 @@ para demonstração de uma variedade de cenários. ### Via arquivo ou stdout -No fluxo de trabalho arquivo ou stdout, logs são escritos para arquivos ou saída +No fluxo de trabalho utilizado em arquivos ou _stdout_, os logs são gravados em arquivos ou na saída _standout_. Outro componente (e.g. FluentBit) é responsável por ler os logs, interpretar para um formato estruturado, e encaminhar para um destino, como um coletor. Este fluxo de trabalho pode ser preferido em situações onde os From f5978e61b2c4f8edf95e51417d530de31a6a8f35 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Mon, 27 Jan 2025 21:09:01 -0300 Subject: [PATCH 017/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Vitor Vasconcellos --- content/pt/docs/languages/java/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index c91cf4e4d3d7..8207da643ef6 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -63,7 +63,7 @@ bibliotecas e frameworks detectados. O projeto [opentelemetry-java-instrumentation](https://github.com/open-telemetry/opentelemetry-java-instrumentation) -contém o código fonte do Agente Java, inicializar Spring Boot, e Biblioteca de +contém o código fonte do Agente Java, inicializador Spring Boot, e Biblioteca de instrumentação. ### Zero-code: Agente Java From 39cb9ec817a0688e98c5103bf1ba6a91f459f57b Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Mon, 27 Jan 2025 21:09:15 -0300 Subject: [PATCH 018/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Vitor Vasconcellos --- content/pt/docs/languages/java/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index 8207da643ef6..303ac03878a9 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -66,7 +66,7 @@ O projeto contém o código fonte do Agente Java, inicializador Spring Boot, e Biblioteca de instrumentação. -### Zero-code: Agente Java +### Sem código: Agente Java O agente do Java é uma forma de [instrumentação automática](/docs/specs/otel/glossary/#automatic-instrumentation) From 6b221636350007e9ed2dae2e53e96355812c0517 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Mon, 27 Jan 2025 21:09:37 -0300 Subject: [PATCH 019/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Vitor Vasconcellos --- content/pt/docs/languages/java/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index 303ac03878a9..831dc066e9cf 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -231,7 +231,7 @@ para demonstração de uma variedade de cenários. ### Via arquivo ou stdout No fluxo de trabalho utilizado em arquivos ou _stdout_, os logs são gravados em arquivos ou na saída -_standout_. Outro componente (e.g. FluentBit) é responsável por ler os logs, +_standout_. Outro componente (ex. FluentBit) é responsável por ler / acompanhar os logs, interpretar para um formato estruturado, e encaminhar para um destino, como um coletor. Este fluxo de trabalho pode ser preferido em situações onde os requisitos da aplicação não permitem sobrecarga adicional da abordagem From 3644a6eb8ca336f26013beffde305d89485e129b Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Mon, 27 Jan 2025 21:10:10 -0300 Subject: [PATCH 020/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Vitor Vasconcellos --- content/pt/docs/languages/java/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index 831dc066e9cf..88f4b2d44fe2 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -232,7 +232,7 @@ para demonstração de uma variedade de cenários. No fluxo de trabalho utilizado em arquivos ou _stdout_, os logs são gravados em arquivos ou na saída _standout_. Outro componente (ex. FluentBit) é responsável por ler / acompanhar os logs, -interpretar para um formato estruturado, e encaminhar para um destino, como um +convertê-los para um formato mais estruturado, e encaminhá-los para um destino, como um coletor. Este fluxo de trabalho pode ser preferido em situações onde os requisitos da aplicação não permitem sobrecarga adicional da abordagem [direto para o coletor](#direct-to-collector). No entanto, isso requer que todos From a8a6f7430f305df69ba95c78d764d820ece514d3 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Mon, 27 Jan 2025 21:11:28 -0300 Subject: [PATCH 021/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Marylia Gutierrez --- content/pt/docs/languages/java/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index 88f4b2d44fe2..2c76109bd766 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -19,7 +19,7 @@ A instrumentação registra a telemetria usando a [API](../api/). O [SDK](../sdk [configurada](../configuration/) para processar e exportar a telemetria produzida pelas chamadas de instrumentação da API. Esta página discute o ecossistema de instrumentação no OpenTelemetry Java, incluindo recursos para -usuários finais e tópicos relacionados com instrumentação: +usuários finais e tópicos relacionados à instrumentação: - [Categorias de instrumentação](#instrumentation-categories): Existem diversas categorias de instrumentação para cada tipo de caso de uso e para cada padrão From 251121b0d76ccd0ff5f3b03ac762b194734226fd Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Mon, 27 Jan 2025 21:11:45 -0300 Subject: [PATCH 022/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Marylia Gutierrez --- content/pt/docs/languages/java/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index 2c76109bd766..65984d494fbd 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -22,7 +22,7 @@ ecossistema de instrumentação no OpenTelemetry Java, incluindo recursos para usuários finais e tópicos relacionados à instrumentação: - [Categorias de instrumentação](#instrumentation-categories): Existem diversas - categorias de instrumentação para cada tipo de caso de uso e para cada padrão + categorias de instrumentação para diferentes casos de uso e padrões de instalação. de instalação. - [Propagação de Contexto](#context-propagation): Propagação de Contexto provê uma correlação entre rastros, métricas, e logs, permitindo que os sinais From 1d067f40b73b77d1388adea07c45e5b64ea15218 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Mon, 27 Jan 2025 21:12:47 -0300 Subject: [PATCH 023/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Marylia Gutierrez --- content/pt/docs/languages/java/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index 65984d494fbd..191884a028cc 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -26,7 +26,7 @@ usuários finais e tópicos relacionados à instrumentação: de instalação. - [Propagação de Contexto](#context-propagation): Propagação de Contexto provê uma correlação entre rastros, métricas, e logs, permitindo que os sinais - complementem cada um deles. + se complementem. - [Convenção semântica](#semantic-conventions): A Convenção semântica define como produzir telemetria para operações padronizadas. - [Log instrumentation](#log-instrumentation): A Convenção semântica define como From e299fe43b6481e477662bb7f5d04c6d23ea24286 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Mon, 27 Jan 2025 21:13:20 -0300 Subject: [PATCH 024/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Marylia Gutierrez --- content/pt/docs/languages/java/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index 191884a028cc..a76f5b4b06fc 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -36,7 +36,7 @@ usuários finais e tópicos relacionados à instrumentação: [categorias de instrumentação](#instrumentation-categories) mostram diversas opções para instrumentar uma aplicação, nós recomendamos que os usuários iniciem com a página [Agente Java](#zero-code-java-agent). O agente do Java possui uma -instalação simples, e automaticamente instala e detecta a instrumentação para +instalação simples, e automaticamente detecta e instala instrumentação de uma grande variedade de bibliotecas. {{% /alert %}} ## Categorias de instrumentação From aab7d2cf36dddc71b9aa74ab7c0674108b3c8749 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Mon, 27 Jan 2025 21:13:44 -0300 Subject: [PATCH 025/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Marylia Gutierrez --- content/pt/docs/languages/java/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index a76f5b4b06fc..0ad7ec8ceb32 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -27,7 +27,7 @@ usuários finais e tópicos relacionados à instrumentação: - [Propagação de Contexto](#context-propagation): Propagação de Contexto provê uma correlação entre rastros, métricas, e logs, permitindo que os sinais se complementem. -- [Convenção semântica](#semantic-conventions): A Convenção semântica define +- [Convenções semânticas](#semantic-conventions): As convenções semânticas definem como produzir telemetria para operações padronizadas. - [Log instrumentation](#log-instrumentation): A Convenção semântica define como produzir telemetria para operações padronizadas. From cb481e789354ae879b38a860c1059cd0bf4d14f1 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Mon, 27 Jan 2025 21:17:00 -0300 Subject: [PATCH 026/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Marylia Gutierrez --- content/pt/docs/languages/java/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index 0ad7ec8ceb32..3131db38c268 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -28,7 +28,7 @@ usuários finais e tópicos relacionados à instrumentação: uma correlação entre rastros, métricas, e logs, permitindo que os sinais se complementem. - [Convenções semânticas](#semantic-conventions): As convenções semânticas definem - como produzir telemetria para operações padronizadas. + como produzir telemetria para operações padrão. - [Log instrumentation](#log-instrumentation): A Convenção semântica define como produzir telemetria para operações padronizadas. From 050f6de8a4eaac7fc9d8b73cb4ad5745cb190a42 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Mon, 27 Jan 2025 21:19:30 -0300 Subject: [PATCH 027/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Marylia Gutierrez --- content/pt/docs/languages/java/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index 3131db38c268..c384fefa0020 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -32,7 +32,7 @@ usuários finais e tópicos relacionados à instrumentação: - [Log instrumentation](#log-instrumentation): A Convenção semântica define como produzir telemetria para operações padronizadas. -{{% alert %}} Enquanto +{{% alert %}} Embora as [categorias de instrumentação](#instrumentation-categories) mostram diversas opções para instrumentar uma aplicação, nós recomendamos que os usuários iniciem com a página [Agente Java](#zero-code-java-agent). O agente do Java possui uma From e2e041cb63335b71ee723600bfb5b3f294856fac Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Mon, 27 Jan 2025 21:19:42 -0300 Subject: [PATCH 028/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Marylia Gutierrez --- content/pt/docs/languages/java/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index c384fefa0020..a5c015980c75 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -33,7 +33,7 @@ usuários finais e tópicos relacionados à instrumentação: produzir telemetria para operações padronizadas. {{% alert %}} Embora as -[categorias de instrumentação](#instrumentation-categories) mostram diversas +[categorias de instrumentação](#instrumentation-categories) enumerem diversas opções para instrumentar uma aplicação, nós recomendamos que os usuários iniciem com a página [Agente Java](#zero-code-java-agent). O agente do Java possui uma instalação simples, e automaticamente detecta e instala instrumentação de From d15906c415e06ee841c863bfa20ac398fb85a6b8 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Mon, 27 Jan 2025 21:20:12 -0300 Subject: [PATCH 029/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Marylia Gutierrez --- content/pt/docs/languages/java/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index a5c015980c75..91e5ad9ea892 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -35,7 +35,7 @@ usuários finais e tópicos relacionados à instrumentação: {{% alert %}} Embora as [categorias de instrumentação](#instrumentation-categories) enumerem diversas opções para instrumentar uma aplicação, nós recomendamos que os usuários iniciem -com a página [Agente Java](#zero-code-java-agent). O agente do Java possui uma +com o [Agente Java](#zero-code-java-agent). O agente Java possui uma instalação simples, e automaticamente detecta e instala instrumentação de uma grande variedade de bibliotecas. {{% /alert %}} From d9cbaf6a349ec774010fb250dab7f4d81cebffb1 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Mon, 27 Jan 2025 21:20:38 -0300 Subject: [PATCH 030/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Marylia Gutierrez --- content/pt/docs/languages/java/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index 91e5ad9ea892..570af938b465 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -37,7 +37,7 @@ usuários finais e tópicos relacionados à instrumentação: opções para instrumentar uma aplicação, nós recomendamos que os usuários iniciem com o [Agente Java](#zero-code-java-agent). O agente Java possui uma instalação simples, e automaticamente detecta e instala instrumentação de -uma grande variedade de bibliotecas. {{% /alert %}} +uma vasta biblioteca. {{% /alert %}} ## Categorias de instrumentação From cdc9de78bb1c13f973c6c61197bdf2c8873a0534 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Mon, 27 Jan 2025 21:21:11 -0300 Subject: [PATCH 031/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Vitor Vasconcellos --- content/pt/docs/languages/java/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index 570af938b465..cce6c76444a9 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -39,7 +39,7 @@ com o [Agente Java](#zero-code-java-agent). O agente Java possui uma instalação simples, e automaticamente detecta e instala instrumentação de uma vasta biblioteca. {{% /alert %}} -## Categorias de instrumentação +## Categorias de instrumentação {#instrumentation-categories} Existem diversas categorias de instrumentação: From 72d9f20f5e0c1f3ae1a7068045b214214330636d Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Mon, 27 Jan 2025 21:21:37 -0300 Subject: [PATCH 032/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Marylia Gutierrez --- content/pt/docs/languages/java/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index cce6c76444a9..1da9b29c6c99 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -44,7 +44,7 @@ uma vasta biblioteca. {{% /alert %}} Existem diversas categorias de instrumentação: - [Sem código: Agente Java](#zero-code-java-agent) é uma forma de instrumentação - sem código **[1]** que manipula dinamicamente o bytecode da aplicação. + sem código **[1]** que manipula dinamicamente o _bytecode_ da aplicação. - [Sem código: Spring Boot starter](#zero-code-spring-boot-starter) é uma forma de instrumentação sem código **[1]** que utiliza a autoconfiguração do spring para instalar [biblioteca de instrumentação](#library-instrumentation). From 1fe8a62645fd77891b90544edc8206bad949f34d Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Mon, 27 Jan 2025 21:24:01 -0300 Subject: [PATCH 033/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Vitor Vasconcellos --- content/pt/docs/languages/java/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index 1da9b29c6c99..bef792f03073 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -196,7 +196,7 @@ APIs são estruturalmente similares ou equivalentes para diferentes casos de uso. A partir de agora, `LoggerProvider` / `Logger` e as classes associadas representam o [Log Bridge API](/docs/specs/otel/logs/api/), que existe para escrever -aplicadores de logs para conectar logs registrados através de outras APIs de log +conectores de logs para conectar logs registrados através de outras APIs de log / frameworks no OpenTelemetry. Eles não são destinados para usuários finais como um substituto para Log4j / SLF4J / Logback / etc. From df2550d83dd12f218da41beebd04b2ae8fc5aef3 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Mon, 27 Jan 2025 21:24:28 -0300 Subject: [PATCH 034/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Marylia Gutierrez --- content/pt/docs/languages/java/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index bef792f03073..9c891db123ce 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -70,7 +70,7 @@ instrumentação. O agente do Java é uma forma de [instrumentação automática](/docs/specs/otel/glossary/#automatic-instrumentation) -zero código que manipula dinamicamente o bytecode da aplicação. +zero código que manipula dinamicamente o _bytecode_ da aplicação. Para uma lista de bibliotecas instrumentadas pelo agente do Java, observe a coluna "Auto-instrumented versions" em From 1a5c2c5b7976ff1e009fdedd1453aeb54645c087 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Mon, 27 Jan 2025 21:25:32 -0300 Subject: [PATCH 035/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Marylia Gutierrez --- content/pt/docs/languages/java/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index 9c891db123ce..61a66fe1f5c1 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -72,7 +72,7 @@ O agente do Java é uma forma de [instrumentação automática](/docs/specs/otel/glossary/#automatic-instrumentation) zero código que manipula dinamicamente o _bytecode_ da aplicação. -Para uma lista de bibliotecas instrumentadas pelo agente do Java, observe a +Para uma lista de bibliotecas instrumentadas pelo agente do Java, confira a coluna "Auto-instrumented versions" em [bibliotecas suportadas](https://github.com/open-telemetry/opentelemetry-java-instrumentation/blob/main/docs/supported-libraries.md). From 597ea891da37ec1e0328a71a140908b43a99af24 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Mon, 27 Jan 2025 21:26:50 -0300 Subject: [PATCH 036/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Marylia Gutierrez --- content/pt/docs/languages/java/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index 61a66fe1f5c1..1db11a2eb4e3 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -73,7 +73,7 @@ O agente do Java é uma forma de zero código que manipula dinamicamente o _bytecode_ da aplicação. Para uma lista de bibliotecas instrumentadas pelo agente do Java, confira a -coluna "Auto-instrumented versions" em +coluna _"Auto-instrumented versions"_ (versões auto-instrumentadas) em [bibliotecas suportadas](https://github.com/open-telemetry/opentelemetry-java-instrumentation/blob/main/docs/supported-libraries.md). Veja [Agente Java](/docs/zero-code/java/agent/) para mais detalhes. From 4f5cdfea8c68eed5ba4247ccb221908aba0d2722 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Mon, 27 Jan 2025 21:28:07 -0300 Subject: [PATCH 037/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Vitor Vasconcellos --- content/pt/docs/languages/java/instrumentation.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index 1db11a2eb4e3..bad70fb8e0b9 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -80,12 +80,12 @@ Veja [Agente Java](/docs/zero-code/java/agent/) para mais detalhes. ### Zero-code: Spring Boot starter -O Spring Boot starter é uma forma de +O inicializador Spring Boot é uma forma de [instrumentação automática](/docs/specs/otel/glossary/#automatic-instrumentation) zero código que aproveita a autoconfiguração do spring para instalar a [biblioteca de instrumentação](#library-instrumentation). -Veja [Spring Boot starter](/docs/zero-code/java/spring-boot-starter/) para +Veja [inicializador Spring Boot](/docs/zero-code/java/spring-boot-starter/) para detalhes. ### Biblioteca de instrumentação From 3265b4b4e9931bba8786c4c672d71decf5e5016d Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Mon, 27 Jan 2025 21:30:20 -0300 Subject: [PATCH 038/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Vitor Vasconcellos --- content/pt/docs/languages/java/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index bad70fb8e0b9..65e889420a99 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -88,7 +88,7 @@ zero código que aproveita a autoconfiguração do spring para instalar a Veja [inicializador Spring Boot](/docs/zero-code/java/spring-boot-starter/) para detalhes. -### Biblioteca de instrumentação +### Biblioteca de instrumentação {#library-instrumentation} [Biblioteca de instrumentação](/docs/specs/otel/glossary/#instrumentation-library) envolve ou usa os pontos de extensão para instrumentar a biblioteca,obrigando os From f942c5ea9728580cd3d041054cca8cb4e57d1811 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Mon, 27 Jan 2025 21:33:00 -0300 Subject: [PATCH 039/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Vitor Vasconcellos --- content/pt/docs/languages/java/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index 65e889420a99..c08cce595bc8 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -91,7 +91,7 @@ detalhes. ### Biblioteca de instrumentação {#library-instrumentation} [Biblioteca de instrumentação](/docs/specs/otel/glossary/#instrumentation-library) -envolve ou usa os pontos de extensão para instrumentar a biblioteca,obrigando os +envolve ou usa os pontos de extensão para instrumentar a biblioteca, obrigando os usuários a instalar e/ou adaptar o uso da biblioteca. Para uma lista de instrumentação de bibliotecas, veja a coluna "Standalone From da58df7352922096ead0f51d7d0b7863a9f201f6 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Mon, 27 Jan 2025 21:34:12 -0300 Subject: [PATCH 040/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Vitor Vasconcellos --- content/pt/docs/languages/java/instrumentation.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index c08cce595bc8..ae075ba42581 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -139,9 +139,9 @@ Shims mantidos no ecossistema OpenTelemetry Java: ## Propagação de Contexto -As APIs do OpenTelemetry foram desenhados para complementar, com o todos sendo -maior que a soma das partes. Cada signal tem seus pontos fortes , e unidos -formam uma visão convincente de uma história de observabilidade. +As APIs do OpenTelemetry foram desenhadas para serem complementares, onde o todo +é maior que a soma das partes. Cada sinal tem seus pontos fortes e, juntos +formam uma narrativa convincente de observabilidade. Importante, os dados de vários sinais são lincados juntos através do contexto de rastreamento: From 3d188409438616190d68b6721b898b8eb26b7f7a Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Mon, 27 Jan 2025 21:35:05 -0300 Subject: [PATCH 041/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Marylia Gutierrez --- content/pt/docs/languages/java/instrumentation.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index ae075ba42581..d4a691bb40b3 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -94,8 +94,8 @@ detalhes. envolve ou usa os pontos de extensão para instrumentar a biblioteca, obrigando os usuários a instalar e/ou adaptar o uso da biblioteca. -Para uma lista de instrumentação de bibliotecas, veja a coluna "Standalone -Library Instrumentation [1]" em +Para uma lista de bibliotecas de instrumentação, veja a coluna _"Standalone +Library Instrumentation [1]"_ (Biblioteca autônoma de instrumentação) em [bibliotecas suportadas](https://github.com/open-telemetry/opentelemetry-java-instrumentation/blob/main/docs/supported-libraries.md). ### Instrumentação nativa From 42f86b4ae4638874cfdd6091ec3bd4252be0a3d7 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Mon, 27 Jan 2025 21:37:32 -0300 Subject: [PATCH 042/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Marylia Gutierrez --- content/pt/docs/languages/java/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index d4a691bb40b3..1125d3ae10cd 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -104,7 +104,7 @@ Library Instrumentation [1]"_ (Biblioteca autônoma de instrumentação) em definido diretamente nas bibliotecas ou frameworks. OpenTelemetry encoraje os autores de bibliotecas para adicionar instrumentação nativa usando a [API](../api/). No longo prazo, nós esperamos que a instrumentação nativa seja o -padrão, e veja a instrumentação mantida pelo OpenTelemetry em +padrão, e que a instrumentação mantida pelo OpenTelemetry em [opentelemetry-java-instrumentação](https://github.com/open-telemetry/opentelemetry-java-instrumentation) como um meio temporário de preencher a lacuna. From e17a192b0c168db40aafc55c8a2308501429abbf Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Mon, 27 Jan 2025 21:38:01 -0300 Subject: [PATCH 043/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Marylia Gutierrez --- content/pt/docs/languages/java/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index 1125d3ae10cd..9493e1187327 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -137,7 +137,7 @@ Shims mantidos no ecossistema OpenTelemetry Java: | Bridge OpenTelemetry context no [Log4j](https://logging.apache.org/log4j/2.x/index.html) | [LEIA-ME](https://github.com/open-telemetry/opentelemetry-java-instrumentation/tree/main/instrumentation/log4j/log4j-context-data/log4j-context-data-2.17/library-autoconfigure) | Context | `io.opentelemetry.instrumentation:opentelemetry-log4j-context-data-2.17-autoconfigure:{{% param vers.instrumentation %}}-alpha` | | Bridge OpenTelemetry context no [Logback](https://logback.qos.ch/) | [LEIA-ME](https://github.com/open-telemetry/opentelemetry-java-instrumentation/tree/main/instrumentation/logback/logback-mdc-1.0/library) | Context | `io.opentelemetry.instrumentation:opentelemetry-logback-mdc-1.0:{{% param vers.instrumentation %}}-alpha` | -## Propagação de Contexto +## Propagação de Contexto {#context-propagation} As APIs do OpenTelemetry foram desenhadas para serem complementares, onde o todo é maior que a soma das partes. Cada sinal tem seus pontos fortes e, juntos From fc0b96a0796dfa69dde3050c0ae8a0dc5c9c8886 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Mon, 27 Jan 2025 21:40:08 -0300 Subject: [PATCH 044/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Vitor Vasconcellos --- content/pt/docs/languages/java/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index 9493e1187327..03c3899ed50a 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -155,7 +155,7 @@ de rastreamento: registros de logs. Para essa correlação funcionar, o contexto de rastreamento precisa ser propagado -através da aplicação (entre chamada de funções e threads), e entre fronteiras da +através da aplicação (entre chamada de funções e processos), e entre limites da aplicação. O [context API](../api/#context-api) facilita isso. Instrumentação precisa ser escrita de uma maneira que seja reconhecida pelo From 9e7275cac3a0fce544303689677b0a66f8627761 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Mon, 27 Jan 2025 21:42:37 -0300 Subject: [PATCH 045/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Vitor Vasconcellos --- content/pt/docs/languages/java/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index 03c3899ed50a..0ca2aeb5b38b 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -110,7 +110,7 @@ como um meio temporário de preencher a lacuna. {{% docs/languages/native-libraries "java" %}} -### Instrumentação manual +### Instrumentação manual {#manual-instrumentation} [Instrumentação manual](/docs/specs/otel/glossary/#manual-instrumentation) é escrito pelos autores das aplicações, e normalmente específico para o domínio da From 2f82d79f3ad7db60322b9a19c7bc7f0687f248f2 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Mon, 27 Jan 2025 21:44:20 -0300 Subject: [PATCH 046/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Vitor Vasconcellos --- content/pt/docs/languages/java/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index 0ca2aeb5b38b..9206a663144a 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -101,7 +101,7 @@ Library Instrumentation [1]"_ (Biblioteca autônoma de instrumentação) em ### Instrumentação nativa [Instrumentação nativa](/docs/specs/otel/glossary/#natively-instrumented) é pré -definido diretamente nas bibliotecas ou frameworks. OpenTelemetry encoraje os +definido diretamente nas bibliotecas ou _frameworks_. O OpenTelemetry encoraja os autores de bibliotecas para adicionar instrumentação nativa usando a [API](../api/). No longo prazo, nós esperamos que a instrumentação nativa seja o padrão, e que a instrumentação mantida pelo OpenTelemetry em From bb64c265a30b6fb07a5db9de64387297b768b5ea Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Mon, 27 Jan 2025 21:46:44 -0300 Subject: [PATCH 047/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Vitor Vasconcellos --- content/pt/docs/languages/java/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index 9206a663144a..44d75e8e2f3a 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -156,7 +156,7 @@ de rastreamento: Para essa correlação funcionar, o contexto de rastreamento precisa ser propagado através da aplicação (entre chamada de funções e processos), e entre limites da -aplicação. O [context API](../api/#context-api) facilita isso. +aplicação. A [API de contexto](../api/#context-api) facilita isso. Instrumentação precisa ser escrita de uma maneira que seja reconhecida pelo contexto: From 80ec1140658635d2a436ce64193464409d18123f Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Mon, 27 Jan 2025 21:46:56 -0300 Subject: [PATCH 048/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Vitor Vasconcellos --- content/pt/docs/languages/java/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index 44d75e8e2f3a..8b0766465eb5 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -98,7 +98,7 @@ Para uma lista de bibliotecas de instrumentação, veja a coluna _"Standalone Library Instrumentation [1]"_ (Biblioteca autônoma de instrumentação) em [bibliotecas suportadas](https://github.com/open-telemetry/opentelemetry-java-instrumentation/blob/main/docs/supported-libraries.md). -### Instrumentação nativa +### Instrumentação nativa {#native-instrumentation} [Instrumentação nativa](/docs/specs/otel/glossary/#natively-instrumented) é pré definido diretamente nas bibliotecas ou _frameworks_. O OpenTelemetry encoraja os From bad56a89137540b3cf8af923e40fa24a183ad8be Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Mon, 27 Jan 2025 21:47:26 -0300 Subject: [PATCH 049/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Vitor Vasconcellos --- content/pt/docs/languages/java/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index 8b0766465eb5..1652c1260c91 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -175,7 +175,7 @@ contexto: A [Convenção semântica](/docs/specs/semconv/) define como produzir telemetria para os padrões de operação. Entre outras coisas, a convenção semântica -especifica nomes de trechos, tipos de sans, métricas instrumentadas, unidades de +especifica nomes e tipos de trechos, instrumentos de métrica, unidades de métricas, tipos de métricas, e atributos chave, valor, e níveis de requisitos. Ao escrever instrumentação, consulte a convenção semântica e confirme que From dc46a6d3de67008f8fa162768a203ba1c1f4b65b Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Mon, 27 Jan 2025 21:48:03 -0300 Subject: [PATCH 050/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Vitor Vasconcellos --- content/pt/docs/languages/java/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index 1652c1260c91..1859f482c551 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -206,7 +206,7 @@ OpenTelemetry atendendo a diferentes requisitos de aplicação: ### Direto para o Coletor No fluxo de trabalho direto para o coletor, logs são emitidos diretamente da -aplicação para o coletor usando um protocolo de rede (e.g. OTLP). Este fluxo de +aplicação para o coletor usando um protocolo de rede (ex. OTLP). Este fluxo de trabalho é simples para configurar e não requer nenhum componente de encaminhamento de log adicional, e permite que uma facilmente emita logs estruturados em conformidade com o From 888a91354c478f599509da8199f21fa117a400f2 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Mon, 27 Jan 2025 21:48:26 -0300 Subject: [PATCH 051/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Marylia Gutierrez --- content/pt/docs/languages/java/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index 1859f482c551..00cd1169aa9c 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -106,7 +106,7 @@ autores de bibliotecas para adicionar instrumentação nativa usando a [API](../api/). No longo prazo, nós esperamos que a instrumentação nativa seja o padrão, e que a instrumentação mantida pelo OpenTelemetry em [opentelemetry-java-instrumentação](https://github.com/open-telemetry/opentelemetry-java-instrumentation) -como um meio temporário de preencher a lacuna. +seja um meio temporário de preencher a lacuna. {{% docs/languages/native-libraries "java" %}} From 5b95a29290c05dacfc8a4e96efec689c8ae7c99a Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Mon, 27 Jan 2025 21:48:44 -0300 Subject: [PATCH 052/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Vitor Vasconcellos --- content/pt/docs/languages/java/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index 00cd1169aa9c..3193765e2f48 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -158,7 +158,7 @@ Para essa correlação funcionar, o contexto de rastreamento precisa ser propaga através da aplicação (entre chamada de funções e processos), e entre limites da aplicação. A [API de contexto](../api/#context-api) facilita isso. -Instrumentação precisa ser escrita de uma maneira que seja reconhecida pelo +A instrumentação deve ser escrita de uma maneira que seja reconhecida pelo contexto: - Bibliotecas que representam um ponto de entrada da aplicação (i.e. Servidores From 7832b811029301da7a771ff1c308c96c5753c9e0 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Mon, 27 Jan 2025 21:49:18 -0300 Subject: [PATCH 053/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Vitor Vasconcellos --- content/pt/docs/languages/java/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index 3193765e2f48..1ceb9de2ea78 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -212,7 +212,7 @@ encaminhamento de log adicional, e permite que uma facilmente emita logs estruturados em conformidade com o [modelo de dados de log](/docs/specs/otel/logs/data-model/). No entanto, a sobrecarga necessária para as aplicações enfileirarem e exportarem os logs para -um local rede pode não ser adequada para todas os aplicativos. +um local de rede pode não ser adequada para todas as aplicações. Para usar este fluxo de trabalho: From 01f1b59269668938003396d5df6d582d88ff8c5e Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Mon, 27 Jan 2025 21:49:45 -0300 Subject: [PATCH 054/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Vitor Vasconcellos --- content/pt/docs/languages/java/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index 1ceb9de2ea78..e8ede98603bf 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -191,7 +191,7 @@ convenção semântica. ## Instrumentação de Log Enquanto o [LoggerProvider](../api/#loggerprovider) / [Logger](../api/#logger) -APIs são estruturalmente similares ou equivalentes + são estruturalmente similares ou equivalentes [trace](../api/#tracerprovider) e [métricas](../api/#meterprovider) APIs, servem para diferentes casos de uso. A partir de agora, `LoggerProvider` / `Logger` e as classes associadas representam o From 41a00d9c08f740b93f1923e4f8329e691b642698 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Mon, 27 Jan 2025 21:50:01 -0300 Subject: [PATCH 055/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Vitor Vasconcellos --- content/pt/docs/languages/java/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index e8ede98603bf..fdc1f2ee5336 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -171,7 +171,7 @@ contexto: [context](../api/#context) através da pilha de chamadas e entre qualquer threads. -## Convenção semântica +## Convenção semântica {#semantic-conventions} A [Convenção semântica](/docs/specs/semconv/) define como produzir telemetria para os padrões de operação. Entre outras coisas, a convenção semântica From c062b007224faebbb35bb5cd0324c9de44cc289e Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Mon, 27 Jan 2025 21:50:29 -0300 Subject: [PATCH 056/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Vitor Vasconcellos --- content/pt/docs/languages/java/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index fdc1f2ee5336..2c171e4fe815 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -168,7 +168,7 @@ contexto: HTTP, Produtores de Mensagens, etc.) devem [injetar o context](../api/#contextpropagators) em mensagens de saída. - Bibliotecas devem passar implicitamente ou explicitamente o - [context](../api/#context) através da pilha de chamadas e entre qualquer + [contexto](../api/#context) através da pilha de chamadas e entre qualquer threads. ## Convenção semântica {#semantic-conventions} From 46d956a6196b35957a17ecf460551c57e6f7ada7 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Mon, 27 Jan 2025 21:53:45 -0300 Subject: [PATCH 057/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Vitor Vasconcellos --- content/pt/docs/languages/java/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index 2c171e4fe815..d42d128be4fc 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -164,7 +164,7 @@ contexto: - Bibliotecas que representam um ponto de entrada da aplicação (i.e. Servidores HTTP, Consumidores de Mensagens, etc.) deve [extrair o context](../api/#contextpropagators) de mensagens recebidas. -- Bibliotecas que representam um ponto de saída de uma aplicação (i.e. Clientes +- Bibliotecas que representam um ponto de saída de uma aplicação (ex. Clientes HTTP, Produtores de Mensagens, etc.) devem [injetar o context](../api/#contextpropagators) em mensagens de saída. - Bibliotecas devem passar implicitamente ou explicitamente o From f35c36a5cfa34a042ec010326722d62dbde76d09 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Mon, 27 Jan 2025 21:54:05 -0300 Subject: [PATCH 058/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Vitor Vasconcellos --- content/pt/docs/languages/java/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index d42d128be4fc..af10b0b4db1b 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -169,7 +169,7 @@ contexto: [injetar o context](../api/#contextpropagators) em mensagens de saída. - Bibliotecas devem passar implicitamente ou explicitamente o [contexto](../api/#context) através da pilha de chamadas e entre qualquer - threads. + processo. ## Convenção semântica {#semantic-conventions} From 12b84856fbf8979c887886d8c4ad0ab07b4195af Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Mon, 27 Jan 2025 21:54:34 -0300 Subject: [PATCH 059/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Marylia Gutierrez --- content/pt/docs/languages/java/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index af10b0b4db1b..48437c35c392 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -113,7 +113,7 @@ seja um meio temporário de preencher a lacuna. ### Instrumentação manual {#manual-instrumentation} [Instrumentação manual](/docs/specs/otel/glossary/#manual-instrumentation) é -escrito pelos autores das aplicações, e normalmente específico para o domínio da +escrita pelos autores das aplicações, e normalmente específica para o domínio da aplicação. ### Shims From a80a9468d2406b807c252f4e34c7e03150215350 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Mon, 27 Jan 2025 21:54:47 -0300 Subject: [PATCH 060/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Vitor Vasconcellos --- content/pt/docs/languages/java/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index 48437c35c392..576d62eca1b4 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -188,7 +188,7 @@ para chaves e valores de atributos. TODO: Discutir instrumentação API e como isso ajuda a conformidade com a convenção semântica. -## Instrumentação de Log +## Instrumentação de Log {#log-instrumentation} Enquanto o [LoggerProvider](../api/#loggerprovider) / [Logger](../api/#logger) são estruturalmente similares ou equivalentes From 9398d7811909cf6325ad00c4d04f944935a275fc Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Mon, 27 Jan 2025 21:55:02 -0300 Subject: [PATCH 061/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Vitor Vasconcellos --- content/pt/docs/languages/java/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index 576d62eca1b4..95ba6ae4f1fe 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -182,7 +182,7 @@ Ao escrever instrumentação, consulte a convenção semântica e confirme que quaisquer convenções aplicáveis ao domínio estejam sendo seguidas. OpenTelemetry Java [publica artefatos](../api/#semantic-attributes) para -auxiliar an conformidade com a convenção semântica, incluindo constantes geradas +auxiliar a conformidade com a convenção semântica, incluindo constantes geradas para chaves e valores de atributos. TODO: Discutir instrumentação API e como isso ajuda a conformidade com a From 46a754622146071b856eecadfd07b23b9b366029 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Mon, 27 Jan 2025 21:55:51 -0300 Subject: [PATCH 062/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Vitor Vasconcellos --- content/pt/docs/languages/java/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index 95ba6ae4f1fe..701e88d9f834 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -190,7 +190,7 @@ convenção semântica. ## Instrumentação de Log {#log-instrumentation} -Enquanto o [LoggerProvider](../api/#loggerprovider) / [Logger](../api/#logger) +Enquanto as APIs do [LoggerProvider](../api/#loggerprovider) / [Logger](../api/#logger) são estruturalmente similares ou equivalentes [trace](../api/#tracerprovider) e [métricas](../api/#meterprovider) APIs, servem para diferentes casos de uso. A partir de agora, `LoggerProvider` / `Logger` e From 2c7cab49b5699823c0e8db59ccd5ec5151b655b8 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Mon, 27 Jan 2025 21:56:02 -0300 Subject: [PATCH 063/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Vitor Vasconcellos --- content/pt/docs/languages/java/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index 701e88d9f834..77ea163a6b5a 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -181,7 +181,7 @@ métricas, tipos de métricas, e atributos chave, valor, e níveis de requisitos Ao escrever instrumentação, consulte a convenção semântica e confirme que quaisquer convenções aplicáveis ao domínio estejam sendo seguidas. -OpenTelemetry Java [publica artefatos](../api/#semantic-attributes) para +O OpenTelemetry Java [publica artefatos](../api/#semantic-attributes) para auxiliar a conformidade com a convenção semântica, incluindo constantes geradas para chaves e valores de atributos. From 3a609e5f6dd843c6b619e86cca4fefe9e37b7a28 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Mon, 27 Jan 2025 21:57:13 -0300 Subject: [PATCH 064/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Vitor Vasconcellos --- content/pt/docs/languages/java/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index 77ea163a6b5a..aa05917ad0f2 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -203,7 +203,7 @@ um substituto para Log4j / SLF4J / Logback / etc. Eles são dois típicos fluxos de trabalho para consumir instrumentação de logs no OpenTelemetry atendendo a diferentes requisitos de aplicação: -### Direto para o Coletor +### Direto para o Collector {#direct-to-collector} No fluxo de trabalho direto para o coletor, logs são emitidos diretamente da aplicação para o coletor usando um protocolo de rede (ex. OTLP). Este fluxo de From d4e04811215100aafc13008c02efbcd5a18c5243 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Mon, 27 Jan 2025 21:57:25 -0300 Subject: [PATCH 065/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Vitor Vasconcellos --- content/pt/docs/languages/java/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index aa05917ad0f2..bebfc853e2dd 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -228,7 +228,7 @@ um framework no OpenTelemetry log SDK. Veja "Bridge Log4j em OpenTelemetry", [Exemplo de aplicadores de Logs](https://github.com/open-telemetry/opentelemetry-java-docs/tree/main/log-appender) para demonstração de uma variedade de cenários. -### Via arquivo ou stdout +### Via arquivo ou stdout {#via-file-or-stdout} No fluxo de trabalho utilizado em arquivos ou _stdout_, os logs são gravados em arquivos ou na saída _standout_. Outro componente (ex. FluentBit) é responsável por ler / acompanhar os logs, From 4ece54426758b35814ef622acbd2794f5c3f98cf Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Mon, 27 Jan 2025 21:57:37 -0300 Subject: [PATCH 066/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Vitor Vasconcellos --- content/pt/docs/languages/java/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index bebfc853e2dd..054ac9f31611 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -219,7 +219,7 @@ Para usar este fluxo de trabalho: - Instale apropriados aplicadores de logs. **[1]** - Configure o OpenTelemetry [Log SDK](../sdk/#sdkloggerprovider) para exportar registros de logs para o destino desejado (o - [coletor](https://github.com/open-telemetry/opentelemetry-collector) ou + [Collector](https://github.com/open-telemetry/opentelemetry-collector) ou outro). **[1]**: Aplicadores de Logs são um tipo de [shim](#shims) que conecta logs de From fab451bd7386b4b54f5669e1e9b61a6ee19a4362 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Mon, 27 Jan 2025 21:57:55 -0300 Subject: [PATCH 067/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Vitor Vasconcellos --- content/pt/docs/languages/java/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index 054ac9f31611..e668018aa4fb 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -205,7 +205,7 @@ OpenTelemetry atendendo a diferentes requisitos de aplicação: ### Direto para o Collector {#direct-to-collector} -No fluxo de trabalho direto para o coletor, logs são emitidos diretamente da +No fluxo de trabalho direto para o collector, logs são emitidos diretamente da aplicação para o coletor usando um protocolo de rede (ex. OTLP). Este fluxo de trabalho é simples para configurar e não requer nenhum componente de encaminhamento de log adicional, e permite que uma facilmente emita logs From 94d295cfb4fc8c715784922e1f6a67d52072c823 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Mon, 27 Jan 2025 21:58:10 -0300 Subject: [PATCH 068/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Vitor Vasconcellos --- content/pt/docs/languages/java/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index e668018aa4fb..ad6425800b36 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -216,7 +216,7 @@ um local de rede pode não ser adequada para todas as aplicações. Para usar este fluxo de trabalho: -- Instale apropriados aplicadores de logs. **[1]** +- Instale o conector de log apropriado. **[1]** - Configure o OpenTelemetry [Log SDK](../sdk/#sdkloggerprovider) para exportar registros de logs para o destino desejado (o [Collector](https://github.com/open-telemetry/opentelemetry-collector) ou From 7c81234e521df85d0b102ebf8ea234f85363192a Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Mon, 27 Jan 2025 21:58:25 -0300 Subject: [PATCH 069/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Vitor Vasconcellos --- content/pt/docs/languages/java/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index ad6425800b36..d62ac2ad3940 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -235,7 +235,7 @@ _standout_. Outro componente (ex. FluentBit) é responsável por ler / acompanha convertê-los para um formato mais estruturado, e encaminhá-los para um destino, como um coletor. Este fluxo de trabalho pode ser preferido em situações onde os requisitos da aplicação não permitem sobrecarga adicional da abordagem -[direto para o coletor](#direct-to-collector). No entanto, isso requer que todos +[direto para o Collector](#direct-to-collector). No entanto, isso requer que todos os campos de logs necessários para processamento posterior sejam codificados em logs, e este componente leia os dados de logs interpretados em [modelo de dados de log](/docs/specs/otel/logs/data-model). A instalação e From de933c329e12d84eb4dbbdbc3cd01c50c930fa46 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Mon, 27 Jan 2025 21:58:45 -0300 Subject: [PATCH 070/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Vitor Vasconcellos --- content/pt/docs/languages/java/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index d62ac2ad3940..bb7f843c7ce0 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -166,7 +166,7 @@ contexto: [extrair o context](../api/#contextpropagators) de mensagens recebidas. - Bibliotecas que representam um ponto de saída de uma aplicação (ex. Clientes HTTP, Produtores de Mensagens, etc.) devem - [injetar o context](../api/#contextpropagators) em mensagens de saída. + [injetar o contexto](../api/#contextpropagators) em mensagens de saída. - Bibliotecas devem passar implicitamente ou explicitamente o [contexto](../api/#context) através da pilha de chamadas e entre qualquer processo. From 0243198cdd18f44b27e99439152fb96d0b17adae Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Mon, 27 Jan 2025 21:59:13 -0300 Subject: [PATCH 071/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Vitor Vasconcellos --- content/pt/docs/languages/java/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index bb7f843c7ce0..5ece8fd6d1f9 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -233,7 +233,7 @@ para demonstração de uma variedade de cenários. No fluxo de trabalho utilizado em arquivos ou _stdout_, os logs são gravados em arquivos ou na saída _standout_. Outro componente (ex. FluentBit) é responsável por ler / acompanhar os logs, convertê-los para um formato mais estruturado, e encaminhá-los para um destino, como um -coletor. Este fluxo de trabalho pode ser preferido em situações onde os +Collector. Este fluxo de trabalho pode ser preferível em situações onde os requisitos da aplicação não permitem sobrecarga adicional da abordagem [direto para o Collector](#direct-to-collector). No entanto, isso requer que todos os campos de logs necessários para processamento posterior sejam codificados em From e778db79c435ba9ac97548cb7e49480b4047cd68 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Mon, 27 Jan 2025 21:59:40 -0300 Subject: [PATCH 072/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Vitor Vasconcellos --- content/pt/docs/languages/java/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index 5ece8fd6d1f9..bc687c7c6014 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -222,7 +222,7 @@ Para usar este fluxo de trabalho: [Collector](https://github.com/open-telemetry/opentelemetry-collector) ou outro). -**[1]**: Aplicadores de Logs são um tipo de [shim](#shims) que conecta logs de +**[1]**: Conectores de Logs são um tipo de [shim](#shims) que conecta logs de um framework no OpenTelemetry log SDK. Veja "Bridge Log4j em OpenTelemetry", "Bridge Logback em OpenTelemetry" entradas. Veja [Exemplo de aplicadores de Logs](https://github.com/open-telemetry/opentelemetry-java-docs/tree/main/log-appender) From 491e4411fb95217b3e0f8ff94d41039faedebe14 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Mon, 27 Jan 2025 22:00:40 -0300 Subject: [PATCH 073/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Vitor Vasconcellos --- content/pt/docs/languages/java/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index bc687c7c6014..90a3dc6eda0e 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -102,7 +102,7 @@ Library Instrumentation [1]"_ (Biblioteca autônoma de instrumentação) em [Instrumentação nativa](/docs/specs/otel/glossary/#natively-instrumented) é pré definido diretamente nas bibliotecas ou _frameworks_. O OpenTelemetry encoraja os -autores de bibliotecas para adicionar instrumentação nativa usando a +autores de bibliotecas a adicionarem instrumentação nativa usando a [API](../api/). No longo prazo, nós esperamos que a instrumentação nativa seja o padrão, e que a instrumentação mantida pelo OpenTelemetry em [opentelemetry-java-instrumentação](https://github.com/open-telemetry/opentelemetry-java-instrumentation) From 621eced84e38db77164fe66da39088ad62a69f6f Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Mon, 27 Jan 2025 22:01:13 -0300 Subject: [PATCH 074/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Marylia Gutierrez --- content/pt/docs/languages/java/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index 90a3dc6eda0e..ef75c279445d 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -100,7 +100,7 @@ Library Instrumentation [1]"_ (Biblioteca autônoma de instrumentação) em ### Instrumentação nativa {#native-instrumentation} -[Instrumentação nativa](/docs/specs/otel/glossary/#natively-instrumented) é pré +[Instrumentação nativa](/docs/specs/otel/glossary/#natively-instrumented) é definido diretamente nas bibliotecas ou _frameworks_. O OpenTelemetry encoraja os autores de bibliotecas a adicionarem instrumentação nativa usando a [API](../api/). No longo prazo, nós esperamos que a instrumentação nativa seja o From b2b3e774b565d2b07d0c3fa660e4b8b538b06410 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Mon, 27 Jan 2025 22:02:30 -0300 Subject: [PATCH 075/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Vitor Vasconcellos --- content/pt/docs/languages/java/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index ef75c279445d..86f641cfcede 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -194,7 +194,7 @@ Enquanto as APIs do [LoggerProvider](../api/#loggerprovider) / [Logger](../api/# são estruturalmente similares ou equivalentes [trace](../api/#tracerprovider) e [métricas](../api/#meterprovider) APIs, servem para diferentes casos de uso. A partir de agora, `LoggerProvider` / `Logger` e -as classes associadas representam o +as classes associadas representam a [Log Bridge API](/docs/specs/otel/logs/api/), que existe para escrever conectores de logs para conectar logs registrados através de outras APIs de log / frameworks no OpenTelemetry. Eles não são destinados para usuários finais como From a206de43abeda01baa7dc0363e79ef8075488015 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Mon, 27 Jan 2025 22:02:48 -0300 Subject: [PATCH 076/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Vitor Vasconcellos --- content/pt/docs/languages/java/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index 86f641cfcede..b0a487548622 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -223,7 +223,7 @@ Para usar este fluxo de trabalho: outro). **[1]**: Conectores de Logs são um tipo de [shim](#shims) que conecta logs de -um framework no OpenTelemetry log SDK. Veja "Bridge Log4j em OpenTelemetry", +um _framework_ na SDK de Logs do OpenTelemetry. Veja "Bridge Log4j em OpenTelemetry", "Bridge Logback em OpenTelemetry" entradas. Veja [Exemplo de aplicadores de Logs](https://github.com/open-telemetry/opentelemetry-java-docs/tree/main/log-appender) para demonstração de uma variedade de cenários. From 57667a1b83523c8c1682e29da9db07685a01bbff Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Tue, 28 Jan 2025 15:27:18 -0300 Subject: [PATCH 077/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Marylia Gutierrez --- content/pt/docs/languages/java/instrumentation.md | 1 - 1 file changed, 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index b0a487548622..7a67eb772e1d 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -23,7 +23,6 @@ usuários finais e tópicos relacionados à instrumentação: - [Categorias de instrumentação](#instrumentation-categories): Existem diversas categorias de instrumentação para diferentes casos de uso e padrões de instalação. - de instalação. - [Propagação de Contexto](#context-propagation): Propagação de Contexto provê uma correlação entre rastros, métricas, e logs, permitindo que os sinais se complementem. From 50cee8a667de2053ebc47abdd7dde61ec1f49f06 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Tue, 28 Jan 2025 17:12:50 -0300 Subject: [PATCH 078/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Vitor Vasconcellos --- content/pt/docs/languages/java/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index 7a67eb772e1d..6b7593e4256b 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -77,7 +77,7 @@ coluna _"Auto-instrumented versions"_ (versões auto-instrumentadas) em Veja [Agente Java](/docs/zero-code/java/agent/) para mais detalhes. -### Zero-code: Spring Boot starter +### Sem código: inicializador Spring Boot O inicializador Spring Boot é uma forma de [instrumentação automática](/docs/specs/otel/glossary/#automatic-instrumentation) From 8b3c5614e5c344cfcbdf792f850c9c60a4e71557 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Tue, 28 Jan 2025 17:14:22 -0300 Subject: [PATCH 079/129] Update instrumentation.md --- content/pt/docs/languages/java/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index 6b7593e4256b..80fd3f139b34 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -145,7 +145,7 @@ formam uma narrativa convincente de observabilidade. Importante, os dados de vários sinais são lincados juntos através do contexto de rastreamento: -- Trecho são relacionas com outros trechos através do span parent e links, que +- Trecho são relacionados com outros trechos através do trecho pai e links, que registram os contextos de rastreamento dos trechos relacionados. - Métricas são relacionadas a trechos através de [exemplares](/docs/specs/otel/metrics/data-model/#exemplars), que registram o From f5626a8aad7b1e453d96edb23a5df86d1ead31ed Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Wed, 29 Jan 2025 09:31:12 -0300 Subject: [PATCH 080/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Marylia Gutierrez --- content/pt/docs/languages/java/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index 80fd3f139b34..f059468feec0 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -139,7 +139,7 @@ Shims mantidos no ecossistema OpenTelemetry Java: ## Propagação de Contexto {#context-propagation} As APIs do OpenTelemetry foram desenhadas para serem complementares, onde o todo -é maior que a soma das partes. Cada sinal tem seus pontos fortes e, juntos +é maior que a soma das partes. Cada sinal tem seus pontos fortes e juntos formam uma narrativa convincente de observabilidade. Importante, os dados de vários sinais são lincados juntos através do contexto From f2100d52ff84dfbbf0cca677a478795012f78913 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Wed, 29 Jan 2025 09:31:31 -0300 Subject: [PATCH 081/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Marylia Gutierrez --- content/pt/docs/languages/java/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index f059468feec0..796d0bcde051 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -142,7 +142,7 @@ As APIs do OpenTelemetry foram desenhadas para serem complementares, onde o todo é maior que a soma das partes. Cada sinal tem seus pontos fortes e juntos formam uma narrativa convincente de observabilidade. -Importante, os dados de vários sinais são lincados juntos através do contexto +É importante ressaltar que os dados de vários sinais são interligados através do contexto de rastreamento: - Trecho são relacionados com outros trechos através do trecho pai e links, que From 517de8fb4204818e23b73c48475a755bb42428b5 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Wed, 29 Jan 2025 09:33:21 -0300 Subject: [PATCH 082/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Marylia Gutierrez --- content/pt/docs/languages/java/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index 796d0bcde051..d73949353130 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -157,7 +157,7 @@ Para essa correlação funcionar, o contexto de rastreamento precisa ser propaga através da aplicação (entre chamada de funções e processos), e entre limites da aplicação. A [API de contexto](../api/#context-api) facilita isso. -A instrumentação deve ser escrita de uma maneira que seja reconhecida pelo +A instrumentação deve ser escrita de uma maneira que seja ciente do contexto: - Bibliotecas que representam um ponto de entrada da aplicação (i.e. Servidores From 94eb3ed35823ff8f96ffe1eb1fe3d07c4dd9dcbc Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Wed, 29 Jan 2025 09:33:33 -0300 Subject: [PATCH 083/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Marylia Gutierrez --- content/pt/docs/languages/java/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index d73949353130..3ef02f9ccba1 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -160,7 +160,7 @@ aplicação. A [API de contexto](../api/#context-api) facilita isso. A instrumentação deve ser escrita de uma maneira que seja ciente do contexto: -- Bibliotecas que representam um ponto de entrada da aplicação (i.e. Servidores +- Bibliotecas que representam um ponto de entrada da aplicação (i.e. servidores HTTP, Consumidores de Mensagens, etc.) deve [extrair o context](../api/#contextpropagators) de mensagens recebidas. - Bibliotecas que representam um ponto de saída de uma aplicação (ex. Clientes From cb0ae7bb1be39c827620e3f7fe37629ac1a41108 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Wed, 29 Jan 2025 09:33:51 -0300 Subject: [PATCH 084/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Marylia Gutierrez --- content/pt/docs/languages/java/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index 3ef02f9ccba1..c4c32a76bc18 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -161,7 +161,7 @@ A instrumentação deve ser escrita de uma maneira que seja ciente do contexto: - Bibliotecas que representam um ponto de entrada da aplicação (i.e. servidores - HTTP, Consumidores de Mensagens, etc.) deve + HTTP, consumidores de mensagens, etc.) devem [extrair o context](../api/#contextpropagators) de mensagens recebidas. - Bibliotecas que representam um ponto de saída de uma aplicação (ex. Clientes HTTP, Produtores de Mensagens, etc.) devem From e1164ef7fc05889a6acc5f628f6f6cfc5eddf70e Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Wed, 29 Jan 2025 09:34:11 -0300 Subject: [PATCH 085/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Marylia Gutierrez --- content/pt/docs/languages/java/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index c4c32a76bc18..2fe78e0894fe 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -236,7 +236,7 @@ Collector. Este fluxo de trabalho pode ser preferível em situações onde os requisitos da aplicação não permitem sobrecarga adicional da abordagem [direto para o Collector](#direct-to-collector). No entanto, isso requer que todos os campos de logs necessários para processamento posterior sejam codificados em -logs, e este componente leia os dados de logs interpretados em +logs, e este componente lendo os logs os interprete no [modelo de dados de log](/docs/specs/otel/logs/data-model). A instalação e configuração dos componentes de encaminhamento de log está fora do escopo deste documento. From 5d9845a4381ae437ea94c09dba8bc3f2792a8f08 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Wed, 29 Jan 2025 09:34:28 -0300 Subject: [PATCH 086/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Marylia Gutierrez --- content/pt/docs/languages/java/instrumentation.md | 1 - 1 file changed, 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index 2fe78e0894fe..373de074d0cd 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -244,4 +244,3 @@ documento. Correlação de Logs com rastros está disponível instalando um [shim](#shims) para conectar o contexto do OpenTelemetry no log framework. Veja "Bridge OpenTelemetry contexto em Log4j", "Bridge OpenTelemetry contexto em Logback" -entradas. From 481636d9ac6c2be01e6796bb374a3c5d121a4e33 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Wed, 29 Jan 2025 09:41:19 -0300 Subject: [PATCH 087/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Marylia Gutierrez --- content/pt/docs/languages/java/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index 373de074d0cd..a8f19286fb30 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -243,4 +243,4 @@ documento. Correlação de Logs com rastros está disponível instalando um [shim](#shims) para conectar o contexto do OpenTelemetry no log framework. Veja "Bridge -OpenTelemetry contexto em Log4j", "Bridge OpenTelemetry contexto em Logback" +OpenTelemetry contexto em Log4j", "Bridge OpenTelemetry contexto em Logback". From b748a4d2c6f75f3756c618fca9f1964a57eb59b3 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Wed, 29 Jan 2025 09:41:29 -0300 Subject: [PATCH 088/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Marylia Gutierrez --- content/pt/docs/languages/java/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index a8f19286fb30..ede01bc3bc8e 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -242,5 +242,5 @@ configuração dos componentes de encaminhamento de log está fora do escopo des documento. Correlação de Logs com rastros está disponível instalando um [shim](#shims) para -conectar o contexto do OpenTelemetry no log framework. Veja "Bridge +conectar o contexto do OpenTelemetry no log framework. Veja os items "Bridge OpenTelemetry contexto em Log4j", "Bridge OpenTelemetry contexto em Logback". From f1022a221121f972b57f818506a7f0564f964989 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Wed, 29 Jan 2025 09:41:42 -0300 Subject: [PATCH 089/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Marylia Gutierrez --- content/pt/docs/languages/java/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index ede01bc3bc8e..b00e68cab835 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -222,7 +222,7 @@ Para usar este fluxo de trabalho: outro). **[1]**: Conectores de Logs são um tipo de [shim](#shims) que conecta logs de -um _framework_ na SDK de Logs do OpenTelemetry. Veja "Bridge Log4j em OpenTelemetry", +um _framework_ na SDK de Logs do OpenTelemetry. Veja os items "Bridge Log4j em OpenTelemetry", "Bridge Logback em OpenTelemetry" entradas. Veja [Exemplo de aplicadores de Logs](https://github.com/open-telemetry/opentelemetry-java-docs/tree/main/log-appender) para demonstração de uma variedade de cenários. From c9f18b480c23328afc044928048e84179e78240b Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Wed, 29 Jan 2025 09:42:08 -0300 Subject: [PATCH 090/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Marylia Gutierrez --- content/pt/docs/languages/java/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index b00e68cab835..882d7f9902ed 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -204,7 +204,7 @@ OpenTelemetry atendendo a diferentes requisitos de aplicação: ### Direto para o Collector {#direct-to-collector} -No fluxo de trabalho direto para o collector, logs são emitidos diretamente da +No _workflow_ direto para o collector, logs são emitidos diretamente da aplicação para o coletor usando um protocolo de rede (ex. OTLP). Este fluxo de trabalho é simples para configurar e não requer nenhum componente de encaminhamento de log adicional, e permite que uma facilmente emita logs From ca7f76c83e436b29eb46b79a609550f5e0403f47 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Wed, 29 Jan 2025 09:42:29 -0300 Subject: [PATCH 091/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Marylia Gutierrez --- content/pt/docs/languages/java/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index 882d7f9902ed..32dbfff533dd 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -213,7 +213,7 @@ estruturados em conformidade com o sobrecarga necessária para as aplicações enfileirarem e exportarem os logs para um local de rede pode não ser adequada para todas as aplicações. -Para usar este fluxo de trabalho: +Para usar este _workflow_: - Instale o conector de log apropriado. **[1]** - Configure o OpenTelemetry [Log SDK](../sdk/#sdkloggerprovider) para exportar From ef3cbc1af9ecad75b4b83f20b8524ad394699b69 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Wed, 29 Jan 2025 09:43:22 -0300 Subject: [PATCH 092/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Marylia Gutierrez --- content/pt/docs/languages/java/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index 32dbfff533dd..93bcf64e5157 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -232,7 +232,7 @@ para demonstração de uma variedade de cenários. No fluxo de trabalho utilizado em arquivos ou _stdout_, os logs são gravados em arquivos ou na saída _standout_. Outro componente (ex. FluentBit) é responsável por ler / acompanhar os logs, convertê-los para um formato mais estruturado, e encaminhá-los para um destino, como um -Collector. Este fluxo de trabalho pode ser preferível em situações onde os +Collector. Este _workflow_ pode ser preferível em situações onde os requisitos da aplicação não permitem sobrecarga adicional da abordagem [direto para o Collector](#direct-to-collector). No entanto, isso requer que todos os campos de logs necessários para processamento posterior sejam codificados em From 20ff8ea40cc4091602d98604a3721d7e56c4f8d5 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Wed, 29 Jan 2025 09:44:50 -0300 Subject: [PATCH 093/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Marylia Gutierrez --- content/pt/docs/languages/java/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index 93bcf64e5157..c141fa256842 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -162,7 +162,7 @@ contexto: - Bibliotecas que representam um ponto de entrada da aplicação (i.e. servidores HTTP, consumidores de mensagens, etc.) devem - [extrair o context](../api/#contextpropagators) de mensagens recebidas. + [extrair o contexto](../api/#contextpropagators) de mensagens recebidas. - Bibliotecas que representam um ponto de saída de uma aplicação (ex. Clientes HTTP, Produtores de Mensagens, etc.) devem [injetar o contexto](../api/#contextpropagators) em mensagens de saída. From af0e54e8f8d73667c83e1134bd44566fe39faacf Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Wed, 29 Jan 2025 09:45:07 -0300 Subject: [PATCH 094/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Marylia Gutierrez --- content/pt/docs/languages/java/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index c141fa256842..f1a5bebec6a8 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -164,7 +164,7 @@ contexto: HTTP, consumidores de mensagens, etc.) devem [extrair o contexto](../api/#contextpropagators) de mensagens recebidas. - Bibliotecas que representam um ponto de saída de uma aplicação (ex. Clientes - HTTP, Produtores de Mensagens, etc.) devem + HTTP, produtores de mensagens, etc.) devem [injetar o contexto](../api/#contextpropagators) em mensagens de saída. - Bibliotecas devem passar implicitamente ou explicitamente o [contexto](../api/#context) através da pilha de chamadas e entre qualquer From 9826a20301f41f476f0392080b37691ca8d7570e Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Wed, 29 Jan 2025 09:45:42 -0300 Subject: [PATCH 095/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Marylia Gutierrez --- content/pt/docs/languages/java/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index f1a5bebec6a8..88caf1b516a1 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -163,7 +163,7 @@ contexto: - Bibliotecas que representam um ponto de entrada da aplicação (i.e. servidores HTTP, consumidores de mensagens, etc.) devem [extrair o contexto](../api/#contextpropagators) de mensagens recebidas. -- Bibliotecas que representam um ponto de saída de uma aplicação (ex. Clientes +- Bibliotecas que representam um ponto de saída de uma aplicação (ex. clientes HTTP, produtores de mensagens, etc.) devem [injetar o contexto](../api/#contextpropagators) em mensagens de saída. - Bibliotecas devem passar implicitamente ou explicitamente o From ae617abc6b552ba85192a4ec566ba68fd3afe404 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Wed, 29 Jan 2025 09:45:59 -0300 Subject: [PATCH 096/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Marylia Gutierrez --- content/pt/docs/languages/java/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index 88caf1b516a1..06f4948b5695 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -172,7 +172,7 @@ contexto: ## Convenção semântica {#semantic-conventions} -A [Convenção semântica](/docs/specs/semconv/) define como produzir telemetria +As [convenções semânticas](/docs/specs/semconv/) definem como produzir telemetria para os padrões de operação. Entre outras coisas, a convenção semântica especifica nomes e tipos de trechos, instrumentos de métrica, unidades de métricas, tipos de métricas, e atributos chave, valor, e níveis de requisitos. From ca0af6e5b45f037e5fee56b8139c3dccd41a512d Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Wed, 29 Jan 2025 09:46:14 -0300 Subject: [PATCH 097/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Marylia Gutierrez --- content/pt/docs/languages/java/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index 06f4948b5695..c9cfffded9a9 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -173,7 +173,7 @@ contexto: ## Convenção semântica {#semantic-conventions} As [convenções semânticas](/docs/specs/semconv/) definem como produzir telemetria -para os padrões de operação. Entre outras coisas, a convenção semântica +para operações padrão. Entre outras coisas, as convenções semânticas especifica nomes e tipos de trechos, instrumentos de métrica, unidades de métricas, tipos de métricas, e atributos chave, valor, e níveis de requisitos. From ddc951a323a91191892493bde6d92ad303529669 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Wed, 29 Jan 2025 09:47:49 -0300 Subject: [PATCH 098/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Vitor Vasconcellos --- content/pt/docs/languages/java/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index c9cfffded9a9..7d3b187c264b 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -191,7 +191,7 @@ convenção semântica. Enquanto as APIs do [LoggerProvider](../api/#loggerprovider) / [Logger](../api/#logger) são estruturalmente similares ou equivalentes -[trace](../api/#tracerprovider) e [métricas](../api/#meterprovider) APIs, servem +às APIs de [rastros](../api/#tracerprovider) e [métricas](../api/#meterprovider), elas possuem para diferentes casos de uso. A partir de agora, `LoggerProvider` / `Logger` e as classes associadas representam a [Log Bridge API](/docs/specs/otel/logs/api/), que existe para escrever From 5a190637678aa414654c1d1f690c423cba43d291 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Wed, 29 Jan 2025 09:48:04 -0300 Subject: [PATCH 099/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Marylia Gutierrez --- content/pt/docs/languages/java/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index 7d3b187c264b..0a8b1426edc3 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -174,7 +174,7 @@ contexto: As [convenções semânticas](/docs/specs/semconv/) definem como produzir telemetria para operações padrão. Entre outras coisas, as convenções semânticas -especifica nomes e tipos de trechos, instrumentos de métrica, unidades de +especificam nomes e tipos de trechos, instrumentos de métrica, unidades de métricas, tipos de métricas, e atributos chave, valor, e níveis de requisitos. Ao escrever instrumentação, consulte a convenção semântica e confirme que From 5949a72835e1eb6ac490e36954996c1c95eafb13 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Wed, 29 Jan 2025 09:48:27 -0300 Subject: [PATCH 100/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Vitor Vasconcellos --- content/pt/docs/languages/java/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index 0a8b1426edc3..1aa51281c4f8 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -192,7 +192,7 @@ convenção semântica. Enquanto as APIs do [LoggerProvider](../api/#loggerprovider) / [Logger](../api/#logger) são estruturalmente similares ou equivalentes às APIs de [rastros](../api/#tracerprovider) e [métricas](../api/#meterprovider), elas possuem -para diferentes casos de uso. A partir de agora, `LoggerProvider` / `Logger` e +diferentes casos de uso. A partir de agora, `LoggerProvider` / `Logger` e as classes associadas representam a [Log Bridge API](/docs/specs/otel/logs/api/), que existe para escrever conectores de logs para conectar logs registrados através de outras APIs de log From 805b87f2b8e0d0f5531452e6db2d2e6686c45bae Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Wed, 29 Jan 2025 09:50:36 -0300 Subject: [PATCH 101/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Marylia Gutierrez --- content/pt/docs/languages/java/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index 1aa51281c4f8..445821676273 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -199,7 +199,7 @@ conectores de logs para conectar logs registrados através de outras APIs de log / frameworks no OpenTelemetry. Eles não são destinados para usuários finais como um substituto para Log4j / SLF4J / Logback / etc. -Eles são dois típicos fluxos de trabalho para consumir instrumentação de logs no +Eles são dois _workflows_ típicos para consumir instrumentação de logs no OpenTelemetry atendendo a diferentes requisitos de aplicação: ### Direto para o Collector {#direct-to-collector} From b8acc4150bad0e5b71d8126a33e808edeb06b3df Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Wed, 29 Jan 2025 09:50:51 -0300 Subject: [PATCH 102/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Marylia Gutierrez --- content/pt/docs/languages/java/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index 445821676273..497b958df781 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -205,7 +205,7 @@ OpenTelemetry atendendo a diferentes requisitos de aplicação: ### Direto para o Collector {#direct-to-collector} No _workflow_ direto para o collector, logs são emitidos diretamente da -aplicação para o coletor usando um protocolo de rede (ex. OTLP). Este fluxo de +aplicação para o collector usando um protocolo de rede (ex. OTLP). Este _workflow_ trabalho é simples para configurar e não requer nenhum componente de encaminhamento de log adicional, e permite que uma facilmente emita logs estruturados em conformidade com o From 6b256628959896a1aa9219d0c0dbe55fd75f8a79 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Wed, 29 Jan 2025 09:51:06 -0300 Subject: [PATCH 103/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Marylia Gutierrez --- content/pt/docs/languages/java/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index 497b958df781..254304a50d3e 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -206,7 +206,7 @@ OpenTelemetry atendendo a diferentes requisitos de aplicação: No _workflow_ direto para o collector, logs são emitidos diretamente da aplicação para o collector usando um protocolo de rede (ex. OTLP). Este _workflow_ -trabalho é simples para configurar e não requer nenhum componente de +é simples para configurar já que não requer nenhum componente adicional de encaminhamento de log adicional, e permite que uma facilmente emita logs estruturados em conformidade com o [modelo de dados de log](/docs/specs/otel/logs/data-model/). No entanto, a From 6637fd9f68c24d20fbda53054e3286f056af6229 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Wed, 29 Jan 2025 09:51:24 -0300 Subject: [PATCH 104/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Marylia Gutierrez --- content/pt/docs/languages/java/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index 254304a50d3e..274bfdc61511 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -207,7 +207,7 @@ OpenTelemetry atendendo a diferentes requisitos de aplicação: No _workflow_ direto para o collector, logs são emitidos diretamente da aplicação para o collector usando um protocolo de rede (ex. OTLP). Este _workflow_ é simples para configurar já que não requer nenhum componente adicional de -encaminhamento de log adicional, e permite que uma facilmente emita logs +encaminhamento de log, e permite que uma aplicação facilmente emita logs estruturados em conformidade com o [modelo de dados de log](/docs/specs/otel/logs/data-model/). No entanto, a sobrecarga necessária para as aplicações enfileirarem e exportarem os logs para From 151f2f6b16f027a5318e0f755089e9e22c6481c6 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Wed, 29 Jan 2025 09:51:38 -0300 Subject: [PATCH 105/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Marylia Gutierrez --- content/pt/docs/languages/java/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index 274bfdc61511..ce95ce5a7530 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -215,7 +215,7 @@ um local de rede pode não ser adequada para todas as aplicações. Para usar este _workflow_: -- Instale o conector de log apropriado. **[1]** +- Instale o anexador apropriado de log. **[1]** - Configure o OpenTelemetry [Log SDK](../sdk/#sdkloggerprovider) para exportar registros de logs para o destino desejado (o [Collector](https://github.com/open-telemetry/opentelemetry-collector) ou From 3aa207e45dee824d7c082c7be1223be26f300a79 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Wed, 29 Jan 2025 09:56:42 -0300 Subject: [PATCH 106/129] Update instrumentation.md --- content/pt/docs/languages/java/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index ce95ce5a7530..ff45d97c7366 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -215,7 +215,7 @@ um local de rede pode não ser adequada para todas as aplicações. Para usar este _workflow_: -- Instale o anexador apropriado de log. **[1]** +- Instale o conector apropriado de log. **[1]** - Configure o OpenTelemetry [Log SDK](../sdk/#sdkloggerprovider) para exportar registros de logs para o destino desejado (o [Collector](https://github.com/open-telemetry/opentelemetry-collector) ou From 1998192eab7cb55bb095cd1e6337e672369d52ee Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Wed, 29 Jan 2025 09:57:05 -0300 Subject: [PATCH 107/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Marylia Gutierrez --- content/pt/docs/languages/java/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index ff45d97c7366..df35cf5165d0 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -223,7 +223,7 @@ Para usar este _workflow_: **[1]**: Conectores de Logs são um tipo de [shim](#shims) que conecta logs de um _framework_ na SDK de Logs do OpenTelemetry. Veja os items "Bridge Log4j em OpenTelemetry", -"Bridge Logback em OpenTelemetry" entradas. Veja +"Bridge Logback em OpenTelemetry". Veja [Exemplo de aplicadores de Logs](https://github.com/open-telemetry/opentelemetry-java-docs/tree/main/log-appender) para demonstração de uma variedade de cenários. From cb2dfb55e985bd95d063007df955e1d11616cbe9 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Wed, 29 Jan 2025 09:57:31 -0300 Subject: [PATCH 108/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Marylia Gutierrez --- content/pt/docs/languages/java/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index df35cf5165d0..e3450755cee3 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -229,7 +229,7 @@ para demonstração de uma variedade de cenários. ### Via arquivo ou stdout {#via-file-or-stdout} -No fluxo de trabalho utilizado em arquivos ou _stdout_, os logs são gravados em arquivos ou na saída +No _workflow_ para arquivos ou _stdout_, os logs são gravados em arquivos ou na saída _standout_. Outro componente (ex. FluentBit) é responsável por ler / acompanhar os logs, convertê-los para um formato mais estruturado, e encaminhá-los para um destino, como um Collector. Este _workflow_ pode ser preferível em situações onde os From e23e368256d89cb40515e7f48406cb6ae35b43bc Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Wed, 29 Jan 2025 09:57:49 -0300 Subject: [PATCH 109/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Marylia Gutierrez --- content/pt/docs/languages/java/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index e3450755cee3..4826a8e5876c 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -235,7 +235,7 @@ convertê-los para um formato mais estruturado, e encaminhá-los para um destino Collector. Este _workflow_ pode ser preferível em situações onde os requisitos da aplicação não permitem sobrecarga adicional da abordagem [direto para o Collector](#direct-to-collector). No entanto, isso requer que todos -os campos de logs necessários para processamento posterior sejam codificados em +os campos de logs necessários para processamento posterior sejam codificados nos logs, e este componente lendo os logs os interprete no [modelo de dados de log](/docs/specs/otel/logs/data-model). A instalação e configuração dos componentes de encaminhamento de log está fora do escopo deste From 35ca1b794bfadca2c89b201c2c2ca68256302b1e Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Wed, 29 Jan 2025 17:49:06 -0300 Subject: [PATCH 110/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Marylia Gutierrez --- content/pt/docs/languages/java/instrumentation.md | 2 -- 1 file changed, 2 deletions(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index 4826a8e5876c..3d8b97cc8305 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -184,8 +184,6 @@ O OpenTelemetry Java [publica artefatos](../api/#semantic-attributes) para auxiliar a conformidade com a convenção semântica, incluindo constantes geradas para chaves e valores de atributos. -TODO: Discutir instrumentação API e como isso ajuda a conformidade com a -convenção semântica. ## Instrumentação de Log {#log-instrumentation} From 455f1846b46aa41b2da659094dfc6c0dc712a3f0 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Thu, 30 Jan 2025 13:37:47 -0300 Subject: [PATCH 111/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Marylia Gutierrez --- content/pt/docs/languages/java/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index 3d8b97cc8305..213411c96613 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -193,7 +193,7 @@ Enquanto as APIs do [LoggerProvider](../api/#loggerprovider) / [Logger](../api/# diferentes casos de uso. A partir de agora, `LoggerProvider` / `Logger` e as classes associadas representam a [Log Bridge API](/docs/specs/otel/logs/api/), que existe para escrever -conectores de logs para conectar logs registrados através de outras APIs de log +anexadores de logs para conectar logs registrados através de outras APIs de log / frameworks no OpenTelemetry. Eles não são destinados para usuários finais como um substituto para Log4j / SLF4J / Logback / etc. From 7bc9d075ec21c118db86b1ed56e7297bcdb294e5 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Thu, 30 Jan 2025 13:41:57 -0300 Subject: [PATCH 112/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Marylia Gutierrez --- content/pt/docs/languages/java/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index 213411c96613..96ae435d0b46 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -222,7 +222,7 @@ Para usar este _workflow_: **[1]**: Conectores de Logs são um tipo de [shim](#shims) que conecta logs de um _framework_ na SDK de Logs do OpenTelemetry. Veja os items "Bridge Log4j em OpenTelemetry", "Bridge Logback em OpenTelemetry". Veja -[Exemplo de aplicadores de Logs](https://github.com/open-telemetry/opentelemetry-java-docs/tree/main/log-appender) +[Exemplo de Anexadores de Logs](https://github.com/open-telemetry/opentelemetry-java-docs/tree/main/log-appender) para demonstração de uma variedade de cenários. ### Via arquivo ou stdout {#via-file-or-stdout} From b7e144393ab5d013bb697f8a3b13fc7b37644b06 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Thu, 30 Jan 2025 13:42:20 -0300 Subject: [PATCH 113/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Marylia Gutierrez --- content/pt/docs/languages/java/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index 96ae435d0b46..ed288b890f5f 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -219,7 +219,7 @@ Para usar este _workflow_: [Collector](https://github.com/open-telemetry/opentelemetry-collector) ou outro). -**[1]**: Conectores de Logs são um tipo de [shim](#shims) que conecta logs de +**[1]**: Anexadores de Logs são um tipo de [shim](#shims) que conecta logs de um _framework_ na SDK de Logs do OpenTelemetry. Veja os items "Bridge Log4j em OpenTelemetry", "Bridge Logback em OpenTelemetry". Veja [Exemplo de Anexadores de Logs](https://github.com/open-telemetry/opentelemetry-java-docs/tree/main/log-appender) From e8414b8e3558d3665cb4e0821e45e9eefb79445c Mon Sep 17 00:00:00 2001 From: OpenTelemetry Bot <107717825+opentelemetrybot@users.noreply.github.com> Date: Thu, 30 Jan 2025 00:49:19 -0800 Subject: [PATCH 114/129] Auto-update registry versions (766437a4760861f20f0c9512654cc78b92d596bf) (#6113) --- data/registry/exporter-dotnet-onecollector.yml | 2 +- data/registry/exporter-js-instana.yml | 2 +- data/registry/instrumentation-dotnet-aws.yml | 2 +- data/registry/instrumentation-dotnet-awslambda.yml | 2 +- data/registry/instrumentation-dotnet-instrumentation-aws.yml | 2 +- data/registry/tools-ruby-sentry.yml | 2 +- 6 files changed, 6 insertions(+), 6 deletions(-) diff --git a/data/registry/exporter-dotnet-onecollector.yml b/data/registry/exporter-dotnet-onecollector.yml index 188039ba98c3..726b655ae85d 100644 --- a/data/registry/exporter-dotnet-onecollector.yml +++ b/data/registry/exporter-dotnet-onecollector.yml @@ -18,4 +18,4 @@ createdAt: 2023-03-03 package: registry: nuget name: OpenTelemetry.Exporter.OneCollector - version: 1.10.0 + version: 1.11.0-beta.1 diff --git a/data/registry/exporter-js-instana.yml b/data/registry/exporter-js-instana.yml index cac0ef7b9a8b..fe7c1b52ea25 100644 --- a/data/registry/exporter-js-instana.yml +++ b/data/registry/exporter-js-instana.yml @@ -16,4 +16,4 @@ createdAt: 2022-04-18 package: registry: npm name: '@instana/opentelemetry-exporter' - version: 4.6.0 + version: 4.6.1 diff --git a/data/registry/instrumentation-dotnet-aws.yml b/data/registry/instrumentation-dotnet-aws.yml index db5c3abbea3b..8aef5c95098e 100644 --- a/data/registry/instrumentation-dotnet-aws.yml +++ b/data/registry/instrumentation-dotnet-aws.yml @@ -20,4 +20,4 @@ isFirstParty: false package: registry: nuget name: OpenTelemetry.Instrumentation.AWS - version: 1.10.0-rc.2 + version: 1.11.0 diff --git a/data/registry/instrumentation-dotnet-awslambda.yml b/data/registry/instrumentation-dotnet-awslambda.yml index 9874a28591bb..8413ab5c3195 100644 --- a/data/registry/instrumentation-dotnet-awslambda.yml +++ b/data/registry/instrumentation-dotnet-awslambda.yml @@ -19,4 +19,4 @@ isFirstParty: false package: registry: nuget name: OpenTelemetry.Instrumentation.AWSLambda - version: 1.10.0-rc.2 + version: 1.11.0 diff --git a/data/registry/instrumentation-dotnet-instrumentation-aws.yml b/data/registry/instrumentation-dotnet-instrumentation-aws.yml index e7b4e633d474..ae01cb301748 100644 --- a/data/registry/instrumentation-dotnet-instrumentation-aws.yml +++ b/data/registry/instrumentation-dotnet-instrumentation-aws.yml @@ -16,4 +16,4 @@ isFirstParty: false package: registry: nuget name: OpenTelemetry.Instrumentation.AWS - version: 1.10.0-rc.2 + version: 1.11.0 diff --git a/data/registry/tools-ruby-sentry.yml b/data/registry/tools-ruby-sentry.yml index 870d8bc80c7f..731847638b61 100644 --- a/data/registry/tools-ruby-sentry.yml +++ b/data/registry/tools-ruby-sentry.yml @@ -23,4 +23,4 @@ createdAt: 2023-01-31 package: registry: gems name: sentry-opentelemetry - version: 5.22.2 + version: 5.22.3 From 1a63fbe0e012db3739bc3de0e8167b84ec73854b Mon Sep 17 00:00:00 2001 From: Tyler Yahn Date: Thu, 30 Jan 2025 01:01:11 -0800 Subject: [PATCH 115/129] Add Go Auto-Instrumentation Beta Announcement Blog Post (#6079) Co-authored-by: Severin Neumann Co-authored-by: Tiffany Hrabusa <30397949+tiffany76@users.noreply.github.com> Co-authored-by: opentelemetrybot <107717825+opentelemetrybot@users.noreply.github.com> --- .../blog/2025/go-auto-instrumentation-beta.md | 124 ++++++++++++++++++ static/refcache.json | 40 ++++++ 2 files changed, 164 insertions(+) create mode 100644 content/en/blog/2025/go-auto-instrumentation-beta.md diff --git a/content/en/blog/2025/go-auto-instrumentation-beta.md b/content/en/blog/2025/go-auto-instrumentation-beta.md new file mode 100644 index 000000000000..c276c7f9db3b --- /dev/null +++ b/content/en/blog/2025/go-auto-instrumentation-beta.md @@ -0,0 +1,124 @@ +--- +# prettier-ignore +title: Announcing the Beta Release of OpenTelemetry Go Auto-Instrumentation using eBPF +linkTitle: Go Auto-Instrumentation Beta +date: 2025-01-30 +# prettier-ignore +author: >- + [Tyler Yahn](https://github.com/MrAlias) (Splunk) + [Mike Dame](https://github.com/damemi) (Odigos) +sig: SIG Go Auto-Instrumentation +# prettier-ignore +cSpell:ignore: Yahn Odigos rolldice Beyla's Beyla +--- + +The OpenTelemetry community is excited to announce the beta release of the +[OpenTelemetry Go Auto-Instrumentation project](https://github.com/open-telemetry/opentelemetry-go-instrumentation)! +This milestone brings us closer to our mission of making observability simple, +accessible, and effective for Go applications. + +## What is Go Auto-Instrumentation? + +OpenTelemetry Go Auto-Instrumentation allows developers to collect traces from +their Go applications without requiring manual code modifications or rebuilding +binaries. By dynamically instrumenting applications at runtime using +[eBPF](https://ebpf.io/), this project lowers the barrier to adopting +observability best practices and provides deep insights into your application's +behavior. + +## Key features of the beta release + +The beta release offers foundational support for automatic instrumentation with +these key features: + +- **HTTP server instrumentation**: Automatically trace incoming and outgoing + HTTP requests with trace context propagation when using the + [`net/http` package](https://pkg.go.dev/net/http). +- **Database instrumentation**: Instrument database queries and connections that + use the [`database/sql` package](https://pkg.go.dev/database/sql). +- **gRPC instrumentation**: Easily collect telemetry data from + [gRPC clients and servers](https://pkg.go.dev/google.golang.org/grpc). +- **Kafka-go instrumentation**: Monitor and trace Kafka messaging using the + [`kafka-go` package](https://pkg.go.dev/github.com/segmentio/kafka-go). +- **Extensible with OpenTelemetry’s Trace API**: Seamlessly extend + auto-instrumentation with custom spans using the + [OpenTelemetry Go Trace API](https://pkg.go.dev/go.opentelemetry.io/otel). +- **Configuration using environment variables**: Simplify configuration with + environment-based settings, reducing the need for code changes. +- **Semantic convention compliance**: Produced telemetry complies with the + latest OpenTelemetry semantic conventions ensuring compatibility with the OTel + ecosystem. + +## Getting started + +Getting started with OpenTelemetry Go Auto-Instrumentation is straightforward! +For detailed instructions on installation, configuration, and running your +application with auto-instrumentation, check out the +[Getting Started guide](https://github.com/open-telemetry/opentelemetry-go-instrumentation/blob/main/docs/getting-started.md). + +To see a complete example, check out the +[`rolldice` application](https://github.com/open-telemetry/opentelemetry-go-instrumentation/tree/0ebb7f21116bfdd8e29c315efdbf359cd74bddac/examples/rolldice). + +## The road to stabilization + +With the beta release now available, the project team is focused on preparing +for a stable release. Over the coming year, we’ll concentrate on achieving the +following goals: + +1. **Optimize runtime instrumentation with eBPF** + + We will continue to leverage and improve eBPF for dynamic runtime + instrumentation, ensuring that Go applications have reliable, low-overhead + observability. This includes staying up to date with the latest developments + in both the Go and eBPF ecosystems. + +2. **Expand ecosystem support** + + While the beta release supports a limited number of Go packages and only a + single telemetry processing pipeline, we plan to broaden this support. We’ll + introduce instrumentation for additional Go packages and allow users to + create custom telemetry processing pipelines. This expansion will make it + easier to integrate with popular Go packages and provide flexibility for + custom instrumentation. + +3. **Integrate with Beyla’s donation to OpenTelemetry** + + The proposed + [donation of Beyla to OpenTelemetry](https://github.com/open-telemetry/community/issues/2406) + presents an opportunity to enhance OpenTelemetry’s eBPF-based + auto-instrumentation capabilities. If accepted, this donation will help + expand support for additional signals, protocols, and languages, creating a + more comprehensive eBPF-based observability solution. OpenTelemetry Go + Auto-Instrumentation will evolve alongside these developments, ensuring + seamless collaboration while continuing to provide robust tracing for Go + applications. + +Keep track of our progress in the +[2025 Goals tracking issue](https://github.com/open-telemetry/opentelemetry-go-instrumentation/issues/1659). + +## Join the journey + +As with all OpenTelemetry projects, the success of Go Auto-Instrumentation +depends on the community. Whether you’re a developer interested in contributing, +a company looking to adopt the project, or simply curious about observability, +we’d love for you to join us. + +Here’s how you can get involved: + +- **Try the beta**: Integrate the project into your applications and + [provide feedback](https://github.com/open-telemetry/opentelemetry-go-instrumentation/discussions/1697). +- **Contribute**: Check out + [open issues](https://github.com/open-telemetry/opentelemetry-go-instrumentation/issues) + and + [contribute](https://github.com/open-telemetry/opentelemetry-go-instrumentation/blob/0ebb7f21116bfdd8e29c315efdbf359cd74bddac/CONTRIBUTING.md) + to the project on + [GitHub](https://github.com/open-telemetry/opentelemetry-go-instrumentation). +- **Join the discussion**: Participate in our + [SIG meetings](https://groups.google.com/a/opentelemetry.io/g/calendar-go) and + discussions on [Slack](https://cloud-native.slack.com/archives/C03S01YSAS0). + +## Acknowledgments + +This beta release is the result of countless hours of work by contributors from +around the world. Thank you to everyone who has contributed code, documentation, +feedback, and enthusiasm to make this milestone possible. diff --git a/static/refcache.json b/static/refcache.json index 337b09b09e8d..41f86eaa12c5 100644 --- a/static/refcache.json +++ b/static/refcache.json @@ -1827,6 +1827,10 @@ "StatusCode": 200, "LastSeen": "2024-10-24T15:10:31.184402+02:00" }, + "https://cloud-native.slack.com/archives/C03S01YSAS0": { + "StatusCode": 200, + "LastSeen": "2025-01-29T17:30:33.389601601Z" + }, "https://cloud-native.slack.com/archives/C0422FSELH0": { "StatusCode": 200, "LastSeen": "2024-08-09T10:45:38.976435-04:00" @@ -6559,6 +6563,10 @@ "StatusCode": 206, "LastSeen": "2025-01-18T20:45:29.87596Z" }, + "https://github.com/open-telemetry/community/issues/2406": { + "StatusCode": 206, + "LastSeen": "2025-01-29T17:30:15.084501808Z" + }, "https://github.com/open-telemetry/community/issues/2497": { "StatusCode": 206, "LastSeen": "2025-01-18T20:45:32.577654Z" @@ -8983,10 +8991,34 @@ "StatusCode": 200, "LastSeen": "2024-08-09T10:44:15.667174-04:00" }, + "https://github.com/open-telemetry/opentelemetry-go-instrumentation/blob/0ebb7f21116bfdd8e29c315efdbf359cd74bddac/CONTRIBUTING.md": { + "StatusCode": 206, + "LastSeen": "2025-01-29T17:30:28.598163793Z" + }, + "https://github.com/open-telemetry/opentelemetry-go-instrumentation/blob/main/docs/getting-started.md": { + "StatusCode": 206, + "LastSeen": "2025-01-29T17:30:06.908079743Z" + }, "https://github.com/open-telemetry/opentelemetry-go-instrumentation/blob/main/docs/how-it-works.md": { "StatusCode": 206, "LastSeen": "2025-01-16T11:37:46.811839-05:00" }, + "https://github.com/open-telemetry/opentelemetry-go-instrumentation/discussions/1697": { + "StatusCode": 206, + "LastSeen": "2025-01-29T17:30:21.969390623Z" + }, + "https://github.com/open-telemetry/opentelemetry-go-instrumentation/issues": { + "StatusCode": 206, + "LastSeen": "2025-01-29T17:30:25.012053984Z" + }, + "https://github.com/open-telemetry/opentelemetry-go-instrumentation/issues/1659": { + "StatusCode": 206, + "LastSeen": "2025-01-29T17:30:18.099406688Z" + }, + "https://github.com/open-telemetry/opentelemetry-go-instrumentation/tree/0ebb7f21116bfdd8e29c315efdbf359cd74bddac/examples/rolldice": { + "StatusCode": 206, + "LastSeen": "2025-01-29T17:30:12.02761941Z" + }, "https://github.com/open-telemetry/opentelemetry-go-vanityurls": { "StatusCode": 200, "LastSeen": "2024-08-23T20:33:46.750242014Z" @@ -17075,6 +17107,10 @@ "StatusCode": 200, "LastSeen": "2024-08-12T17:56:07.964057+02:00" }, + "https://pkg.go.dev/github.com/segmentio/kafka-go": { + "StatusCode": 200, + "LastSeen": "2025-01-29T17:30:03.308377379Z" + }, "https://pkg.go.dev/go.opentelemetry.io/collector/cmd/builder": { "StatusCode": 200, "LastSeen": "2024-03-01T16:49:30.684687+01:00" @@ -17347,6 +17383,10 @@ "StatusCode": 200, "LastSeen": "2024-01-30T15:25:12.45117-05:00" }, + "https://pkg.go.dev/google.golang.org/grpc": { + "StatusCode": 200, + "LastSeen": "2025-01-29T17:30:01.456756939Z" + }, "https://pkg.go.dev/google.golang.org/grpc/credentials#PerRPCCredentials": { "StatusCode": 200, "LastSeen": "2025-01-06T11:32:36.518761-05:00" From f82484d86f62bda7da13b3c700d06e8a948fe824 Mon Sep 17 00:00:00 2001 From: Carlos Fuentes Date: Thu, 30 Jan 2025 14:10:44 +0100 Subject: [PATCH 116/129] registry: add @fastify/otel to registry (#6024) --- .../instrumentation-js-fastify-otel.yml | 20 +++++++++++++++++++ static/refcache.json | 12 +++++++++++ 2 files changed, 32 insertions(+) create mode 100644 data/registry/instrumentation-js-fastify-otel.yml diff --git a/data/registry/instrumentation-js-fastify-otel.yml b/data/registry/instrumentation-js-fastify-otel.yml new file mode 100644 index 000000000000..89dd5838eac4 --- /dev/null +++ b/data/registry/instrumentation-js-fastify-otel.yml @@ -0,0 +1,20 @@ +# cSpell:ignore fastify +title: Fastify Instrumentation Library +registryType: instrumentation +language: js +tags: + - Node.js + - fastify +license: MIT +description: Fastify OpenTelemetry auto-instrumentation library. +authors: + - name: Fastify + url: https://github.com/fastify +urls: + repo: https://github.com/fastify/otel +createdAt: 2025-01-27 +package: + registry: npm + name: '@fastify/otel' + version: 0.1.0 +isFirstParty: true diff --git a/static/refcache.json b/static/refcache.json index 41f86eaa12c5..17bb65c39678 100644 --- a/static/refcache.json +++ b/static/refcache.json @@ -5199,6 +5199,14 @@ "StatusCode": 200, "LastSeen": "2024-12-12T08:46:36.556327553Z" }, + "https://github.com/fastify": { + "StatusCode": 206, + "LastSeen": "2025-01-30T09:08:01.740037144Z" + }, + "https://github.com/fastify/otel": { + "StatusCode": 206, + "LastSeen": "2025-01-30T09:08:01.439341003Z" + }, "https://github.com/fatsheep9146": { "StatusCode": 200, "LastSeen": "2024-08-09T11:16:50.08101+02:00" @@ -15639,6 +15647,10 @@ "StatusCode": 200, "LastSeen": "2024-08-09T11:05:21.995559-04:00" }, + "https://npmjs.com/package/@fastify/otel": { + "StatusCode": 200, + "LastSeen": "2025-01-30T09:08:03.616878745Z" + }, "https://npmjs.com/package/@google-cloud/opentelemetry-cloud-monitoring-exporter": { "StatusCode": 200, "LastSeen": "2025-01-13T12:41:55.24405-05:00" From 772498767c1646dc6c0bf2b5a7555080b279018f Mon Sep 17 00:00:00 2001 From: Trask Stalnaker Date: Thu, 30 Jan 2025 06:01:57 -0800 Subject: [PATCH 117/129] Update (or create) `opentelemetrybot/semantic-conventions-v*` branch daily (#6081) --- .github/workflows/build-dev.yml | 9 -- .github/workflows/build-semconv-daily.yml | 26 ----- .../reusable-workflow-notification.yml | 59 ---------- .../update-semconv-integration-branch.yml | 104 ++++++++++++++++++ 4 files changed, 104 insertions(+), 94 deletions(-) delete mode 100644 .github/workflows/build-semconv-daily.yml delete mode 100644 .github/workflows/reusable-workflow-notification.yml create mode 100644 .github/workflows/update-semconv-integration-branch.yml diff --git a/.github/workflows/build-dev.yml b/.github/workflows/build-dev.yml index a082581dd56a..da819bb42103 100644 --- a/.github/workflows/build-dev.yml +++ b/.github/workflows/build-dev.yml @@ -7,14 +7,6 @@ on: description: Regex of submodule paths to update to HEAD before building. default: content-modules type: string - workflow_call: - inputs: - submodule_path_regex: - type: string - required: true - skip_ref_cache_check: - type: boolean - default: false jobs: build-and-test: @@ -60,7 +52,6 @@ jobs: name: REFCACHE updates? needs: build-and-test runs-on: ubuntu-latest - if: ${{ !inputs.skip_ref_cache_check }} steps: - uses: actions/checkout@v4 - uses: actions/download-artifact@v4 diff --git a/.github/workflows/build-semconv-daily.yml b/.github/workflows/build-semconv-daily.yml deleted file mode 100644 index 8778066a19a8..000000000000 --- a/.github/workflows/build-semconv-daily.yml +++ /dev/null @@ -1,26 +0,0 @@ -name: Build Semantic Conventions (daily) - -on: - schedule: - # daily at 10:24 UTC - - cron: '24 10 * * *' - workflow_dispatch: - -jobs: - build-dev: - uses: ./.github/workflows/build-dev.yml - with: - submodule_path_regex: semantic-conventions - skip_ref_cache_check: true - - workflow-notification: - needs: - - build-dev - if: always() - uses: ./.github/workflows/reusable-workflow-notification.yml - with: - success: ${{ needs.build-dev.result == 'success' }} - repo: open-telemetry/semantic-conventions - secrets: - opentelemetrybot_github_token: - ${{ secrets.OPENTELEMETRYBOT_GITHUB_TOKEN }} diff --git a/.github/workflows/reusable-workflow-notification.yml b/.github/workflows/reusable-workflow-notification.yml deleted file mode 100644 index 49b3e38db485..000000000000 --- a/.github/workflows/reusable-workflow-notification.yml +++ /dev/null @@ -1,59 +0,0 @@ -# this is useful because notifications for scheduled workflows are only sent to the user who -# initially created the given workflow -name: Reusable - Workflow notification - -on: - workflow_call: - inputs: - success: - type: boolean - required: true - repo: - type: string - required: false - secrets: - opentelemetrybot_github_token: - required: false - -jobs: - workflow-notification: - runs-on: ubuntu-latest - steps: - - uses: actions/checkout@v4 - - - name: Open issue or add comment if issue already open - env: - # need to use opentelemetrybot token when opening issues in other repos - GH_TOKEN: - ${{ secrets.opentelemetrybot_github_token || secrets.GITHUB_TOKEN }} - run: | - if [ -z "${{ inputs.repo }}" ]; then - repo="$GITHUB_REPOSITORY" - title="Workflow failed: $GITHUB_WORKFLOW" - body="See [$GITHUB_WORKFLOW #$GITHUB_RUN_NUMBER](https://github.com/$GITHUB_REPOSITORY/actions/runs/$GITHUB_RUN_ID)." - else - repo="${{ inputs.repo }}" - title="Workflow failed: $GITHUB_REPOSITORY $GITHUB_WORKFLOW" - body="See [$GITHUB_REPOSITORY $GITHUB_WORKFLOW #$GITHUB_RUN_NUMBER](https://github.com/$GITHUB_REPOSITORY/actions/runs/$GITHUB_RUN_ID)." - fi - - # TODO (trask) search doesn't support exact phrases, so it's possible that this could grab the wrong issue - number=$(gh issue list --repo $repo --search "in:title $title" --limit 1 --json number -q .[].number) - - echo $number - echo ${{ inputs.success }} - - if [[ $number ]]; then - if [[ "${{ inputs.success }}" == "true" ]]; then - gh issue close $number \ - --repo $repo - else - gh issue comment $number \ - --repo $repo \ - --body "$body" - fi - elif [[ "${{ inputs.success }}" == "false" ]]; then - gh issue create --repo $repo \ - --title "$title (#$GITHUB_RUN_NUMBER)" \ - --body "$body" - fi diff --git a/.github/workflows/update-semconv-integration-branch.yml b/.github/workflows/update-semconv-integration-branch.yml new file mode 100644 index 000000000000..6bda4e2cd865 --- /dev/null +++ b/.github/workflows/update-semconv-integration-branch.yml @@ -0,0 +1,104 @@ +name: Update semconv integration branch + +on: + schedule: + # daily at 10:24 UTC + - cron: '24 10 * * *' + workflow_dispatch: + +jobs: + update-semconv-integration-branch: + runs-on: ubuntu-latest + if: github.repository == 'open-telemetry/opentelemetry.io' + steps: + - uses: actions/checkout@v4 + with: + # this is needed in order to do the rebase below + fetch-depth: 0 + # this is needed in order to trigger workflows when pushing new commits to the PR + token: ${{ secrets.OPENTELEMETRYBOT_GITHUB_TOKEN }} + + - name: Set environment variables + env: + GH_TOKEN: ${{ secrets.GITHUB_TOKEN }} + run: | + branch_prefix="opentelemetrybot/semconv-integration" + + version=$(git branch -r \ + | grep "^ *origin/$branch_prefix-v[0-9]+\.[0-9]+\..*-dev" \ + | sed "s|^ *origin/$branch_prefix-||" \ + | sed "s|-dev$||") + + if [[ -z "$versions" ]]; then + latest_version=$(gh release view \ + --repo open-telemetry/semantic-conventions \ + --json tagName \ + --jq .tagName) + if [[ $latest_version =~ ^v([0-9]+)\.([0-9]+)\. ]]; then + major="${BASH_REMATCH[1]}" + minor="${BASH_REMATCH[2]}" + version="v$major.$((minor + 1)).0" + else + echo "unexpected version: $latest_version" + exit 1 + fi + fi + + echo "VERSION=$version" >> $GITHUB_ENV + echo "BRANCH=$branch_prefix-$version-dev" >> $GITHUB_ENV + + - name: Checkout or create branch + run: | + if ! git ls-remote --exit-code --heads origin $BRANCH; then + git checkout -b $BRANCH origin/main + git push -u origin $BRANCH + else + git checkout $BRANCH + fi + + - name: Use CLA approved github bot + run: | + git config user.name opentelemetrybot + git config user.email 107717825+opentelemetrybot@users.noreply.github.com + + - name: Merge from main + run: | + previous=$(git rev-parse HEAD) + git fetch origin + git merge origin/main + if [ "$(git rev-parse HEAD)" != "$previous" ]; then + git push + fi + + - name: Update submodule + run: | + git submodule update --init content-modules/semantic-conventions + cd content-modules/semantic-conventions + + if git ls-remote --exit-code --tags origin $VERSION; then + git reset --hard $VERSION + else + git reset --hard origin/main + fi + + commit_desc=$(git describe --tags) + cd ../.. + + sed -i "s/^\tsemconv-pin = .*/\tsemconv-pin = $commit_desc/" .gitmodules + + if ! git diff-index --quiet HEAD; then + git commit -am "Update semconv submodule to $commit_desc" + git push + fi + + - name: Create pull request if needed + env: + # not using secrets.GITHUB_TOKEN since pull requests from that token do not run workflows + GH_TOKEN: ${{ secrets.OPENTELEMETRYBOT_GITHUB_TOKEN }} + run: | + prs=$(gh pr list --state open --head $BRANCH) + if [ -z "$prs" ]; then + gh pr create --title "Update semantic conventions to $VERSION-dev" \ + --body "This PR updates the semantic conventions to $VERSION-dev." \ + --draft + fi From 94cd759e884706b02ad3837a48533685c686b0f8 Mon Sep 17 00:00:00 2001 From: Patrice Chalin Date: Thu, 30 Jan 2025 09:04:28 -0500 Subject: [PATCH 118/129] [i18n] Google translate button in fallback pages for all locales (#6117) --- .gitmodules | 2 +- .htmltest.yml | 1 + assets/scss/_styles_project.scss | 12 +++ layouts/docs/baseof.html | 2 + layouts/partials/translate-scripts.html | 99 +++++++++++++++++++++++++ themes/docsy | 2 +- 6 files changed, 116 insertions(+), 2 deletions(-) create mode 100644 layouts/partials/translate-scripts.html diff --git a/.gitmodules b/.gitmodules index d07c697190f6..71c59fb9748a 100644 --- a/.gitmodules +++ b/.gitmodules @@ -2,7 +2,7 @@ [submodule "themes/docsy"] path = themes/docsy url = https://github.com/google/docsy.git - docsy-pin = v0.11.0-37-ga854cb31 + docsy-pin = v0.11.0-38-g77da7e49 docsy-note = "2024-04-01 Switching to google/docsy.git from cncf/docsy.git since we don't have any CNCF customizations." docsy-reminder = "Ensure that any tag referenced by `docsy-pin` is present in the remote repo (url), otherwise add (push) the tags to the repo." [submodule "content-modules/opentelemetry-specification"] diff --git a/.htmltest.yml b/.htmltest.yml index 24fa3877e109..b95d82ae71ea 100644 --- a/.htmltest.yml +++ b/.htmltest.yml @@ -34,6 +34,7 @@ IgnoreURLs: # list of regexs of paths or URLs to be ignored - ^https://deploy-preview-\d+--opentelemetry.netlify.app/ - ^https://www\.googletagmanager\.com + - ^(https:)?//translate.google.com - ^https?://localhost\b - ^https?://127\.0\.0\.1\b diff --git a/assets/scss/_styles_project.scss b/assets/scss/_styles_project.scss index 72ebd961bda8..f20c66bb279d 100644 --- a/assets/scss/_styles_project.scss +++ b/assets/scss/_styles_project.scss @@ -323,3 +323,15 @@ details { overflow-y: auto; } } + +// Google translate select / dropdown + +.goog-te-gadget { + // cSpell:ignore goog + padding-top: 1rem; + margin-bottom: -0.5rem; + + @include media-breakpoint-up(md) { + padding-left: 0.6rem; + } +} diff --git a/layouts/docs/baseof.html b/layouts/docs/baseof.html index bef172843d3f..a103cb5f5ae7 100644 --- a/layouts/docs/baseof.html +++ b/layouts/docs/baseof.html @@ -17,6 +17,7 @@
{{ partial "scripts.html" . }} + {{ partial "translate-scripts.html" . -}} \ No newline at end of file diff --git a/layouts/partials/translate-scripts.html b/layouts/partials/translate-scripts.html new file mode 100644 index 000000000000..bdd9cb7dda31 --- /dev/null +++ b/layouts/partials/translate-scripts.html @@ -0,0 +1,99 @@ +{{/* cSpell:ignore goog + +*/ -}} +{{ $pageProseLang := partial "i18n/lang.html" . -}} +{{ $siteLang := .Site.Language.Lang -}} +{{- if ne $siteLang $pageProseLang -}} + + + + + +{{- end -}} diff --git a/themes/docsy b/themes/docsy index a854cb315ac2..77da7e4943d9 160000 --- a/themes/docsy +++ b/themes/docsy @@ -1 +1 @@ -Subproject commit a854cb315ac2885f8e27a5780d3c320a30d1b457 +Subproject commit 77da7e4943d9c828e68e14a7818ce2850626cbe7 From 96eb65b8a4984b32e73c077d850c00b4d6522abf Mon Sep 17 00:00:00 2001 From: OpenTelemetry Bot <107717825+opentelemetrybot@users.noreply.github.com> Date: Thu, 30 Jan 2025 07:19:08 -0800 Subject: [PATCH 119/129] Update community members (#6105) --- data/community/members.yaml | 18 +++++++++++++++--- static/refcache.json | 8 ++++++++ 2 files changed, 23 insertions(+), 3 deletions(-) diff --git a/data/community/members.yaml b/data/community/members.yaml index ee11a97b477f..5909983226fc 100644 --- a/data/community/members.yaml +++ b/data/community/members.yaml @@ -1492,6 +1492,11 @@ approvers: - specs-trace-approvers html_url: https://github.com/iNikem avatar_url: https://avatars.githubusercontent.com/u/3010154?v=4 + - name: jackgopack4 + teams: + - collector-releases-approvers + html_url: https://github.com/jackgopack4 + avatar_url: https://avatars.githubusercontent.com/u/6229304?v=4 - name: JaredTan95 teams: - collector-contrib-triagers @@ -1613,6 +1618,11 @@ approvers: - php-triagers html_url: https://github.com/morrisonlevi avatar_url: https://avatars.githubusercontent.com/u/253316?v=4 + - name: mowies + teams: + - collector-releases-approvers + html_url: https://github.com/mowies + avatar_url: https://avatars.githubusercontent.com/u/6901203?v=4 - name: mtwo teams: - blog-approvers @@ -1860,6 +1870,11 @@ triagers: - java-contrib-triagers html_url: https://github.com/cyrille-leclerc avatar_url: https://avatars.githubusercontent.com/u/459691?v=4 + - name: d4nyll + teams: + - javascript-contrib-triagers + html_url: https://github.com/d4nyll + avatar_url: https://avatars.githubusercontent.com/u/9997953?v=4 - name: dehaansa teams: - java-contrib-triagers @@ -2278,9 +2293,6 @@ members: - name: moonheart html_url: https://github.com/moonheart avatar_url: https://avatars.githubusercontent.com/u/15916990?v=4 - - name: mowies - html_url: https://github.com/mowies - avatar_url: https://avatars.githubusercontent.com/u/6901203?v=4 - name: mterhar html_url: https://github.com/mterhar avatar_url: https://avatars.githubusercontent.com/u/938684?v=4 diff --git a/static/refcache.json b/static/refcache.json index 17bb65c39678..c8f15ed5c7be 100644 --- a/static/refcache.json +++ b/static/refcache.json @@ -4895,6 +4895,10 @@ "StatusCode": 200, "LastSeen": "2024-08-06T15:19:26.562663+02:00" }, + "https://github.com/d4nyll": { + "StatusCode": 206, + "LastSeen": "2025-01-30T08:51:55.466660836Z" + }, "https://github.com/damemi": { "StatusCode": 206, "LastSeen": "2025-01-13T12:11:00.338153-05:00" @@ -5639,6 +5643,10 @@ "StatusCode": 200, "LastSeen": "2024-05-24T10:11:30.36484-05:00" }, + "https://github.com/jackgopack4": { + "StatusCode": 206, + "LastSeen": "2025-01-30T08:51:48.835115165Z" + }, "https://github.com/jade-guiton-dd": { "StatusCode": 200, "LastSeen": "2024-12-12T08:46:34.109808779Z" From c7bc6cac9ce07977d30cabbb4407d17573661faf Mon Sep 17 00:00:00 2001 From: Vinaum8 Date: Thu, 30 Jan 2025 14:44:34 -0300 Subject: [PATCH 120/129] Resolve Markdown Lint --- content/pt/docs/languages/java/instrumentation.md | 1 - 1 file changed, 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index ed288b890f5f..c04cbbc9ae99 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -184,7 +184,6 @@ O OpenTelemetry Java [publica artefatos](../api/#semantic-attributes) para auxiliar a conformidade com a convenção semântica, incluindo constantes geradas para chaves e valores de atributos. - ## Instrumentação de Log {#log-instrumentation} Enquanto as APIs do [LoggerProvider](../api/#loggerprovider) / [Logger](../api/#logger) From b80fa811fb76437a5b145ce31bf48bc433897c53 Mon Sep 17 00:00:00 2001 From: Patrice Chalin Date: Thu, 30 Jan 2025 11:46:42 -0500 Subject: [PATCH 121/129] [CI] Semconv: apply patch to remove path_base (#6107) --- scripts/content-modules/adjust-pages.pl | 17 +++++++++++++---- 1 file changed, 13 insertions(+), 4 deletions(-) diff --git a/scripts/content-modules/adjust-pages.pl b/scripts/content-modules/adjust-pages.pl index d103d24e258b..df0b1ceada45 100755 --- a/scripts/content-modules/adjust-pages.pl +++ b/scripts/content-modules/adjust-pages.pl @@ -35,7 +35,7 @@ my %versFromSubmod = %versions; # Actual version of submodules. Updated by getVersFromSubmodule(). -sub printTitleAndFrontMatter() { +sub printFrontMatter() { print "---\n"; if ($title eq 'OpenTelemetry Specification') { $title .= " $otelSpecVers"; @@ -46,7 +46,7 @@ () $frontMatterFromFile =~ s/(title|linkTitle): .*/$& $otlpSpecVers/g; # TODO: add to spec landing page $frontMatterFromFile .= "weight: 20\n" if $frontMatterFromFile !~ /^\s*weight/; - } elsif ($ARGV =~ /semconv\/docs\/\w+.md$/) { + } elsif ($ARGV =~ /^tmp\/semconv\/docs\/\w+.md$/) { $title .= " $semconvVers"; $frontMatterFromFile =~ s/linkTitle: .*/$& $semconvVers/; # $frontMatterFromFile =~ s/body_class: .*/$& td-page--draft/; @@ -59,6 +59,15 @@ () # applyPatchOrPrintMsgIf('2024-12-01-bridge-api', 'spec', '1.39.0'); # } + if ($ARGV =~ m{^tmp/semconv/docs.*/(README|_index)\.md$} + && applyPatchOrPrintMsgIf('2025-01-29-path-base', 'semconv', '1.30.0-19-g') + && $frontMatterFromFile =~ /^path_base_for_github_subdir:/m + ) { + $frontMatterFromFile =~ s/\npath_base_for_github_subdir:.*?\n/\n/; + $frontMatterFromFile =~ s|\n from: tmp/semconv/docs/.*?\n|\n|; + $frontMatterFromFile =~ s/\n to: .*README.md($|\n)/$1/; + } + my $titleMaybeQuoted = ($title =~ ':') ? "\"$title\"" : $title; print "title: $titleMaybeQuoted\n" if $frontMatterFromFile !~ /title: /; if ($title =~ /^OpenTelemetry (Protocol )?(.*)/) { @@ -103,7 +112,7 @@ () sub patchSemConv1_30_0() { return unless $ARGV =~ /^tmp\/semconv\/docs\// - && applyPatchOrPrintMsgIf('2025-01-24-emit-an-event', 'semconv', '1.30.0-3-g'); + && applyPatchOrPrintMsgIf('2025-01-24-emit-an-event-etc', 'semconv', '1.30.0-18-g'); s|Emit Event API|Log API|; s|(docs/specs/otel/logs/api.md#emit-a)n-event|$1-logrecord|; @@ -162,7 +171,7 @@ () if(! $title) { ($title) = /^#\s+(.*)/; $linkTitle = ''; - printTitleAndFrontMatter() if $title; + printFrontMatter() if $title; next; } From e51f0ec484e52d5924f927c7c069e24e2d797588 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Thu, 30 Jan 2025 14:49:20 -0300 Subject: [PATCH 122/129] Update content/pt/docs/languages/java/instrumentation.md Co-authored-by: Marylia Gutierrez --- content/pt/docs/languages/java/instrumentation.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index c04cbbc9ae99..df65c92dec4c 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -28,8 +28,7 @@ usuários finais e tópicos relacionados à instrumentação: se complementem. - [Convenções semânticas](#semantic-conventions): As convenções semânticas definem como produzir telemetria para operações padrão. -- [Log instrumentation](#log-instrumentation): A Convenção semântica define como - produzir telemetria para operações padronizadas. +- [Log instrumentation](#log-instrumentation) {{% alert %}} Embora as [categorias de instrumentação](#instrumentation-categories) enumerem diversas From 82241db4777a235d9c9b21a266ec46ab7bbfa3b3 Mon Sep 17 00:00:00 2001 From: Vinaum8 Date: Thu, 30 Jan 2025 14:56:04 -0300 Subject: [PATCH 123/129] Resolve Markdown Lint --- content/pt/docs/languages/java/instrumentation.md | 1 + 1 file changed, 1 insertion(+) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index df65c92dec4c..4808b2c6442f 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -183,6 +183,7 @@ O OpenTelemetry Java [publica artefatos](../api/#semantic-attributes) para auxiliar a conformidade com a convenção semântica, incluindo constantes geradas para chaves e valores de atributos. + ## Instrumentação de Log {#log-instrumentation} Enquanto as APIs do [LoggerProvider](../api/#loggerprovider) / [Logger](../api/#logger) From db6ce1a7e626d07dad076be093c3ea404dac4c0d Mon Sep 17 00:00:00 2001 From: Vinaum8 Date: Thu, 30 Jan 2025 15:35:55 -0300 Subject: [PATCH 124/129] npm run fix:format --- .../pt/docs/languages/java/instrumentation.md | 87 +++++++++---------- 1 file changed, 43 insertions(+), 44 deletions(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index 4808b2c6442f..2df4f0d6870f 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -22,20 +22,21 @@ ecossistema de instrumentação no OpenTelemetry Java, incluindo recursos para usuários finais e tópicos relacionados à instrumentação: - [Categorias de instrumentação](#instrumentation-categories): Existem diversas - categorias de instrumentação para diferentes casos de uso e padrões de instalação. + categorias de instrumentação para diferentes casos de uso e padrões de + instalação. - [Propagação de Contexto](#context-propagation): Propagação de Contexto provê - uma correlação entre rastros, métricas, e logs, permitindo que os sinais - se complementem. -- [Convenções semânticas](#semantic-conventions): As convenções semânticas definem - como produzir telemetria para operações padrão. + uma correlação entre rastros, métricas, e logs, permitindo que os sinais se + complementem. +- [Convenções semânticas](#semantic-conventions): As convenções semânticas + definem como produzir telemetria para operações padrão. - [Log instrumentation](#log-instrumentation) {{% alert %}} Embora as [categorias de instrumentação](#instrumentation-categories) enumerem diversas opções para instrumentar uma aplicação, nós recomendamos que os usuários iniciem -com o [Agente Java](#zero-code-java-agent). O agente Java possui uma -instalação simples, e automaticamente detecta e instala instrumentação de -uma vasta biblioteca. {{% /alert %}} +com o [Agente Java](#zero-code-java-agent). O agente Java possui uma instalação +simples, e automaticamente detecta e instala instrumentação de uma vasta +biblioteca. {{% /alert %}} ## Categorias de instrumentação {#instrumentation-categories} @@ -89,8 +90,8 @@ detalhes. ### Biblioteca de instrumentação {#library-instrumentation} [Biblioteca de instrumentação](/docs/specs/otel/glossary/#instrumentation-library) -envolve ou usa os pontos de extensão para instrumentar a biblioteca, obrigando os -usuários a instalar e/ou adaptar o uso da biblioteca. +envolve ou usa os pontos de extensão para instrumentar a biblioteca, obrigando +os usuários a instalar e/ou adaptar o uso da biblioteca. Para uma lista de bibliotecas de instrumentação, veja a coluna _"Standalone Library Instrumentation [1]"_ (Biblioteca autônoma de instrumentação) em @@ -99,8 +100,8 @@ Library Instrumentation [1]"_ (Biblioteca autônoma de instrumentação) em ### Instrumentação nativa {#native-instrumentation} [Instrumentação nativa](/docs/specs/otel/glossary/#natively-instrumented) é -definido diretamente nas bibliotecas ou _frameworks_. O OpenTelemetry encoraja os -autores de bibliotecas a adicionarem instrumentação nativa usando a +definido diretamente nas bibliotecas ou _frameworks_. O OpenTelemetry encoraja +os autores de bibliotecas a adicionarem instrumentação nativa usando a [API](../api/). No longo prazo, nós esperamos que a instrumentação nativa seja o padrão, e que a instrumentação mantida pelo OpenTelemetry em [opentelemetry-java-instrumentação](https://github.com/open-telemetry/opentelemetry-java-instrumentation) @@ -138,11 +139,11 @@ Shims mantidos no ecossistema OpenTelemetry Java: ## Propagação de Contexto {#context-propagation} As APIs do OpenTelemetry foram desenhadas para serem complementares, onde o todo -é maior que a soma das partes. Cada sinal tem seus pontos fortes e juntos -formam uma narrativa convincente de observabilidade. +é maior que a soma das partes. Cada sinal tem seus pontos fortes e juntos formam +uma narrativa convincente de observabilidade. -É importante ressaltar que os dados de vários sinais são interligados através do contexto -de rastreamento: +É importante ressaltar que os dados de vários sinais são interligados através do +contexto de rastreamento: - Trecho são relacionados com outros trechos através do trecho pai e links, que registram os contextos de rastreamento dos trechos relacionados. @@ -156,8 +157,7 @@ Para essa correlação funcionar, o contexto de rastreamento precisa ser propaga através da aplicação (entre chamada de funções e processos), e entre limites da aplicação. A [API de contexto](../api/#context-api) facilita isso. -A instrumentação deve ser escrita de uma maneira que seja ciente do -contexto: +A instrumentação deve ser escrita de uma maneira que seja ciente do contexto: - Bibliotecas que representam um ponto de entrada da aplicação (i.e. servidores HTTP, consumidores de mensagens, etc.) devem @@ -171,8 +171,8 @@ contexto: ## Convenção semântica {#semantic-conventions} -As [convenções semânticas](/docs/specs/semconv/) definem como produzir telemetria -para operações padrão. Entre outras coisas, as convenções semânticas +As [convenções semânticas](/docs/specs/semconv/) definem como produzir +telemetria para operações padrão. Entre outras coisas, as convenções semânticas especificam nomes e tipos de trechos, instrumentos de métrica, unidades de métricas, tipos de métricas, e atributos chave, valor, e níveis de requisitos. @@ -183,14 +183,13 @@ O OpenTelemetry Java [publica artefatos](../api/#semantic-attributes) para auxiliar a conformidade com a convenção semântica, incluindo constantes geradas para chaves e valores de atributos. - ## Instrumentação de Log {#log-instrumentation} -Enquanto as APIs do [LoggerProvider](../api/#loggerprovider) / [Logger](../api/#logger) - são estruturalmente similares ou equivalentes -às APIs de [rastros](../api/#tracerprovider) e [métricas](../api/#meterprovider), elas possuem -diferentes casos de uso. A partir de agora, `LoggerProvider` / `Logger` e -as classes associadas representam a +Enquanto as APIs do [LoggerProvider](../api/#loggerprovider) / +[Logger](../api/#logger) são estruturalmente similares ou equivalentes às APIs +de [rastros](../api/#tracerprovider) e [métricas](../api/#meterprovider), elas +possuem diferentes casos de uso. A partir de agora, `LoggerProvider` / `Logger` +e as classes associadas representam a [Log Bridge API](/docs/specs/otel/logs/api/), que existe para escrever anexadores de logs para conectar logs registrados através de outras APIs de log / frameworks no OpenTelemetry. Eles não são destinados para usuários finais como @@ -202,10 +201,10 @@ OpenTelemetry atendendo a diferentes requisitos de aplicação: ### Direto para o Collector {#direct-to-collector} No _workflow_ direto para o collector, logs são emitidos diretamente da -aplicação para o collector usando um protocolo de rede (ex. OTLP). Este _workflow_ -é simples para configurar já que não requer nenhum componente adicional de -encaminhamento de log, e permite que uma aplicação facilmente emita logs -estruturados em conformidade com o +aplicação para o collector usando um protocolo de rede (ex. OTLP). Este +_workflow_ é simples para configurar já que não requer nenhum componente +adicional de encaminhamento de log, e permite que uma aplicação facilmente emita +logs estruturados em conformidade com o [modelo de dados de log](/docs/specs/otel/logs/data-model/). No entanto, a sobrecarga necessária para as aplicações enfileirarem e exportarem os logs para um local de rede pode não ser adequada para todas as aplicações. @@ -218,25 +217,25 @@ Para usar este _workflow_: [Collector](https://github.com/open-telemetry/opentelemetry-collector) ou outro). -**[1]**: Anexadores de Logs são um tipo de [shim](#shims) que conecta logs de -um _framework_ na SDK de Logs do OpenTelemetry. Veja os items "Bridge Log4j em OpenTelemetry", -"Bridge Logback em OpenTelemetry". Veja +**[1]**: Anexadores de Logs são um tipo de [shim](#shims) que conecta logs de um +_framework_ na SDK de Logs do OpenTelemetry. Veja os items "Bridge Log4j em +OpenTelemetry", "Bridge Logback em OpenTelemetry". Veja [Exemplo de Anexadores de Logs](https://github.com/open-telemetry/opentelemetry-java-docs/tree/main/log-appender) para demonstração de uma variedade de cenários. ### Via arquivo ou stdout {#via-file-or-stdout} -No _workflow_ para arquivos ou _stdout_, os logs são gravados em arquivos ou na saída -_standout_. Outro componente (ex. FluentBit) é responsável por ler / acompanhar os logs, -convertê-los para um formato mais estruturado, e encaminhá-los para um destino, como um -Collector. Este _workflow_ pode ser preferível em situações onde os -requisitos da aplicação não permitem sobrecarga adicional da abordagem -[direto para o Collector](#direct-to-collector). No entanto, isso requer que todos -os campos de logs necessários para processamento posterior sejam codificados nos -logs, e este componente lendo os logs os interprete no -[modelo de dados de log](/docs/specs/otel/logs/data-model). A instalação e -configuração dos componentes de encaminhamento de log está fora do escopo deste -documento. +No _workflow_ para arquivos ou _stdout_, os logs são gravados em arquivos ou na +saída _standout_. Outro componente (ex. FluentBit) é responsável por ler / +acompanhar os logs, convertê-los para um formato mais estruturado, e +encaminhá-los para um destino, como um Collector. Este _workflow_ pode ser +preferível em situações onde os requisitos da aplicação não permitem sobrecarga +adicional da abordagem [direto para o Collector](#direct-to-collector). No +entanto, isso requer que todos os campos de logs necessários para processamento +posterior sejam codificados nos logs, e este componente lendo os logs os +interprete no [modelo de dados de log](/docs/specs/otel/logs/data-model). A +instalação e configuração dos componentes de encaminhamento de log está fora do +escopo deste documento. Correlação de Logs com rastros está disponível instalando um [shim](#shims) para conectar o contexto do OpenTelemetry no log framework. Veja os items "Bridge From f688842ae1a7e0445b90f4524f80994e343ece65 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Fri, 31 Jan 2025 08:59:19 -0300 Subject: [PATCH 125/129] Update content/pt/docs/languages/java/instrumentation.md 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/languages/java/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index 2df4f0d6870f..7470df58354a 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -200,7 +200,7 @@ OpenTelemetry atendendo a diferentes requisitos de aplicação: ### Direto para o Collector {#direct-to-collector} -No _workflow_ direto para o collector, logs são emitidos diretamente da +No _workflow_ direto para o Collector, logs são emitidos diretamente da aplicação para o collector usando um protocolo de rede (ex. OTLP). Este _workflow_ é simples para configurar já que não requer nenhum componente adicional de encaminhamento de log, e permite que uma aplicação facilmente emita From a22bf04efe6cace282a2bcf7847b68bc04ed30bc Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Fri, 31 Jan 2025 08:59:32 -0300 Subject: [PATCH 126/129] Update content/pt/docs/languages/java/instrumentation.md 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/languages/java/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index 7470df58354a..db3db7d59d6b 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -201,7 +201,7 @@ OpenTelemetry atendendo a diferentes requisitos de aplicação: ### Direto para o Collector {#direct-to-collector} No _workflow_ direto para o Collector, logs são emitidos diretamente da -aplicação para o collector usando um protocolo de rede (ex. OTLP). Este +aplicação para o Collector usando um protocolo de rede (ex. OTLP). Este _workflow_ é simples para configurar já que não requer nenhum componente adicional de encaminhamento de log, e permite que uma aplicação facilmente emita logs estruturados em conformidade com o From 525e1cd7ec7eecbbc159f674fceaff6309748c1b Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Fernandes?= Date: Fri, 31 Jan 2025 08:59:49 -0300 Subject: [PATCH 127/129] Update content/pt/docs/languages/java/instrumentation.md 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/languages/java/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index db3db7d59d6b..dd225555ed01 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -218,7 +218,7 @@ Para usar este _workflow_: outro). **[1]**: Anexadores de Logs são um tipo de [shim](#shims) que conecta logs de um -_framework_ na SDK de Logs do OpenTelemetry. Veja os items "Bridge Log4j em +_framework_ no SDK de Logs do OpenTelemetry. Veja os items "Bridge Log4j em OpenTelemetry", "Bridge Logback em OpenTelemetry". Veja [Exemplo de Anexadores de Logs](https://github.com/open-telemetry/opentelemetry-java-docs/tree/main/log-appender) para demonstração de uma variedade de cenários. From 0bddd82a3bd5c56a16ce7c7e8dc16c8e87c72f44 Mon Sep 17 00:00:00 2001 From: Patrice Chalin Date: Fri, 31 Jan 2025 13:52:36 -0500 Subject: [PATCH 128/129] Apply suggestions from code review Co-authored-by: Vitor Vasconcellos --- content/pt/docs/languages/java/instrumentation.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index dd225555ed01..43baac67df89 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -65,7 +65,7 @@ O projeto contém o código fonte do Agente Java, inicializador Spring Boot, e Biblioteca de instrumentação. -### Sem código: Agente Java +### Sem código: Agente Java {#zero-code-java-agent} O agente do Java é uma forma de [instrumentação automática](/docs/specs/otel/glossary/#automatic-instrumentation) @@ -77,7 +77,7 @@ coluna _"Auto-instrumented versions"_ (versões auto-instrumentadas) em Veja [Agente Java](/docs/zero-code/java/agent/) para mais detalhes. -### Sem código: inicializador Spring Boot +### Sem código: inicializador Spring Boot {#zero-code-spring-boot-starter} O inicializador Spring Boot é uma forma de [instrumentação automática](/docs/specs/otel/glossary/#automatic-instrumentation) @@ -128,7 +128,7 @@ Shims mantidos no ecossistema OpenTelemetry Java: | Bridge [OpenTracing](https://opentracing.io/) no OpenTelemetry | [LEIA-ME](https://github.com/open-telemetry/opentelemetry-java/tree/main/opentracing-shim) | Rastros | `io.opentelemetry:opentelemetry-opentracing-shim:{{% param vers.otel %}}` | | Bridge [Opencensus](https://opencensus.io/) no OpenTelemetry | [LEIA-ME](https://github.com/open-telemetry/opentelemetry-java/tree/main/opencensus-shim) | Rastros, Métricas | `io.opentelemetry:opentelemetry-opencensus-shim:{{% param vers.otel %}}-alpha` | | Bridge [Micrometer](https://micrometer.io/) no OpenTelemetry | [LEIA-ME](https://github.com/open-telemetry/opentelemetry-java-instrumentation/tree/main/instrumentation/micrometer/micrometer-1.5/library) | Métricas | `io.opentelemetry.instrumentation:opentelemetry-micrometer-1.5:{{% param vers.instrumentation %}}-alpha` | -| Bridge [JMX](https://docs.oracle.com/javase/7/docs/technotes/guides/management/agent.html) no OpenTelemetry | [LEIA-ME](https://github.com/open-telemetry/opentelemetry-java-instrumentation/blob/main/instrumentation/jmx-metrics/javaagent/LEIA-ME.md) | Métricas | `io.opentelemetry.instrumentation:opentelemetry-jmx-metrics:{{% param vers.instrumentation %}}-alpha` | +| Bridge [JMX](https://docs.oracle.com/javase/7/docs/technotes/guides/management/agent.html) no OpenTelemetry | [LEIA-ME](https://github.com/open-telemetry/opentelemetry-java-instrumentation/blob/main/instrumentation/jmx-metrics/javaagent/README.md) | Métricas | `io.opentelemetry.instrumentation:opentelemetry-jmx-metrics:{{% param vers.instrumentation %}}-alpha` | | Bridge OpenTelemetry no [Prometheus Java client](https://github.com/prometheus/client_java) | [LEIA-ME](https://github.com/open-telemetry/opentelemetry-java-contrib/tree/main/prometheus-client-bridge) | Métricas | `io.opentelemetry.contrib:opentelemetry-prometheus-client-bridge:{{% param vers.contrib %}}-alpha` | | Bridge OpenTelemetry no [Micrometer](https://micrometer.io/) | [LEIA-ME](https://github.com/open-telemetry/opentelemetry-java-contrib/tree/main/micrometer-meter-provider) | Métricas | `io.opentelemetry.contrib:opentelemetry-micrometer-meter-provider:{{% param vers.contrib %}}-alpha` | | Bridge [Log4j](https://logging.apache.org/log4j/2.x/index.html) no OpenTelemetry | [LEIA-ME](https://github.com/open-telemetry/opentelemetry-java-instrumentation/tree/main/instrumentation/log4j/log4j-appender-2.17/library) | Logs | `io.opentelemetry.instrumentation:opentelemetry-log4j-appender-2.17:{{% param vers.instrumentation %}}-alpha` | From 4e910b6a4bba819b6173df6973388e9861b55c80 Mon Sep 17 00:00:00 2001 From: opentelemetrybot <107717825+opentelemetrybot@users.noreply.github.com> Date: Fri, 31 Jan 2025 19:05:14 +0000 Subject: [PATCH 129/129] Results from /fix:all --- content/pt/docs/languages/java/instrumentation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt/docs/languages/java/instrumentation.md b/content/pt/docs/languages/java/instrumentation.md index 43baac67df89..3046e9ad7526 100644 --- a/content/pt/docs/languages/java/instrumentation.md +++ b/content/pt/docs/languages/java/instrumentation.md @@ -128,7 +128,7 @@ Shims mantidos no ecossistema OpenTelemetry Java: | Bridge [OpenTracing](https://opentracing.io/) no OpenTelemetry | [LEIA-ME](https://github.com/open-telemetry/opentelemetry-java/tree/main/opentracing-shim) | Rastros | `io.opentelemetry:opentelemetry-opentracing-shim:{{% param vers.otel %}}` | | Bridge [Opencensus](https://opencensus.io/) no OpenTelemetry | [LEIA-ME](https://github.com/open-telemetry/opentelemetry-java/tree/main/opencensus-shim) | Rastros, Métricas | `io.opentelemetry:opentelemetry-opencensus-shim:{{% param vers.otel %}}-alpha` | | Bridge [Micrometer](https://micrometer.io/) no OpenTelemetry | [LEIA-ME](https://github.com/open-telemetry/opentelemetry-java-instrumentation/tree/main/instrumentation/micrometer/micrometer-1.5/library) | Métricas | `io.opentelemetry.instrumentation:opentelemetry-micrometer-1.5:{{% param vers.instrumentation %}}-alpha` | -| Bridge [JMX](https://docs.oracle.com/javase/7/docs/technotes/guides/management/agent.html) no OpenTelemetry | [LEIA-ME](https://github.com/open-telemetry/opentelemetry-java-instrumentation/blob/main/instrumentation/jmx-metrics/javaagent/README.md) | Métricas | `io.opentelemetry.instrumentation:opentelemetry-jmx-metrics:{{% param vers.instrumentation %}}-alpha` | +| Bridge [JMX](https://docs.oracle.com/javase/7/docs/technotes/guides/management/agent.html) no OpenTelemetry | [LEIA-ME](https://github.com/open-telemetry/opentelemetry-java-instrumentation/blob/main/instrumentation/jmx-metrics/javaagent/README.md) | Métricas | `io.opentelemetry.instrumentation:opentelemetry-jmx-metrics:{{% param vers.instrumentation %}}-alpha` | | Bridge OpenTelemetry no [Prometheus Java client](https://github.com/prometheus/client_java) | [LEIA-ME](https://github.com/open-telemetry/opentelemetry-java-contrib/tree/main/prometheus-client-bridge) | Métricas | `io.opentelemetry.contrib:opentelemetry-prometheus-client-bridge:{{% param vers.contrib %}}-alpha` | | Bridge OpenTelemetry no [Micrometer](https://micrometer.io/) | [LEIA-ME](https://github.com/open-telemetry/opentelemetry-java-contrib/tree/main/micrometer-meter-provider) | Métricas | `io.opentelemetry.contrib:opentelemetry-micrometer-meter-provider:{{% param vers.contrib %}}-alpha` | | Bridge [Log4j](https://logging.apache.org/log4j/2.x/index.html) no OpenTelemetry | [LEIA-ME](https://github.com/open-telemetry/opentelemetry-java-instrumentation/tree/main/instrumentation/log4j/log4j-appender-2.17/library) | Logs | `io.opentelemetry.instrumentation:opentelemetry-log4j-appender-2.17:{{% param vers.instrumentation %}}-alpha` |