O OpenTelemetry eBPF Instrumentation (OBI) é executado como um DaemonSet nos nós do cluster ACK e coleta automaticamente traces e métricas sem exigir alterações no código. O Integration Center no CloudMonitor CMS 2.0 oferece uma configuração simplificada para ativar o monitoramento OBI em aplicações ACK.
Contexto
O OBI é um componente de auto-instrumentação para Kubernetes baseado em eBPF. Implantado como um DaemonSet nos nós do cluster, ele intercepta chamadas de rede da aplicação no nível do kernel para coletar métricas e traces sem necessidade de mudanças no código ou injeção de sidecar. Os dados coletados são enviados ao CloudMonitor CMS 2.0 por meio do OpenTelemetry Protocol (OTLP).
O OBI descobre automaticamente os seguintes protocolos e frameworks:
|
Categoria |
Protocolos e frameworks |
|
Protocolos de rede |
HTTP, gRPC, SQL (MySQL/PostgreSQL), Redis, Kafka |
|
Frameworks de GenAI |
OpenAI, Anthropic, Tongyi Qianwen, MCP, Embedding, Rerank |
Escolha um método de integração
Há dois métodos disponíveis para ativar o monitoramento OBI em aplicações de clusters ACK:
|
Aspecto |
Integration Center (este tópico) |
Instalação manual via Helm |
|
Caso de uso |
Recomendado para clusters ACK que precisam de uma configuração rápida e sem personalizações. |
Indicado para clusters Kubernetes de uso geral, inclusive ambientes fora da Alibaba Cloud, que exigem configurações personalizadas. |
|
Método |
Processo simples de três etapas realizado no console. |
Requer uso da linha de comando e edição de um arquivo de configuração. |
|
Versão do Kubernetes |
Recomendada: 1.26.0 ou posterior |
1,24 ou posterior |
Para utilizar a instalação manual via Helm, consulte Enable observability for general-purpose Kubernetes environments by using OpenTelemetry OBI.
Pré-requisitos
Suas aplicações devem estar implantadas em um cluster ACK.
Recomenda-se a versão 1.26.0 ou superior do Kubernetes. Se a versão do seu cluster for anterior à 1.26.0, o Integration Center pode não identificar o cluster corretamente.
Etapa 1: Integrar aplicações
Use o Integration Center no CloudMonitor CMS 2.0 para selecionar o cluster ACK e as aplicações desejadas e, em seguida, ativar o monitoramento OBI.
Faça login no console do CloudMonitor CMS 2.0 e selecione o workspace desejado.
No painel de navegação à esquerda, clique em Integration Center.
-
Na categoria Application Monitoring & Tracing, localize e clique em OpenTelemetry Codeless Monitoring.
Um painel de integração será exibido no lado direito da página com as etapas do processo.
Na etapa Select acs.ack.cluster, selecione a região e o cluster ACK desejados.
Na etapa Integration Configurations, selecione as aplicações a serem monitoradas e insira um nome para a aplicação. É possível selecionar várias aplicações simultaneamente.
Clique em OK. Após concluir a configuração, visualize o resultado da integração na etapa Check Integration Status.
Etapa 2: Visualizar dados de monitoramento
O OBI verifica os processos da aplicação alvo e inicia a coleta de dados. As informações de monitoramento ficam disponíveis na página Application Monitoring após aproximadamente 2 a 3 minutos.
Para monitorar aplicações que utilizam o protocolo gRPC, reinicie os Pods correspondentes para concluir a integração do monitoramento gRPC.
Faça login no console do CloudMonitor CMS 2.0 e selecione o workspace desejado.
No painel de navegação à esquerda, selecione Application Monitoring para visualizar a lista de aplicações integradas.
-
Clique em nome da aplicação desejada para visualizar os seguintes dados de monitoramento:
Application Topology: Exibe as relações de chamada entre a aplicação e seus serviços upstream e downstream.
Traces: Visualize o trace completo de uma única requisição, incluindo a duração e o status de cada span.
Error transactions: Consulte detalhes das requisições com falha.
Slow transactions: Liste requisições cujos tempos de resposta ultrapassaram o limiar definido.
SQL Analysis: Analise métricas de desempenho das chamadas ao banco de dados.
Desinstalar o monitoramento OBI
Para desinstalar o monitoramento OBI, exclua a configuração de monitoramento:
Faça login no console do CloudMonitor CMS 2.0 e selecione o workspace desejado.
No painel de navegação à esquerda, clique em Integration Center > Integrations.
Na página Integrations, localize a integração correspondente ao cluster desejado e clique em Delete.
Após a exclusão, os dados de monitoramento geralmente param de ser atualizados dentro de 2 a 3 minutos.