On-host integration data collection and reporting

This document explains how New Relic on-host integrations collect and report data to New Relic. This applies to New Relic-built on-host integrations, open-source on-host integrations, and custom integrations built using the Integrations SDK.

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.

For more help

Recommendations for learning more: