Prometheus Exporter

O Prometheus Exporter é um componente que coleta métricas do sistema operacional e dos bancos de dados e as disponibiliza em um formato compatível com o Prometheus. O exporter ajuda a monitorar o estado dos clusters de banco de dados, a carga do servidor e outras informações importantes em tempo real.

Configurar Exporter

Os detalhes de acesso ao exporter estão disponíveis no painel de controle do cluster, na seção Painel.

Ao usar exporters públicos, o acesso às métricas requer autenticação básica.

Exemplo de requisição a um exporter público:

curl -u admin:'password' -s https://dbs-exporter.hostman.com/exporter_id/service/metrics

Limitações

• A coleta de métricas está disponível apenas em redes BGP (Alemanha e Países Baixos).
• Os exporters estão disponíveis em dois endpoints:
  • :9100: Métricas do servidor (por exemplo, carga, CPU e uso de memória)
  • :9308: Métricas do banco de dados

Tipos de Exporters

Existem dois tipos de exporters:

Exporters utilizados por cluster

Verificar versão do Exporter

Para descobrir a versão de um exporter específico:

curl -s http://private_IP:9308/metrics | grep '_exporter_build_info'

Exemplo de saída:

postgres_exporter_build_info{branch="HEAD",goarch="amd64",goos="linux",goversion="go1.23.3",revision="a324fe37bca5193a293118b940b3df7ab3a8505c",tags="unknown",version="0.16.0"} 1

O valor version="0.16.0" indica a versão do exporter.

O exporter do OpenSearch é construído manualmente, portanto a versão não pode ser obtida com este comando.

Exemplo de configuração

1. Garantir conectividade de rede

Certifique-se de que o cluster de banco de dados e o servidor cloud estejam na mesma rede privada.

2. Instalar Prometheus

Acesse a página de releases do Prometheus e baixe a versão mais recente. Por exemplo:

wget https://github.com/prometheus/prometheus/releases/download/v3.7.2/prometheus-3.7.2.linux-amd64.tar.gz

Extraia o arquivo:

tar -xzf prometheus-*.tar.gz

Acesse o diretório:

cd prometheus-3.7.2.linux-amd64

3. Configurar Prometheus

Abra o arquivo de configuração:

nano prometheus.yml

Adicione o IP privado do cluster e as portas na seção scrape_configs:

- job_name: 'linux-metrics'
  static_configs:
    - targets: ['192.168.0.5:9100']

- job_name: 'postgres-metrics'
  static_configs:
    - targets: ['192.168.0.5:9308']

Aqui, 192.168.0.5 é o IP privado do cluster PostgreSQL.

Para exporters públicos, a configuração de scrape fica assim:

- job_name: 'postgres-public'
  scheme: https
  metrics_path: /exporter_id/service/metrics
  static_configs:
    - targets: ['dbs-exporter.hostman.com']
  basic_auth:
    username: 'admin'
    password: 'password'

Para coletar métricas do servidor, use /exporter_id/node-exporter/metrics em vez de /exporter_id/service/metrics.

Exemplo completo de configuração

global:
  scrape_interval: 15s # Set the scrape interval to every 15 seconds. Default is every 1 minute.
  evaluation_interval: 15s # Evaluate rules every 15 seconds. The default is every 1 minute.
  # scrape_timeout is set to the global default (10s).

# Alertmanager configuration
alerting:
  alertmanagers:
    - static_configs:
        - targets:
          # - alertmanager:9093

# Load rules once and periodically evaluate them according to the global 'evaluation_interval'.
rule_files:
  # - "first_rules.yml"
  # - "second_rules.yml"

# A scrape configuration containing exactly one endpoint to scrape:
# Here it's Prometheus itself.
scrape_configs:
  # The job name is added as a label `job=<job_name>` to any timeseries scraped from this config.
  - job_name: "prometheus"

    # metrics_path defaults to '/metrics'
    # scheme defaults to 'http'.

    static_configs:
      - targets: ["localhost:9090"]
       # The label name is added as a label `label_name=<label_value>` to any timeseries scraped from this config.
        labels:
          app: "prometheus"
  - job_name: 'linux-metrics'
    static_configs:
      - targets: ['192.168.0.5:9100']

  - job_name: 'postgres-metrics'
    static_configs:
      - targets: ['192.168.0.5:9308']

  - job_name: 'postgres-public'
    scheme: https
    metrics_path: /exporter_id/service/metrics
    static_configs:
      - targets: ['dbs-exporter.hostman.com']
    basic_auth:
      username: 'admin'
      password: 'password'

4. Iniciar Prometheus

Execute o Prometheus com o arquivo de configuração especificado:

./prometheus --config.file=prometheus.yml

A interface web do Prometheus estará disponível em:

http://<IP_do_servidor_cloud>:9090

5. Verificar status do Exporter

Na interface web do Prometheus, acesse Status → Targets.

• Verifique se todos os job_name estão visíveis e com status UP.
• Para uma checagem básica, execute a query up na aba Graph.

Se tudo estiver correto, todos os exporters conectados aparecerão com seus respectivos job_name.

A aba Graph na interface do Prometheus