You can troubleshoot our infrastructure agent using our newrelic-infra-ctl
utility. This binary is also included in the installation package, in the same directory as the newrelic-infra
default binary.
Upon receiving the newrelic-infra-ctl
command, the agent:
- Enables verbose logs for a period of five minutes, then reverts the log level to its previous setting.
- Logs all the agent config options.
- Logs all the integrations config options.
- Executes a health check for every loaded integration. (A health check is an immediate execution of the integration with extra logs and output validation.)
Linux newrelic-infra-ctl
In Linux systems, the troubleshooting binary is /usr/bin/newrelic-infra-ctl
, available in both the package manager or the tarball assisted install methods.
Important
When running on Linux, newrelic-infra-ctl
must be executed by either the root user or the same user running the newrelic-infra
process.
The newrelic-infra-ctl
binary can automatically detect the agent process running in the host. It can also detect whether the agent is running inside a container.
To change the default settings of newrelic-infra-ctl
:
To change... | Execute |
---|---|
| |
|
|
| |
|
|
|
|
Windows newrelic-infra-ctl
In Windows, using the MSI installer, the troubleshooting binary is C:\Program Files\New Relic\newrelic-infra\newrelic-infra-ctl.exe
.
Important
In Windows, the agent process is always automatically detected. It does not depend on the pid
or the cid
.