Este documento foi traduzido usando tecnologia de tradução automática de máquina. Sempre trabalhamos para apresentar traduções precisas, mas não oferecemos nenhuma garantia em relação à integridade, precisão ou confiabilidade do conteúdo traduzido. Em caso de qualquer discrepância, a versão original em inglês prevalecerá e constituirá o texto official.

Aplicativos Java

O SDK Java suporta a instrumentação de aplicativos na JVM. Como resultado, ele não apenas suporta Java, mas também outras linguagens da JVM, como Kotlin e Scala.

Instrumentação automática

A instrumentação automática para Java usa um JAR de agente Java que pode ser anexado a qualquer aplicativo Java 8 ou superior. Ele injeta dinamicamente bytecode para capturar telemetria de muitas bibliotecas e frameworks populares, incluindo várias bibliotecas Kotlin e Scala. Pode ser usado para capturar dados de telemetria no “edges” de um aplicativo ou serviço, como requisições de entrada, chamadas HTTP de saída, chamadas de banco de dados, e assim por diante.

A instrumentação automática não requer nenhuma modificação do aplicativo. Para configurá-la, siga estas etapas:

  1. Baixe opentelemetry-javaagent.jar da página de Releases do repositório opentelemetry-java-instrumentation e inclua o arquivo JAR na imagem docker do seu aplicativo. O arquivo JAR contém o agente e as bibliotecas de instrumentação.

  2. Atualize o comando que inicia seu aplicativo para carregar o agente Java, seja atualizando o ponto de entrada ou comando da imagem docker ou atualizando o command no manifesto do Kubernetes para seu aplicativo. Adicione -javaagent:/path/to/opentelemetry-javaagent.jar:

    java -javaagent:/path/to/opentelemetry-javaagent.jar -jar myapp.jar

  3. Implante seu aplicativo com as variáveis de ambiente extras para configurar o nome do serviço e o endpoint do exportador, os protocolos suportados são gRPC e protobuf sobre HTTP.

  4. Verifique se o SUSE Observability está recebendo rastros e/ou métricas pesquisando as métricas / rastros no explorador de métricas / rastros para o nome do seu serviço

Para mais detalhes, consulte a documentação do Open Telemetry.

Instrumentação manual

A instrumentação manual pode ser usada quando você precisa de métricas, rastros ou logs de partes do código que não são suportadas pela instrumentação automática. Por exemplo, bibliotecas não suportadas, código interno ou métricas de nível de negócios.

Para capturar esses dados, você precisa modificar seu aplicativo.

  1. Inclua o SDK do Open Telemetry como uma dependência

  2. Adicione código ao seu aplicativo para capturar métricas, spans ou logs quando necessário

Há documentação detalhada sobre isso nas Páginas de documentação do SDK Java do Open Telemetry.

Certifique-se de usar o exportador OTLP (este é o padrão) e auto-configuração. Ao implantar o aplicativo, o nome do serviço e o exportador são configurados via variáveis de ambiente.

Métricas no SUSE Observability

Para algumas métricas Java, por exemplo, métricas do coletor de lixo, o SUSE Observability definiu gráficos sobre os componentes relacionados. Para Kubernetes, os gráficos estão disponíveis nos pods. É possível adicionar gráficos para mais métricas, isso funciona para métricas de instrumentação automática, mas também para métricas específicas do aplicativo de instrumentação manual.