Managed Service for OpenTelemetry:Guia de início rápido

Pré-requisitos

• Create an Alibaba Cloud accountCrie uma conta Alibaba Cloud.

• Ative o Managed Service for OpenTelemetry

• Obter um endpoint

  New console

  1. Faça logon no console do Managed Service for OpenTelemetry. No painel de navegação à esquerda, clique em Integration Center.

  2. Na página Integration Center, clique no cartão OpenTelemetry na seção Open Source Frameworks.

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

     Nota

     Os recursos são inicializados automaticamente ao acessar uma região pela primeira vez.

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

     • Connection Type: se o serviço estiver implantado na Alibaba Cloud e residir na região selecionada, defina 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.

     

  Old console

  1. Faça logon no console do Managed Service for OpenTelemetry.

  2. No painel de navegação à esquerda, clique em Cluster Configurations. Na página exibida, clique na aba Access point information.

  3. Na barra de navegação superior, selecione a região para envio dos dados. Na seção Cluster Information, ative a opção Show Token.

  4. Defina o parâmetro Client como OpenTelemetry.

     Na coluna Related Information da tabela, copie um endpoint.

     Nota

     Se a aplicação estiver implantada em um ambiente de produção da Alibaba Cloud, use um endpoint de VPC. Caso contrário, use um endpoint público.

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 usa o agente Java do OpenTelemetry com uma aplicação Java como exemplo:

1. Baixe uma aplicação de demonstração: baixe a demo para experimentar 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 enviar os rastreamentos.

3. Visualize os dados de monitoramento: consulte os dados de telemetria no console do Managed Service for OpenTelemetry ou no .

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

Use 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 da aplicação Java para enviar os 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 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. Use as opções Slow Trace Analysis e Error Trace Analysis para identificar fatores que causam chamadas lentas.

   No console do Managed Service for OpenTelemetry, acesse a página Applications e selecione a aplicação para visualizar os rastreamentos.

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.