DEV Community

Mike Fortes
Mike Fortes

Posted on Originally published at mromeiro-f.medium.com on

Zabbix 8.0 RC - Novo APM com OpenTelemetry

Zabbix 8.0 RC: como funciona o novo APM e como implementar na prática

Da infraestrutura à observabilidade de aplicações: entenda como o Zabbix utiliza OpenTelemetry, Proxy e ClickHouse para analisar traces, métricas e logs.

O Zabbix está dando um passo importante no universo da observabilidade com a chegada dos recursos de APM (Application Performance Monitoring) na versão 8.0.

Tradicionalmente conhecido pelo monitoramento de infraestrutura, redes, servidores e serviços, o Zabbix passa a oferecer recursos para investigar o comportamento interno das aplicações.

Isso significa que, além de identificar que um serviço está lento, podemos analisar uma requisição distribuída, visualizar suas operações internas e investigar possíveis gargalos.

Neste artigo, vamos entender a arquitetura do APM no Zabbix 8.0 RC e conhecer os principais passos para configurar um laboratório.

1. O que é APM?

APM significa Application Performance Monitoring.

O monitoramento convencional supri suas necessidades quanto a infraestrutura, mas por que a API está demorando três segundos para responder? Isso o Zabbix não respondia… até agora.

Com spans e traces distribuídos, podemos investigar quais operações foram executadas durante uma requisição e quanto tempo cada uma consumiu.

2. Como funciona a arquitetura do APM no Zabbix 8.0?

A arquitetura envolve alguns componentes principais:

  1. Aplicação instrumentada: gera telemetria utilizando OpenTelemetry.

2. OpenTelemetry Collector: componente opcional para receber, processar e encaminhar dados.

3. Zabbix Proxy com APM: recebe telemetria por OTLP/gRPC.

4. ClickHouse: armazena os dados de telemetria.

5. Zabbix Frontend: permite consultar traces, métricas e logs.

O fluxo simplificado é:

O OpenTelemetry Collector pode ser inserido entre a aplicação e o Proxy.

Uma característica importante dessa arquitetura é que o recebimento OTLP ocorre no Zabbix Proxy configurado para APM, não diretamente no Zabbix Server.

3. Preparando o ambiente

Para montar um laboratório, precisamos de:

  • Zabbix 8.0 com os recursos de APM disponíveis.
  • Zabbix Proxy com suporte a APM.
  • ClickHouse configurado para armazenar a telemetria.
  • Uma aplicação instrumentada com OpenTelemetry.
  • Conectividade entre os componentes.

Como estamos trabalhando com uma versão RC, entenda… isso aqui NÃO É PRA SER USADO EM AMBIENTES PRODUTI

4. Configurando o Zabbix Proxy

O Proxy atua como ponto de entrada da telemetria, ou seja, esse cara é obrigatorio nesse cenario.

Em uma instalação com suporte a APM, os parâmetros de configuração incluem:

StartAPMCollectors=2
APMListenIP=0.0.0.0
APMListenPort=4317
Enter fullscreen mode Exit fullscreen mode

Nesse exemplo, “ligamos” dois coletores APM e a porta 4317 para receber dados OTLP/gRPC. Em ambientes produtivos, recomendado usar TLS.

Após ajustar a configuração e concluir os demais requisitos de APM, reinicie o serviço do Proxy.

5. Instrumentando uma aplicação com OpenTelemetry

Agora precisamos fazer com que a aplicação gere e envie telemetria.

Exemplo de configuração do OTLP:

OTEL_SERVICE_NAME=api-pedidos
OTEL_EXPORTER_OTLP_PROTOCOL=grpc
OTEL_EXPORTER_OTLP_ENDPOINT=http://IP_DO_PROXY:4317
OTEL_TRACES_EXPORTER=otlp
Enter fullscreen mode Exit fullscreen mode

Essas variáveis definem o nome do serviço e o destino da telemetria.

Importante: configurar o exportador não instrumenta automaticamente uma aplicação. Observe, nesse caso tenho uma aplicação node, onde a instrumentação é feita em um instrumentation.js

Com a aplicação devidamente instrumentada, as requisições passam a produzir spans que podem ser correlacionados por um trace ID.

6. Configurando o armazenamento no ClickHouse

O ClickHouse é utilizado como mecanismo de armazenamento dos dados de telemetria. Coisa nova no Zabbix, quentissima! Ele permite trabalhar com grandes volumes de informações e realizar consultas analíticas sobre os dados recebidos.

No Zabbix, configure a fonte de dados correspondente ao ClickHouse, respeitando o esquema de armazenamento e os parâmetros exigidos pela versão instalada.

7. Visualizando os traces no Zabbix

Com a aplicação enviando telemetria e o armazenamento funcionando, podemos acessar a área de APM do frontend.

Imagine o seguinte cenário:

Requisição: GET /pedidos

Nesse exemplo, a consulta SQL representa uma parcela significativa do tempo total da requisição. Isso indica um ponto interessante para investigar: índices, consultas, bloqueios, conexões ou tempo de resposta do banco de dados.

É importante lembrar que spans podem representar operações aninhadas. Portanto, suas durações não devem ser simplesmente somadas para calcular o tempo total de uma requisição.

Gostou do tutorial? Conseguiu executar até o final?

Proximo post vou mostar como integrar isso ao modelo tradicional de monitoramento, correlacionando os dados coletados e gerando mais valor final a sua ferramenta!

Referências

Documentação oficial Zabbix 8.0: https://www.zabbix.com/documentation/8.0/en

OpenTelemetry: https://opentelemetry.io/docs/

ClickHouse: https://clickhouse.com/docs/

Top comments (0)