Understand and use data from Infrastructure integrations

With New Relic Infrastructure integrations, you can monitor the performance of popular services, including AWS, Azure, MySQL, and Cassandra. You can also make your own custom integrations using the Integrations SDK.

This document provides an overview of integration data types and explains how to find and use that data.

Start exploring your integration data

The best way to understand your integration data and see what you can do with it is to activate an integration and then start exploring the data in New Relic Infrastructure and Insights. For example:

Custom integrations built with the SDK do not appear on the Integrations page or have pre-built metric dashboards. For more information, see Find and use custom integration data.

Types of integration data

New Relic makes two categories of integrations: cloud integrations like AWS and Azure, and on-host integrations like MySQL and NGINX. An integration can generate four types of data:

  • Metrics: Numeric measurement data. Metric data from New Relic-built integrations appears in dashboards. Metric data can also be found and used in Insights.
  • Inventory: Information about the state and configuration of a service or host. Inventory data appears in the Infrastructure Inventory page. In addition, for integrations built by New Relic, inventory data also appears in integration dashboards. Changes in inventory generate event data.
  • Events: Events represent important activity on a system. Most events represent changes in inventory.
  • Attributes: Some integrations will generate other non-metric attributes (key-value pairs) that are available in New Relic Insights.

Metric data

Metric data is numeric measurement data; for example:

  • A count of exceptions
  • The rate of bytes processed by a service
  • The percentage CPU being used.

You can view integration metric data in New Relic Infrastructure and Insights:

Product Where is data found?
Infrastructure

To find metric charts for New Relic-built integrations (not custom integrations): select the Integrations page and select the integration's dashboard.

Insights To explore metric data, use the Insights event data explorer and run NRQL queries. For tips on using this data in Insights, see Use data in Insights.

All integration data, including metric data, is found using Insights' Event data explorer, and never the Metric data explorer. This is due to the way Insights categorizes data. For more information, see Data collection.

Event data

In Infrastructure, events represent important activity on a host/system. Examples of event data: an admin logging in; a package install or uninstall; a service starting; a table being created. Most events will represent changes to inventory data.

You can view integration event data in New Relic Infrastructure and Insights:

Product Where is data found?
Infrastructure

You can find integration event data on the Events page, in the event heatmap, and, for New Relic-built integrations, in Integration page dashboards.

Insights You can find integration event data by querying the InfrastructureEvent event type in Insights. For tips on using this data in Insights, see Use integration data with Insights.

Inventory data

Inventory data is information about the status or configuration of a service or host. Examples of inventory data: configuration settings; the name of the host the service is on; the AWS region; the port being used.

You can view integration inventory data in New Relic Infrastructure and Insights:

Product Where is data found?
Infrastructure

You can find inventory data on the Inventory page. Some integration dashboards will include inventory tables. Changes to inventory items generate inventory change events; that data can be found in the event heatmap and in Insights.

Insights Some inventory values deemed to be important, like host name and AWS region, can be found in Insights, attached to the integration's event type (for example, MysqlSample). Inventory change events can be found by querying the InfrastructureEvent event type. For tips on using this data in Insights, see Use integration data with New Relic Insights.

For more on the structure of inventory data and how it appears in the Infrastructure UI, see Inventory UI page.

Other attributes

Attributes (key-value pairs) refer to data attached to an event available in Insights. Metrics, for example, are a type of attribute with a numeric value that can be charted. Also, some inventory data is reported as attributes. Some integrations will report attributes that are not considered metrics or inventory.

On-host integration data will also have standard Infrastructure agent attributes attached to it. This is because the data is reported by the Infrastructure agent.

Create alert conditions

To create an alert condition for integration data in Infrastructure, Go to infrastructure.newrelic.com > Integrations > (select an integration), then select any available alert option. For more information, see Infrastructure and Alerts.

For on-host integrations, you can also create alert conditions using NRQL queries. (NRQL alerts are not supported or recommended for cloud integrations, due to issues related to data latency.)

For more help

Recommendations for learning more: