Application Real-Time Monitoring Service:Início rápido

Pré-requisitos

• Criar uma conta Alibaba CloudCrie uma conta Alibaba Cloud.

• Ative o Managed Service for OpenTelemetry

• Obter um endpoint

  1. Faça login no console do ARMS. No painel de navegação à esquerda, clique em Integration Center.

  2. Na página Integration Center, clique no cartão OpenTelemetry na seção Server-side Applications.

  3. No painel OpenTelemetry, clique na aba Start Integration e selecione a região para envio dos dados.

     Nota

     Ao acessar uma região pela primeira vez, os recursos são inicializados automaticamente nesse local.

  4. Configure os parâmetros Connection Type e Export Protocol e copie um endpoint.

     • Connection Type: Se o service estiver implantado na Alibaba Cloud e residir na região selecionada, recomendamos definir este parâmetro como Alibaba Cloud VPC Network. Caso contrário, defina como Public Network.

     • Export Protocol: Defina este parâmetro como HTTP (recomendado) ou gRPC, conforme o protocolo compatível com o cliente.

     

Visão geral

A página de detalhes de rastreamento do console legado exibe o rastreamento completo de uma requisição HTTP 404. A linha do tempo à esquerda mostra cinco spans hierárquicos: GET / (404, 11,1ms), ResourceHttpRequestHandler.handleRequest (85μs), ResponseFacade.sendError (19μs), BasicErrorController.errorHtml (4,92ms) e Render error** (4,34ms). A seção superior apresenta o TraceID, hora de início, duração total e um indicador de erro em vermelho. O painel Span Details, à direita, exibe o nome da aplicação java-agent-usage-0.0.1-SNAPSHOT, o nome da interface BasicErrorController.errorHtml, o spanId, parentSpanId e atributos como ali.trace.component_type=98, ali.trace.flag=x-trace e thread.name=http-nio-8081-exec-1.

Este guia utiliza o agente Java do OpenTelemetry com uma aplicação Java como exemplo:

1. Baixe uma aplicação de demonstração: Baixe a demo para testar o Managed Service for OpenTelemetry ou instrumente sua própria aplicação.

2. Instrumente sua aplicação com o agente Java do OpenTelemetry: Baixe o agente Java do OpenTelemetry para obter instrumentação automática não intrusiva em centenas de frameworks Java. Modifique os parâmetros de inicialização da JVM para reportar rastreamentos.

3. Visualize os dados de monitoramento: Consulte os dados de telemetria no ou no console do ARMS.

Etapa 1: Baixar a aplicação de demonstração

Utilize a aplicação de demonstração fornecida ou sua própria aplicação Java.

Baixe o código de demonstração: Demo do Agente Java OpenTelemetry.

Etapa 2: Instrumentar a aplicação

O agente Java do OpenTelemetry oferece instrumentação automática não intrusiva para centenas de frameworks Java, listados em Bibliotecas e Versões Suportadas.

1. Baixe o Agente Java do OpenTelemetry.

   Na seção Assets da versão mais recente, baixe o arquivo opentelemetry-javaagent.jar.

2. Modifique os parâmetros da VM no comando de inicialização do Java para reportar rastreamentos.

   -javaagent:/{user.workspace}/opentelemetry-javaagent.jar    // Replace {user.workspace} with the actual path where you downloaded the file.
   -Dotel.resource.attributes=service.name=<appName>     // Replace <appName> with your application name.
   -Dotel.exporter.otlp.headers=Authentication=<token>    // Use the token from the endpoint information obtained in the prerequisites.
   -Dotel.exporter.otlp.endpoint=<endpoint>  // Use the endpoint from the endpoint information obtained in the prerequisites.

   Por exemplo, se o seu comando de inicialização for:

   java -jar /{user.workspace}/java-agent-usage-0.0.1-SNAPSHOT.jar

   Para conectar ao Managed Service for OpenTelemetry, atualize o comando para:

   java -Dotel.resource.attributes=service.name=java-agent-usage-0.0.1-SNAPSHOT -Dotel.exporter.otlp.headers=Authentication=ggxw4l****@7323a5caae30263_ggxw4l****@53df7ad2afe**** -Dotel.exporter.otlp.endpoint=http://tracing-analysis-dc-hz.aliyuncs.com:8090 -javaagent:/{user.workspace}/opentelemetry-javaagent.jar -jar /{user.workspace}/java-agent-usage-0.0.1-SNAPSHOT.jar

Etapa 3: Visualizar dados de monitoramento

1. Acesse a aplicação de demonstração em localhost:8081/user/async. O agente coleta e envia dados de telemetria para o Managed Service for OpenTelemetry.

2. Na página de detalhes da aplicação, clique na aba Trace Analysis para visualizar gráficos de número de chamadas, erros e latência média. A lista de rastreamentos exibe detalhes como TraceID, Nome da Interface, Nome da Aplicação, Latência, Status, Hora de Início e Endereço do Host. Utilize as opções Slow Trace Analysis e Error Trace Analysis para identificar fatores que causam chamadas lentas.

   Faça login no console do ARMS. No painel de navegação à esquerda, escolha Application Monitoring > Applications. Na página Applications, clique no nome da aplicação. Na página exibida, visualize os dados de rastreamento.

   Nota

   Se o ícone aparecer na coluna Language, a aplicação está conectada ao Application Monitoring. Se um hífen (-) for exibido, a aplicação está conectada ao Managed Service for OpenTelemetry.

Próximas etapas

O Managed Service for OpenTelemetry suporta Java, Go, Python, JavaScript, .NET, C++, entre outros. Os clientes compatíveis incluem OpenTelemetry, Jaeger, Zipkin e SkyWalking.