Description
How to test
2 scenarios to test:
standard PMM installation: regression test
PMM with external Victoria Metrics
Enable external Victoria metrics with PMM_VM_URL
Test authentication on external VM via the following ENV variables
VMAGENT_remoteWrite_basicAuth_username={username}
VMAGENT_remoteWrite_basicAuth_password={password}
regression test
How to document
We added new env variable PMM_VM_URL which should point to external victoria metrics and should have format http(s)://hostname:port/path.
If External victoria metrics requires basic authentication following env vars should be used
VMAGENT_remoteWrite_basicAuth_username={username}
VMAGENT_remoteWrite_basicAuth_password={password}
In case other authentication method used on VictoriaMetrics side users can use any of vmagent env variables by prepending VMAGENT_ prefix.
Internal victoria metrics stops when external victoria metrics is configured. In this case we use VM Agent on PMM Server to pull metrics from agents configured in pulls metrics mode and remote nodes and push collected data to external victoria metrics. VM Agents running on PMM Clients pushes data directly to external victoria metrics. Make sure that they can connect to external victoria metrics.
Attachments
relates to
Smart Checklist
hideActivity
Nailya Kutlubaeva September 8, 2023 at 6:24 AM
I started PMM server with the external VM variable, but default VM was started to of some reason.
Nailya Kutlubaeva September 4, 2023 at 9:33 AM
I see the same error with the new FB, attached the logs
Nailya Kutlubaeva August 29, 2023 at 12:51 PM
I installed external VictoriaMetrics on the hot, checked that VictoriaMetrics is available with URL and started PMM server with providing PMM_VM_URL variable, but as I see from logs something is wrong:
User story:
As a user, I want to use an external Victoria Metrics instance.
Acceptance criteria:
We can use a separate Victoria Metrics instance outside the container
We can setup Victoria Metrics hostname/port and credentials with environment variables.
PMM Clients push metrics to Victoria Metrics.
Grafana uses external Victoria Metrics
Out of scope:
Changing settings from UI (hostname, login/password, and so on)
Suggested implementation:
-
How to test: