O Managed Service for OpenTelemetry aceita dados de rastreamento de clientes OpenTelemetry, Jaeger, Zipkin e SkyWalking. Este guia orienta você na ativação do service, na obtenção do token de autenticação e na conexão da aplicação para começar a enviar rastreamentos.
Pré-requisitos
Uma conta Alibaba Cloud. Caso não possua uma, crie uma conta.
Ative o Managed Service for OpenTelemetry na página do product.
Obtenha seu token de autenticação
Após ativar o service, obtenha um token para autenticar os dados de rastreamento enviados pela aplicação. Os passos variam entre as versões nova e antiga do console.
New console
Faça login no console do Managed Service for OpenTelemetry.
No painel de navegação à esquerda, clique em Integration Center.
Na seção Open Source Frameworks, clique no cartão OpenTelemetry ou no cartão do cliente desejado.
-
No painel exibido, copie o token.
No painel exibido, conclua a configuração: selecione uma região, como china (Hangzhou). Para o método de conexão, escolha o endpoint privado se a aplicação estiver implantada em um ambiente de produção da Alibaba Cloud ou o endpoint público para outros casos. Quanto ao método de relatório, selecione HTTP (recomendado) ou gRPC. Após concluir a configuração, obtenha a URL do endpoint na seção Access point information. Por exemplo, ao relatar dados via HTTP, copie o endpoint privado. A URL do endpoint contém o token.
Old console
Faça login no console do Managed Service for OpenTelemetry.
No painel de navegação à esquerda, clique em Cluster Configurations e, em seguida, na aba Access point information.
Selecione uma região no topo da página e ative a chave Show Token na seção Cluster Information.
Na seção Client, selecione OpenTelemetry ou o cliente desejado.
-
Copie o endpoint da coluna Related Information.
Tomando o OpenTelemetry como exemplo, a coluna Related Information exibe as seguintes informações de ponto de acesso:
Relatório de dados via HTTP: há um endpoint público e um privado disponíveis. A URL segue o formato:
http://tracing-analysis-dc-{region}.aliyuncs.com/adapt_{token}/api/otlp/traces.Relatório de dados via gRPC: há um endpoint público (porta 8090), um endpoint privado (porta 8090) e o token de autenticação disponíveis.
Dica na parte inferior: ao usar Golang para relatar dados, remova
http://do endpoint.
Uso do token por protocolo
A forma de transmissão do token depende do protocolo utilizado:
Protocolos baseados em HTTP (OpenTelemetry HTTP, Jaeger HTTP, Zipkin HTTP): o token está incorporado na URL do endpoint.
Protocolos baseados em gRPC (OpenTelemetry gRPC, Jaeger gRPC, SkyWalking gRPC): defina
Authentication=<token>nosmetadatado gRPC.
Conecte sua aplicação
Escolha um endpoint
Cada região oferece dois tipos de endpoint:
Endpoint privado: destinado a aplicações implantadas em um ambiente de produção da Alibaba Cloud.
Endpoint público: indicado para aplicações executadas fora da Alibaba Cloud.
Protocolos e portas compatíveis
Todos os protocolos compartilham o mesmo domínio de endpoint. O número da porta e o caminho da URL diferenciam cada protocolo.
|
Porta |
Protocolo |
Caminho da URL |
|
8090 |
OpenTelemetry gRPC |
N/A |
|
80 |
OpenTelemetry HTTP |
|
|
80 |
Jaeger HTTP |
|
|
80 |
Jaeger Remote Sampling |
|
|
80 |
Zipkin HTTP v1 |
|
|
80 |
Zipkin HTTP v2 |
|
|
443 |
OpenTelemetry HTTPS |
|
|
443 |
Jaeger HTTPS |
|
|
443 |
Jaeger Remote Sampling (HTTPS) |
|
|
443 |
Zipkin HTTPS v1 |
|
|
443 |
Zipkin HTTPS v2 |
|
|
1883 |
Jaeger gRPC |
N/A |
|
1883 |
SkyWalking gRPC |
N/A |
|
8000 |
SkyWalking v8 gRPC |
N/A |
Regiões e endpoints
Para aplicações implantadas em um ambiente de produção da Alibaba Cloud, utilize um endpoint privado. Caso contrário, use um endpoint público.
|
Região |
ID da região |
Endpoint privado |
Endpoint público |
|
china (Hangzhou) |
cn-hangzhou |
tracing-analysis-dc-hz-internal.aliyuncs.com |
tracing-analysis-dc-hz.aliyuncs.com |
|
china (Shanghai) |
cn-shanghai |
tracing-analysis-dc-sh-internal.aliyuncs.com |
tracing-analysis-dc-sh.aliyuncs.com |
|
china (Qingdao) |
cn-qingdao |
tracing-analysis-dc-qd-internal.aliyuncs.com |
tracing-analysis-dc-qd.aliyuncs.com |
|
china (Beijing) |
cn-beijing |
tracing-analysis-dc-bj-internal.aliyuncs.com |
tracing-analysis-dc-bj.aliyuncs.com |
|
china (Zhangjiakou) |
cn-zhangjiakou |
tracing-analysis-dc-zb-internal.aliyuncs.com |
tracing-analysis-dc-zb.aliyuncs.com |
|
china (Hohhot) |
cn-huhehaote |
tracing-cn-huhehaote-internal.arms.aliyuncs.com |
tracing-cn-huhehaote.arms.aliyuncs.com |
|
china (Ulanqab) |
cn-wulanchabu |
tracing-cn-wulanchabu-internal.arms.aliyuncs.com |
tracing-cn-wulanchabu.arms.aliyuncs.com |
|
china (Shenzhen) |
cn-shenzhen |
tracing-analysis-dc-sz-internal.aliyuncs.com |
tracing-analysis-dc-sz.aliyuncs.com |
|
china (Heyuan) |
cn-heyuan |
tracing-cn-heyuan-internal.arms.aliyuncs.com |
tracing-cn-heyuan.arms.aliyuncs.com |
|
china (Guangzhou) |
cn-guangzhou |
tracing-cn-guangzhou-internal.arms.aliyuncs.com |
tracing-cn-guangzhou.arms.aliyuncs.com |
|
china (Chengdu) |
cn-chengdu |
tracing-cn-chengdu-internal.arms.aliyuncs.com |
tracing-cn-chengdu.arms.aliyuncs.com |
|
china (Hong Kong) |
cn-hongkong |
tracing-analysis-dc-hk-internal.aliyuncs.com |
tracing-analysis-dc-hk.aliyuncs.com |
|
Japan (Tokyo) |
ap-northeast-1 |
tracing-analysis-dc-jp-internal.aliyuncs.com |
tracing-analysis-dc-jp.aliyuncs.com |
|
Singapore |
ap-southeast-1 |
tracing-analysis-dc-sg-internal.aliyuncs.com |
tracing-analysis-dc-sg.aliyuncs.com |
|
Malaysia (Kuala Lumpur) |
ap-southeast-3 |
tracing-ap-southeast-3-internal.arms.aliyuncs.com |
tracing-ap-southeast-3.arms.aliyuncs.com |
|
Indonesia (Jakarta) |
ap-southeast-5 |
tracing-analysis-dc-indonesia-internal.aliyuncs.com |
tracing-analysis-dc-indonesia.aliyuncs.com |
|
Germany (Frankfurt) |
eu-central-1 |
tracing-analysis-dc-frankfurt-internal.aliyuncs.com |
tracing-analysis-dc-frankfurt.aliyuncs.com |
|
UK (London) |
eu-west-1 |
tracing-analysis-dc-lundun-internal.aliyuncs.com |
tracing-analysis-dc-lundun.aliyuncs.com |
|
US (Silicon Valley) |
us-west-1 |
tracing-analysis-dc-usw-internal.aliyuncs.com |
tracing-analysis-dc-usw.aliyuncs.com |
|
US (Virginia) |
us-east-1 |
tracing-us-east-1-internal.arms.aliyuncs.com |
tracing-us-east-1.arms.aliyuncs.com |
|
SAU (Riyadh - Partner Region) |
me-central-1 |
tracing-me-central-1-internal.arms.aliyuncs.com |
tracing-me-central-1.arms.aliyuncs.com |
Requisitos de rede para aplicações fora da Alibaba Cloud
Se a aplicação for executada fora da Alibaba Cloud, garanta que as portas e os domínios a seguir estejam acessíveis na sua rede antes de enviar dados de rastreamento.
Portas a liberar:
|
Porta |
Protocolo |
|
8090 |
OpenTelemetry gRPC |
|
80 |
OpenTelemetry HTTP, Jaeger HTTP |
|
443 |
OpenTelemetry HTTPS, Jaeger HTTPS, Zipkin HTTPS |
|
1883 |
Jaeger gRPC, SkyWalking gRPC |
|
8000 |
SkyWalking v8 gRPC |
Domínios a liberar: utilize o domínio do endpoint público correspondente à sua região na tabela Regiões e endpoints acima.