Todos os produtos
Search
Central de documentação

:Integração com Kafka

Última atualização: Sep 18, 2026

Após configurar a integração, o Managed Service for Prometheus coleta métricas de desempenho do Kafka, viabilizando o monitoramento em tempo real e a análise de dados.

Pré-requisitos

Container cluster

ECS (VPC)

Integrar o Kafka

  1. Acesse o console do Managed Service for Prometheus. No painel de navegação à esquerda, clique em Integration Center.

  2. Clique no card Kafka e siga as instruções na tela para concluir a integração. As tabelas a seguir descrevem os principais parâmetros.

    Container cluster

    Parameter

    Description

    pod label selector

    A chave e o valor do rótulo configurados para o pod durante a implantação do agente JMX. O Managed Service for Prometheus usa esse rótulo para a descoberta de serviços. Para obter mais informações, consulte Deploy and configure a Kafka JMX agent.

    metric collection interval

    The interval for collecting monitoring data. The default value is 15.

    ECS (VPC)

    Parameter

    Description

    Kafka cluster name

    Atribua um nome de cluster exclusivo a cada integração para evitar coleta duplicada de métricas e resultados incorretos no painel.

    Endpoint

    O endereço IP ou nome DNS de um broker Kafka. Separe vários endereços com vírgulas ou ponto e vírgulas.

    Exemplo: 192.168.0.1:9092,10.0.11.123:9092

    Enable SASL

    Selecione esta opção se o servidor Kafka usar SASL.

    SASL Username

    Se o SASL estiver ativado, insira o nome de usuário.

    SASL Password

    Se o SASL estiver ativado, insira a senha.

    SASL Mechanism

    Selecione o mecanismo SASL. Valores válidos: plain, scram-sha512 e scram-sha256.

    Enable TLS

    Selecione esta opção se o servidor Kafka usar TLS.

    Ignore TLS security verification

    Se o TLS estiver ativado no servidor Kafka e você usar um certificado autoassinado, selecione esta opção para ignorar a verificação de segurança TLS.

    metric collection interval

    The interval for collecting monitoring data. The default value is 15.

    Custom Tags

    Adicione tags às métricas da instância ECS para monitorar, gerenciar, consultar ou analisar os dados de métrica de forma granular ao usar ferramentas como o Grafana. Para obter mais informações, consulte Add custom tags to ECS instance metrics in a VPC.

    Nota
    • Uma chave de tag não pode conter caracteres especiais usados na funcionalidade do Prometheus, como hífens (-), pontos (.) ou sinais de porcentagem (%).

    • As tags devem ser especificadas no formato chave-valor exigido pelo Prometheus.

Visualizar o status dos componentes do Kafka

O componente instalado é exibido na página Integration Management do console do Managed Service for Prometheus. A página Integration Management é composta pelas abas Integrated Environments, Integrated Addons e Query Dashboards, nas quais é possível visualizar informações como targets, métricas, painéis e alertas.

Targets

Nesta aba, visualize a lista de targets descobertos pelos jobs de integração padrão.

A página Targets exibe informações de cada target de coleta, incluindo Endpoint, State, Labels, Last Scrape, Scrape Duration e Error. Quando o State de um target está DOWN (rótulo vermelho), a coluna Error apresenta o motivo específico, como connection refused. Isso indica que o endpoint do target está inacessível; verifique se a porta de service na instância está em escuta.

Coleta de métricas

Nesta aba, visualize informações detalhadas sobre métricas e configure métricas a serem descartadas. Para obter mais informações, consulte Configure metrics to be dropped.

Na aba Metric Scraping, selecione Custom Scrape para ver a lista de tarefas de coleta configuradas. A lista inclui o nome, o nome do job, o componente associado, o método de descoberta de serviços, o caminho de coleta e o intervalo de coleta. Por exemplo, para as tarefas kafka e ecs-node-exporter, o método de descoberta de serviços é kubernetes_sd_configs, o caminho de coleta é /metrics e o intervalo de coleta é 15s. Para cada tarefa, é possível selecionar Disable, View Config ou Delete. Para adicionar uma nova tarefa de coleta, clique em Add.

Painéis

Clique no nome de um painel para acessar o dashboard correspondente no Grafana.

Na aba Dashboards, pesquise painéis pelo nome ou filtre por tags, como Kafka. A tabela exibe os nomes dos painéis e suas respectivas tags. Por exemplo, um painel Kafka Basic é incluído por padrão.

O painel Prometheus Agent, por exemplo, oferece filtros suspensos de job, instance e agent. Seus painéis exibem informações sobre Agent Status, diversos erros (como Agent Discovery/Scrape Errors, Agent Configuration Delivery Errors e Agent Scrape Processing Errors) e a Agent Version. Na parte inferior, a tabela Agent Overview apresenta métricas como agent name, heartbeat, targets, series, writeArms, pod_name, memoryUsed, memoryLimit, cpuUsed e cpuLimit.

Documentos relacionados