Managed Service for OpenTelemetry:Início rápido

Pré-requisitos

• Criar uma conta Alibaba CloudCrie uma conta Alibaba Cloud.

• Ative o Managed Service for OpenTelemetry

• Obter um endpoint

  New console

  1. Faça login 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

     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.

     

  Old console

  1. Faça login 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 sua aplicação estiver implantada em um ambiente de produção da Alibaba Cloud, utilize 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 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 console do Managed Service for OpenTelemetry ou no .

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.

   No console do Managed Service for OpenTelemetry, acesse a página Applications e selecione sua 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.