Default infrastructure events

New Relic's infrastructure agent collects and displays data using six primary events, each with associated attributes that represent assorted metrics and metadata.

Understanding infrastructure events can help you:

Overview of how data is reported

Each event type has a unique collection interval.

If you're using infrastructure integrations, you'll have more events than the basic event types described in this document. To see common AWS attributes, see AWS data.

To change scheduling for data from infrastructure integrations:

Infrastructure events

The following events and their associated attributes (metrics and metadata) are used to create the Infrastructure monitoring UI visualizations. You can also create custom queries and charts of this data.

Select an event name below to see its attributes.

Event Description
SystemSample

SystemSample contains data describing the current overall state of the entire server, including CPU, memory, disk, and network. We take a snapshot of this data every 5 seconds and package it into a SystemSample event, which is then sent to New Relic. This data appears in the Hosts UI page.

ProcessSample

ProcessSample gathers detailed resource usage information from programs running on a single system. We take a snapshot of this data every 20 seconds for every active process and package it into a ProcessSample event, which is then sent to New Relic. This data appears on the Processes UI page.

Process metrics are not sent to New Relic by default for accounts created after July 20, 2020. Enable process metrics to get this data into the Infrastructure monitoring UI.

StorageSample

StorageSample 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. We take a snapshot of this data every 20 seconds for each mounted file system and package it into a StorageSample event, which is then sent to New Relic. This data appears on the Storage UI page.

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.

Supported Linux storage systems

Supported Linux storage file systems:

  • xfs
  • vxfs
  • btrfs
  • ext
  • ext2
  • ext3
  • ext4
  • hfs
Supported Windows storage systems

Supported Windows storage file systems:

  • NTFS
  • ReFS (version 1.0.976 and higher)
NetworkSample

NetworkSample 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. We take a snapshot of this data every 10 seconds for each attached network interface and package it into a NetworkSample event, which is then sent to New Relic. This data appears on the Network UI page.

ContainerSample

ContainerSample collects the descriptive and state information for each Docker container. It includes the container's ID, name, image, image name, as well metrics about CPU, memory and networking. We take a snapshot of this data every 15 seconds for each container and package it into a ContainerSample event, which is then sent to New Relic. This data appears on the Containers UI page. For more information, see Docker monitoring.

InfrastructureEvent

InfrastructureEvent describes changes (deltas) that occur in a system's live state. When an inventory or system state is added, removed, or changed, New Relic will produce an InfrastructureEvent that logs that activity. This data appears on the Events UI page.

To learn about infrastructure integration data, see the documentation for a specific integration.

If an AWS integration is enabled, your infrastructure events may also have AWS attributes attached.

Query infrastructure data

You can query your infrastructure data to troubleshoot a problem or create a chart, or to understand what data is available. For example, to see what data is attached to ProcessSample, you would run this NRQL query:

SELECT * FROM ProcessSample

You can also query infrastructure using dimensional metrics.

Add custom attributes

You can create infrastructure custom attributes in the New Relic YAML file. Use this metadata to:

  • Create infrastructure filter sets
  • Populate the Group by menu
  • Annotate your infrastructure data

Common Amazon EC2 attributes

If you connect your Amazon Elastic Compute Cloud (EC2) account to infrastructure monitoring, New Relic reports 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, other attributes and values collected also may be available.

For more help

If you need more help, check out these support and learning resources: