On-host integration data collection and reporting

Read on to learn how New Relic on-host integrations collect and report data to New Relic.

Data collection and reporting process

This is how an infrastructure on-host integration sends data to New Relic:

  1. On startup, the infrastructure agent scans the directory that contains the integration's definition files.
  2. The infrastructure agent registers every integration executable defined in the definition file.
  3. The agent scans a dedicated directory for integration configuration files.
  4. If those config files specify integrations that have been registered with the infrastructure agent, the agent sets up and schedules the integrations.
  5. At the scheduled interval (the default is 15 seconds), the agent harvests the data from the integration and prepares it for transmission. Every 60 seconds, it sends that data to New Relic, along with any other infrastructure data.
  6. After a successful collection pass, the integration executable exits.

File structure and specifications

Understanding the file structure of New Relic on-host integrations can help you customize your integration, understand and use your data, and troubleshoot problems.

On-host integrations adhere to a set of open source specifications, allowing anyone to build their own infrastructure on-host integration. For an explanation of these file specifications, see File specs.