Default Infrastructure attributes and events

New Relic Infrastructure collects and displays data using five primary events, each with associated attributes. This document contains a list of all 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 Data Explorer:

  1. Go to insights.newrelic.com > Data Explorer.
  2. From the event type dropdown, select an Infrastructure event: SystemSample, ProcessSample, InfrastructureEvent, StorageSample, or NetworkSample.
  3. From the Data Explorer, review the attribute values for the event.

Infrastructure Events

Use the New Relic event data dictionary to view the attributes for the default Infrastructure events:

Event Description
SystemSample

SystemSample aggregates data describing the current, overall state of the entire server. This data appears in the New Relic Infrastructure Hosts page to show usage trends for the associated host's main resources. These resources include CPU, memory, disk, and network.

New Relic samples this data every 5 seconds and packages it into a SystemSample event, then sends the raw data to New Relic's collectors every 60 seconds.

ProcessSample

ProcessSample event gathers detailed resource usage information from programs running on a single system. This data is sampled every 10 seconds for every active process, then the raw data is sent to New Relic's collectors every 60 seconds.

StorageSample

StorageSample event represents a single storage device associated with a server. Each sample gathers descriptive information about the device, the type of file system it uses, and its current usage and capacity. This data is sampled every 5 seconds for each mounted file system, then the raw data is sent to New Relic's collectors every 60 seconds.

If your server uses disks with file systems other than the supported file systems in the following table, StorageSample events will not be generated for those disks.

Infrastructure version Supported file systems
Infrastructure for Linux
  • xfs
  • vxfs
  • btrfs
  • ext
  • ext2
  • ext3
  • ext4
  • hfs
Infrastructure for Windows
  • NTFS
  • ReFS (version 1.0.976 and higher)
NetworkSample

NetworkSample event captures the descriptive and state information for each network device associated with a server. It includes the device's interface and address information, as well as current usage data. This data is sampled every 5 seconds for each attached network interface, then the raw data is sent to New Relic's collectors every 60 seconds.

InfrastructureEvent

InfrastructureEvent describes changes (deltas) that occur in a system's live state. When the inventory or system state is added, removed, or changed, Infrastructure will produce an InfrastructureEvent that logs that activity.

Query event data

To query Infrastructure event data, use the NRQL syntax with the Insights Data Explorer:

  1. Go to insights.newrelic.com > Data Explorer.
  2. From the query command line, use FROM before the event type.

For example, to query only ProcessSample events, use FROM ProcessSample:

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.

awsRegion
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.
awsAvailabilityZone
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.
ec2InstanceType
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.
ec2InstanceId
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.
ec2AmiId
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.
ec2SubnetId
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.
ec2VpcId
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.

For more help

Recommendations for learning more: