With the infrastructure agent, you can monitor not only individual servers, but also understand how your service performs as a whole. The agent supports Amazon Linux, CentOS, Debian, RHEL, and Ubuntu as well as Windows Server. All of these agent versions exhibit a common set of behaviors.
As of infrastructure agent v1.5.59, the agent bundles a binary named
newrelic-infra-service. This binary can be managed by the OS service manager.
At service startup time, this binary spawns (executes) the usual
newrelic-infra process and supervises its child execution. Therefore agent service process should never be restarted, unless triggered via OS service manager.
During startup the agent will:
- Register a signal handler.
- Set the loggers.
- Load the configuration from file, environment variables, and call arguments.
- Register plugins for harvesting inventory, samplers, and integrations.
- StatsD integration with
http_server_enabled" Open an http port (by default, 8001) for receiving data.
Startup duration before harvesting and sending data is usually less than six seconds.
By default, the infrastructure agent runs in a single core. Every second it checks if there are events to send and, if there are, it sends them to the New Relic collector. Events that may be sent include:
- Default infrastructure events
- Events recorded by New Relic integrations.
For descriptions of the default infrastructure events and their collection frequencies, see Infrastructure events.
Integration monitoring is done by executing integration commands at given intervals (set in the config files) and reading their
stout/err. The more integrations you enable, the greater the footprint of the agent. For more information, see the documentation for specific integrations.
When a shutdown signal is received, the agent stops all the registered plugins and integration processes.
The agent runs as a service. On installation, we set up all the service manager-required files, such as the
systemD. service file. In case of a catastrophic failure, the service manager configuration will restart the agent.
There are no automatic updates to agents. To install a new agent version:
- Linux: Manually install agent versions through the appropriate package manager (apt, yum, zypper).
- Windows: Manually download the
msipackage and install it with
- macOS: Manually install agent versions through HomeBrew.
If a request made to the ingest service is unsuccessful, the payload is discarded; subsequent requests follow an exponential backoff pattern until one succeeds. For inventory, we store the deltas between system states in cache files. On failure, these deltas are not deleted but are reused on requests that follow.
For information about configuring reporting of data, see Manage data.
If you need more help, check out these support and learning resources:
- Browse the Explorers Hub to get help from the community and join in discussions.
- Find answers on our sites and learn how to use our support portal.
- Run New Relic Diagnostics, our troubleshooting tool for Linux, Windows, and macOS.
- Review New Relic's and and documentation.