On-host integration configuration overview

New Relic's on-host integrations send data to the infrastructure agent, which in turn sends that data to New Relic. How integrations interact with the agent is controlled by each integration's config.

Understanding more about configuration can help you troubleshoot issues with your on-host integration.

Overview of how configuration works

New Relic's on-host integrations are external programs executed by the infrastructure agent. Each integration monitors a specific service. An integration has, at minimum, these files:

Configuration file location

With standard on-host integration installations, the configuration is located in the infrastructure agent's directory. The agent determines this config location by a setting in its own configuration file.

For some implementations, the integration's configuration will be located elsewhere. For example:

  • Services running on Kubernetes: The configuration is located in the Kubernetes integration config file.
  • Services running on Amazon ECS: The configuration is placed in the AWS console.

Configuration formats

On-host integrations use two configuration formats:

  • Standard: This is the format used by most on-host integrations. This configuration uses two files: a definition file and a configuration file. For more details, see Standard configuration.
  • Newer: Starting December 2019, infrastructure agent version 1.8.0 began supporting a new format used by some integrations. This format uses a single configuration file and provides other improvements. For more details, see Newer configuration.

For more help