Este tópico descreve como enviar dados de rastreamento do OpenTelemetry para o ARMS e como utilizar essas informações.
Enviar dados de rastreamento do OpenTelemetry
O ARMS oferece suporte a diversos métodos para receber dados de rastreamento do OpenTelemetry. É possível enviar os dados diretamente ao ARMS ou encaminhá-los por meio de um OpenTelemetry Collector.
Relatório direto
-
Relatar dados de rastreamento usando o ARMS Java Agent e o OpenTelemetry Java SDK
Utilize o ARMS Java Agent v2.7.1.3 ou posterior para coletar automaticamente dados de rastreamento de componentes comuns e instrumentar métodos personalizados com o OpenTelemetry SDK. Para obter mais informações, consulte Adicionar instrumentação personalizada a um rastreamento usando o OpenTelemetry Java SDK.
-
Relatar dados de rastreamento diretamente com o OpenTelemetry
Também é possível instrumentar sua aplicação com o OpenTelemetry SDK e enviar dados de rastreamento diretamente usando um Jaeger Exporter. Para mais detalhes, veja Relatar dados de uma aplicação Java usando o OpenTelemetry.
Encaminhar dados por meio de um OpenTelemetry Collector
Forward trace data using the ARMS for OpenTelemetry Collector
Em um ambiente Container Service for Kubernetes (ACK), instale o ARMS for OpenTelemetry Collector com um único clique para encaminhar dados de rastreamento. O ARMS for OpenTelemetry Collector fornece estatísticas sem perdas, em que a pré-agregação local garante que as métricas não sejam afetadas pela taxa de amostragem. Ele também oferece ajuste dinâmico de parâmetros, gerenciamento de estado e um painel de rastreamento pronto para uso no Grafana. Este collector é fácil de usar, estável e confiável.
Siga estas etapas para instalar o ARMS for OpenTelemetry Collector:
-
Instale o ARMS for OpenTelemetry Collector a partir do catálogo de aplicativos no console do ACK.
No painel de navegação à esquerda do console do Container Service for Kubernetes, clique em Cluster.
Na página Clusters, clique no nome do cluster desejado e escolha no painel de navegação à esquerda.
-
Na página de topologia do cluster, clique em Install.
O console do ACK instala automaticamente o componente ack-arms-cmonitor.
NotaO namespace padrão é arms-prom.
Após concluir a instalação, selecione no painel de navegação à esquerda. Na parte superior da página, selecione o namespace arms-prom.
-
Clique em cmonitor-agent e, na aba Access Method, clique em otel-collector-service.
Verifique se o otel-collector-service (Service) está em execução. A instalação foi bem-sucedida se o serviço expuser várias portas de receiver para receber dados do OpenTelemetry, conforme mostra a figura a seguir.
-
Altere o endpoint do exporter no SDK da sua aplicação para
otel-collector-service:Port.
Forward trace data using the open-source OpenTelemetry Collector
Para encaminhar dados de rastreamento ao ARMS usando o OpenTelemetry Collector open-source, modifique o endpoint e o token de autenticação na configuração do exporter.
exporters:
otlp:
endpoint: <endpoint>:8090
tls:
insecure: true
headers:
Authentication: <token>Substitua
<endpoint>pelo endpoint da sua região. Exemplo:http://tracing-analysis-dc-bj.aliyuncs.com:8090.Substitua
<token>pelo token obtido no console. Exemplo:b590lhguqs@3a7*********9b_b590lhguqs@53d*****8301.
Utilizar rastreamentos do OpenTelemetry
Para ajudar você a extrair o máximo de valor dos seus dados de rastreamento do OpenTelemetry, o ARMS oferece diversos recursos de diagnóstico, incluindo detalhes de rastreamento, painéis de métricas pré-agregadas, análise de métricas pós-agregadas no Trace Explorer e correlação entre rastreamentos e logs de serviço.
-
Detalhes do rastreamento
O lado esquerdo do painel de detalhes do rastreamento exibe a sequência de chamadas e a latência das APIs no rastreamento. O lado direito apresenta o contexto detalhado e as métricas relacionadas, como SQL de banco de dados, métricas da JVM e métricas do host.
-
Painéis de métricas pré-agregadas
O ARMS disponibiliza vários painéis de métricas pré-agregadas com base nos dados de rastreamento do OpenTelemetry, incluindo painéis para visão geral da aplicação, chamadas de API e chamadas de banco de dados. Para saber mais, consulte Visão geral da aplicação.
-
Análise de métricas pós-agregadas no Trace Explorer
O ARMS oferece filtragem multidimensional flexível e análise de métricas pós-agregadas para dados de rastreamento do OpenTelemetry. Por exemplo, pesquise rastreamentos anômalos em uma aplicação específica ou agregue dados de rastreamento por dimensões como endereço IP e API. Para mais informações, veja Trace Explorer.
-
Correlacionar rastreamentos com logs de serviço
O ARMS correlaciona rastreamentos do OpenTelemetry com logs de serviço para auxiliar na solução de problemas de exceções de serviço sob a perspectiva da API. Para detalhes adicionais, consulte Identificar exceções de serviço usando rastreamentos e logs.
