New Relic Infrastructure lets you create your own integrations using either the Flex integration tool (recommended) or by using our Integrations SDK to build your own complete Infrastructure on-host integration.
The Integrations SDK lets you build an integration that reports custom data from hosts or services. That data can then be found in New Relic Infrastructure and can be used to create custom queries and charts.
Requires Infrastructure Pro.
What data can you report with an on-host integration?
When you build an integration using the Integrations SDK, you assign the entities that report data. In New Relic terms, entity is a purposefully ambiguous term meaning something that reports data to New Relic (for example: a local host, a load balancer, or a database).
A single integration can report data from multiple entities, which gives you the ability to report data from more than one service or host instance.
There are three types of data an entity can generate:
- Metrics: Metric data is used for numerical measurement data. Examples: how many requests are in a queue, or the number of hits on a database per minute. Metric data from a custom integration can be queried and used to create dashboards.
- Inventory: Live system state and configuration information. This data will show up on the Infrastructure Inventory UI page.
- Events: Events are used to record important activities on a system. Examples: a service starting or a new table being created. Event data will be shown in the Infrastructure Events UI page.
Create a custom integration
Data from an integration built using the Integrations SDK is available only with a New Relic Infrastructure Pro subscription.
To create an integration using the Integrations SDK, use these resources:
- See the Go language build tools and tutorial. The tutorial walks you through creating a Redis integration in Go. (Note: Go is not required; it's just the language for which we provide additional build tools. For more information, see Integrations SDK requirements.)
- See the integration file structure documentation, which describes the files required to create an integration.