Pular para o conteúdo principal
Versão 4.1.0

Configuração do Exportador de Métricas do PgBouncer

O Exportador de Métricas do PgBouncer expõe métricas como o número de conexões ativas, conexões esperando na fila, uso de recursos pelo PgBouncer, entre outras. Essas informações são importantes para ajustar a operação do pooling e garantir que o ambiente esteja respondendo eficientemente às solicitações dos clientes.

Por meio desta opção de configuração será possível informar a porta de exposição das métricas do PgBouncer para serem coletadas pelo Prometheus.

alerta

Para realizar esta operação é necessário que o usuário "pgsmart_metrics" exista nas instâncias PgBouncer onde será configurado o Exporter.

O usuário poderá ser configurado durante o processo de configuração do Exportador de Métricas PgBouncer, bastando, para isto, confirmar a operação.

O usuário poderá ser configurado também manualmente, por meio das seguintes operações:

√ Inclusão do usuário no arquivo de configuração do PgBouncer userlist.txt;
√ Inclusão do usuário no parâmetro do PgBouncer stats_users;

Além disso, é necessário configurar o valor "extra_float_digits" no parâmetro "ignore_startup_parameters", nas instâncias PgBouncer onde será configurado.

O Exportador de Métricas PgBouncer será configurado, existindo ou não estas configurações no PgBouncer. Entretanto, a exportação das métricas somente se realizará a partir do momento em que tudo esteja configurado na instância PgBouncer, e o serviço deste Exportador de Métricas dos Serviços seja iniciado.

nota

A senha do usuário pgsmart_metrics poderá ser modificada no PgSmart Web ou no PgSmart Cli, por meio do parâmetro ´metrics_password´.

Pré-Requisitos
Sintaxe do Comando
Terminal input
    pgsmart obs exporter config [FLAGS]

Flags​

  • -a, --agent=<agent> => Alias, hostname ou IP do servidor onde o PgSmart Agent desejado está instalado.
  • -h, --help => Ajuda
Configuração Não-Interativa

A execução não interativa está desabilitada para esta operação.

Configuração Interativa
Terminal input
    pgsmart obs exporter config

Configuração do PgBouncer Exporter​

  1. Selecione o Agente do PgSmart ou Registrar um novo.

  2. Confirme se deseja ou não atualizar o repositório de pacotes da Plataforma.

    2.1. Se confirmado, informa o novo repositório.

  3. Selecione o Exportador de Métricas do PgBouncer.

  4. Selecione a interface de rede para conexão.

  5. Adicione a(s) instância(s) do gerenciamento de pool(s) de Conexão(ões).

    alerta

    Este Exportador de Métricas requer a configuração prévia do parâmetro ignore_startup_parameters com o valor extra_float_digits para cada instância do PgBouncer.

    É possível realizar tal configuração pelo próprio PgSmart, por meio da opção de configuração do serviço de pool de conexões.

    Essa configuração é necessária para que o driver de conexão à instância ignore determinados parâmetros na inicialização da conexão.

    É importante ressaltar que o Exportador de Métricas do PgBouncer será configurado pelo PgSmart, independentemente desta configuração.

    Porém, somente será iniciada a exportação de métricas após a configuração do parâmetro ignore_startup_parameters.

    5.1. Informe a porta de conexão para o gerenciamento do pool de conexões.

    5.2. Confirme se deseja a configuração do usuário de acesso pgsmart_metrics no PgBouncer.

    5.3. Informe a porta de exposição das métricas e interface web.

    5.4. Confirme se deseja adicionar mais uma instância do gerenciamento do pool de conexões.

    Figura 1 - Configuração do Exportador de Métricas do PgBouncer
    Figura 1 - Configuração do Exportador de Métricas do PgBouncer
    nota

    Poderão ser adicionadas tantas instâncias quanto necessário.

    nota

    As métricas exportadas podem ser visualizadas pelo console:

    Terminal input
        curl http://192.168.56.234:9100/metrics

    Ou pela interface web:

    Terminal input
        http://192.168.56.234:9100/metrics