New Relic Infrastructure collects and displays data using five primary events, each with associated attributes. This document explains how to view your attributes in the event data dictionary and how to see descriptions of the events and their attributes.
Understanding the structure of Infrastructure events and attributes helps you:
- Better understand the data you see in Infrastructure charts and displays.
- Create better host filter sets in Infrastructure.
- Perform more effective queries of your data in New Relic Insights.
- Set up better custom infrastructure monitoring solutions using custom attributes.
If you are using Infrastructure integrations, you will have more than the basic Infrastructure event types.
View available attributes in Insights
New Relic Infrastructure populates Insights with data about your server. To explore the attributes of Infrastructure events, use the Insights data explorer:
- Go to insights.newrelic.com > Data explorer.
- From the event type dropdown, select an Infrastructure event: SystemSample, ProcessSample, InfrastructureEvent, StorageSample, or NetworkSample.
- Review the attribute values for the event.
Use the New Relic event data dictionary to view the attributes for these default Infrastructure events:
New Relic samples this data every 5 seconds and packages it into a
If your server uses disks with file systems other than the supported file systems in the following table,
To learn about the events and attributes reported by integrations, see the documentation for specific integrations.
If an AWS integration is enabled, your Infrastructure events may also have AWS attributes attached.
Query event data
To query Infrastructure event data, use the NRQL syntax with the Insights Data Explorer:
- Go to insights.newrelic.com > Data Explorer.
- From the query command line, use
FROMbefore the event type.
For example, to query only ProcessSample events, use
SELECT processDisplayName FROM ProcessSample
Use custom attributes
You can create Infrastructure custom attributes in the New Relic YAML file. Custom attributes are key-value pairs that annotate the data from the Infrastructure agent. Use this metadata to:
- Create Infrastructure Filter sets.
- Populate the Infrastructure Group by menu.
- Annotate your Insights data.
Common Amazon EC2 attributes
If you connect your Amazon Elastic Compute Cloud (EC2) account to New Relic Infrastructure, Infrastructure automatically collects data from your Amazon EC2 instances. Amazon EC2-related attributes are common attributes that can be used in any event. These attributes are drawn from the EC2 API. No CloudWatch information is collected.
These attributes and their values are subject to change if Amazon changes the data they expose.
- The region (determined by Amazon Web Services) where the AWS server exists. This attribute exists only for customers using New Relic to monitor Amazon EC2 servers.
- The availability zone (determined by Amazon Web Services) where the AWS server exists. This attribute exists only for customers using New Relic to monitor Amazon EC2 servers.
- The Amazon Web Services instance type, displayed in AWS-specific codes. This attribute exists only for customers using New Relic to monitor Amazon EC2 servers.
- The Amazon Web Services instance's unique identifying number for the server. This attribute exists only for customers using New Relic to monitor Amazon EC2 servers.
- The Amazon Machine Image (AMI) identification number of the image used by Amazon Web Services to bootstrap the Amazon EC2 instance. This attribute exists only for customers using New Relic to monitor Amazon EC2 servers.
- The networking sub-net identifier on which the server is connected. This attribute exists only for customers using New Relic to monitor Amazon EC2 servers.
- The Virtual Private Cloud identifier (if any) for this server. This attribute exists only for customers using New Relic to monitor Amazon EC2 servers.
- Other Amazon EC2 attributes
- If Amazon Web Services changes the metadata they make available to New Relic Infrastructure, other attributes and values collected also may be available.