Attempt to collect metrics from a disabled built-in ClickHouse.

[makuartur]

Description

When starting PMM with the following environment variables:

PMM_DISABLE_BUILTIN_CLICKHOUSE=1
PMM_CLICKHOUSE_ADDR=ch-01.test.net:9000
PMM_CLICKHOUSE_USER=pmm
PMM_CLICKHOUSE_PASSWORD=pmm_password
PMM_CLICKHOUSE_DATABASE=pmm

PMM starts successfully, but it still tries to collect metrics from ClickHouse at 127.0.0.1, which is not running because an external ClickHouse instance is being used.

Expected Results

Either collecting metrics from an external ClickHouse instance, or disabling ClickHouse metric collection entirely.

Actual Results

An attempt to collect metrics from a ClickHouse instance that is not running.

Version

image: percona/pmm-server:3

Steps to reproduce

1. Start the Docker image with environment variables that point to an external ClickHouse instance:

PMM_DISABLE_BUILTIN_CLICKHOUSE=1
PMM_CLICKHOUSE_ADDR=ch-01.test.net:9000
PMM_CLICKHOUSE_USER=pmm
PMM_CLICKHOUSE_PASSWORD=pmm_password
PMM_CLICKHOUSE_DATABASE=pmm

2. Check pmm-agent logs:

 tail -f pmm-agent.log | grep -i clickhouse
time="2026-01-14T14:54:52.319+00:00" level=info msg="2026-01-14T14:54:52.319Z\twarn\tVictoriaMetrics/lib/promscrape/scrapework.go:387\tcannot scrape target \"http://127.0.0.1:9363/metrics\" ({instance=\"pmm-server\",job=\"clickhouse\"}) 1 out of 1 times during -promscrape.suppressScrapeErrorsDelay=0s; the last error: cannot perform request to \"http://127.0.0.1:9363/metrics\": Get \"http://127.0.0.1:9363/metrics\": dial tcp4 127.0.0.1:9363: connect: connection refused" agentID=e2645796-6e49-440e-bee4-2945fdc63f76 component=agent-process type=vm_agent

Relevant logs

tail -f pmm-agent.log | grep -i clickhouse
time="2026-01-14T14:54:52.319+00:00" level=info msg="2026-01-14T14:54:52.319Z\twarn\tVictoriaMetrics/lib/promscrape/scrapework.go:387\tcannot scrape target \"http://127.0.0.1:9363/metrics\" ({instance=\"pmm-server\",job=\"clickhouse\"}) 1 out of 1 times during -promscrape.suppressScrapeErrorsDelay=0s; the last error: cannot perform request to \"http://127.0.0.1:9363/metrics\": Get \"http://127.0.0.1:9363/metrics\": dial tcp4 127.0.0.1:9363: connect: connection refused" agentID=e2645796-6e49-440e-bee4-2945fdc63f76 component=agent-process type=vm_agent

Code of Conduct

• I agree to follow Percona Community Code of Conduct