Unable to register pmm-agent on pmm server

Hi team, i have installed pmm3-server and pmm3-client on 2 machines.

I am reciving following error while registering pmm-agent on pmm server using command:

pmm-admin config --server-insecure-tls --server-url=https://admin:admin@X.X.X.X:443

Error: Failed to register pmm-agent on PMM Server: Endpoint not found: /v1/management/Node/Register, http method: POST.

Can anyone plz help on this..

Hi, can you confirm the versions of both PMM server and client (with pmm-admin it’s pmm-admin --version).

Also, you can run pmm-admin with debug flag for more information:

pmm-admin config --server-insecure-tls --server-url=https://admin:admin@X.X.X.X:443 --debug

Hi Michael,

please find below version details:

PMM Server:
;?ProjectName: pmm-admin
Version: 3.1.0
PMMVersion: 3.1.0
Timestamp: 2025-03-26 14:22:32 (UTC)
FullCommit: 4b5821b21539ca4bd9b31fa46510ad9f69d322bf

PMM Client:
ProjectName: pmm-admin
Version: 3.0.0
PMMVersion: 3.0.0
Timestamp: 2024-05-09 06:35:45 (UTC)
FullCommit: 920976907eb07558d0cd9e2ee26a630c31302c1f

pmm-admin config --server-insecure-tls --server-url=https://admin:admin@X.X.X.X:443 --debug
output:
pmm-admin config --server-insecure-tls --server-url=https://admin:admin@192.168.50.206:443 --debug
DEBUG 2025-04-23 11:35:36.173731019Z: Running: pmm-agent --server-address=192.168.50.206:443 --server-username=admin --server-password=admin --listen-port=7777 --server-insecure-tls --log-level=warn --debug --log-lines-count=1024 setup --metrics-mode=auto 192.168.50.207 generic localhost.localdomain
DEBUG 2025-04-23 11:35:36.261803372Z: Result: &commands.configResult{Warning:"", Output:"Checking local pmm-agent status...\npmm-agent is running.\nRegistering pmm-agent on PMM Server...\nFailed to register pmm-agent on PMM Server: Endpoint not found: /v1/management/Node/Register, http method: POST."}
DEBUG 2025-04-23 11:35:36.265072089Z: Error: &exec.ExitError{ProcessState:(*os.ProcessState)(0xc000354000), Stderr:[]uint8{0x74, 0x69, 0x6d, 0x65, 0x3d, 0x22, 0x32, 0x30, 0x32, 0x35, 0x2d, }}
Checking local pmm-agent status...
pmm-agent is running.
Registering pmm-agent on PMM Server...
Failed to register pmm-agent on PMM Server: Endpoint not found: /v1/management/Node/Register, http method: POST.
DEBUG 2025-04-23 11:35:36.268211761Z: exit status 1, stderr:
time="2025-04-23T16:35:36.217+05:00" level=info msg="Temporary directory is not configured and will be set to /usr/local/percona/pmm/tmp" component=setup
time="2025-04-23T16:35:36.218+05:00" level=info msg="Using /usr/local/percona/pmm/exporters/node_exporter" component=setup
time="2025-04-23T16:35:36.218+05:00" level=info msg="Using /usr/local/percona/pmm/exporters/mysqld_exporter" component=setup
time="2025-04-23T16:35:36.218+05:00" level=info msg="Using /usr/local/percona/pmm/exporters/mongodb_exporter" component=setup
time="2025-04-23T16:35:36.218+05:00" level=info msg="Using /usr/local/percona/pmm/exporters/postgres_exporter" component=setup
time="2025-04-23T16:35:36.218+05:00" level=info msg="Using /usr/local/percona/pmm/exporters/proxysql_exporter" component=setup
time="2025-04-23T16:35:36.218+05:00" level=info msg="Using /usr/local/percona/pmm/exporters/rds_exporter" component=setup
time="2025-04-23T16:35:36.218+05:00" level=info msg="Using /usr/local/percona/pmm/exporters/azure_exporter" component=setup
time="2025-04-23T16:35:36.218+05:00" level=info msg="Using /usr/local/percona/pmm/exporters/vmagent" component=setup
time="2025-04-23T16:35:36.219+05:00" level=debug msg="POST /local/Status HTTP/1.1\r\nHost: 127.0.0.1:7777\r\nUser-Agent: Go-http-client/1.1\r\nContent-Length: 3\r\nAccept: application/json\r\nContent-Type: application/json\r\nAccept-Encoding: gzip\r\n\r\n{}\n\n" component=setup
time="2025-04-23T16:35:36.222+05:00" level=debug msg="HTTP/1.1 200 OK\r\nContent-Length: 239\r\nContent-Type: application/json\r\nDate: Wed, 23 Apr 2025 11:35:36 GMT\r\nGrpc-Metadata-Content-Type: application/grpc\r\n\r\n{\n  \"agent_id\":  \"\",\n  \"runs_on_node_id\":  \"\",\n  \"server_info\":  null,\n  \"agents_info\":  [],\n  \"config_filepath\":  \"/usr/local/percona/pmm/config/pmm-agent.yaml\",\n  \"agent_version\":  \"3.0.0\",\n  \"node_name\":  \"\",\n  \"connection_uptime\":  0\n}\n" component=setup
time="2025-04-23T16:35:36.222+05:00" level=debug msg="Status error: <nil>" component=setup
time="2025-04-23T16:35:36.223+05:00" level=debug msg="POST /v1/management/Node/Register HTTP/1.1\r\nHost: 192.168.50.206:443\r\nUser-Agent: Go-http-client/1.1\r\nContent-Length: 217\r\nAccept: application/json\r\nAuthorization: Basic YWRtaW46YWRtaW4=\r\nContent-Type: application/json\r\nAccept-Encoding: gzip\r\n\r\n{\"node_type\":\"GENERIC_NODE\",\"node_name\":\"localhost.localdomain\",\"address\":\"192.168.50.207\",\"machine_id\":\"/machine_id/c29dd5e2957fa3439dede3e9545306d7\",\"distro\":\"linux\",\"metrics_mode\":\"AUTO\",\"disable_collectors\":null}\n\n" component=setup
time="2025-04-23T16:35:36.256+05:00" level=debug msg="HTTP/1.1 404 Not Found\r\nContent-Length: 119\r\nConnection: keep-alive\r\nContent-Type: application/json\r\nDate: Wed, 23 Apr 2025 11:35:36 GMT\r\nServer: nginx\r\nStrict-Transport-Security: max-age=63072000; includeSubdomains;\r\n\r\n{\n  \"code\":  5,\n  \"message\":  \"Endpoint not found: /v1/management/Node/Register, http method: POST\",\n  \"details\":  []\n}\n" component=setup
time="2025-04-23T16:35:36.257+05:00" level=debug msg="Register error: &node.RegisterNodeDefault{_statusCode:404, Payload:(*node.RegisterNodeDefaultBody)(0xc0003c42d0)}" component=setup

pmm-admin version date looks wrong. We released 3.0.0 on January 31 2025, but your build from 2024. Please use oficially released version.

can you please share the link for latest version of PMM-server and Client from where i can install PMM.

please help to provide the latest package.

Depending on OS you can use

Hi Nurlan,

thanks for your report. issue was in the installed package.. i reinstalled using ur provided links and its resolved.

1 Like