Pular para o conteúdo principal
Coletar métricas do MySQL para o Prometheus normalmente significa executar um processo exportador separado, que faz login e consulta o servidor. O prometheus_exporter serve o endpoint /metrics de dentro do servidor, então há um processo a menos para implantar, autenticar e manter em funcionamento.
Um terceiro escreve e mantém esta extensão. O VillageSQL não a compila, não a testa e não a distribui, e a descrição abaixo segue a documentação do próprio mantenedor. Leia essa documentação antes de depender dela.

​
Instalar

O código no branch padrão do repositório não compila com o SDK atual: ele chama make_sys_var_bool e make_status_var_int, que saíram do SDK em maio de 2026. O código portado está no pull request aberto #4, que declara capabilities Preview, então o servidor que o carrega precisa ser iniciado com --vsql_allow_preview_extensions=ON.
Compile-o a partir desse branch com uma árvore de compilação do VillageSQL (VillageSQL_BUILD_DIR), copie o arquivo .veb para o veb_dir do servidor e, em seguida, instale-o:

​
O que ela adiciona

Ela adiciona um listener HTTP e três configurações, e nenhuma função SQL. Cinco famílias de métricas são exportadas, cada uma nomeada conforme a sua origem. O exportador também relata sobre si mesmo por meio de requests_total, scrape_duration_us e errors_total.

​
Exemplo

O início rápido do mantenedor ativa a extensão e escolhe uma porta:
O Prometheus então coleta de http://127.0.0.1:9104/metrics. Se outro processo, como um mysqld_exporter independente, já ocupa a porta 9104, enabled continua mostrando ON e nada responde, então verifique o endpoint com curl.
O listener se vincula ao localhost a menos que você mude isso, o que é a escolha segura. As métricas descrevem o seu tráfego e a sua configuração, então coloque a porta atrás de algo que autentique antes de tirá-la do endereço de loopback.

​
Veja também