• EnglishEspañol日本語한국어Português
  • Log inStart now

Infrastructure agent behavior

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.

Agent service

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.

Agent startup

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.

Monitoring and resource caps

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:

For descriptions of the default infrastructure events and their collection frequencies, see Infrastructure events.

Integration data

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.

Agent shutdown

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 msi package and install it with msiexec.exe.
  • macOS: Manually install agent versions through HomeBrew.

Retry behavior

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.

As of infrastructure agent v1.29.1, users can now configure the retry attemps for our embedded logging forwarder. The default value here is 5 and can be set to any numerical value needed.

Manage data reporting

For information about configuring reporting of data, see Manage data.

Copyright © 2024 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.