New Relic's infrastructure monitoring agent collects and displays data using six primary events, each with associated attributes that represent assorted metrics and metadata.
Check out our troubleshooting tutorial for your infrastructure host data. The tutorial series walks you through how to find data in the infrastructure UI to resolve an incident and make a resource decision about your hosts.
The attributes attached to these events are the metadata and metrics used to create our infrastructure UI visualizations. You can also create custom queries and charts of this data.
If you're using integrations, see that integration's doc for more on reported data. For common AWS attributes, see AWS data.
Select an event name in the following table to see its attributes.
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 on the Systems UI tab.
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.
Important
Process metrics are not reported by default. To report this data, enable process metrics.
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.
Important
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.
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 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 describes changes (deltas) that occur in a system's live state. When an inventory or system state is added, removed, or changed, we'll generate an InfrastructureEvent that logs that activity. This data appears on the Events UI page.
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:
If you use our Amazon Elastic Compute Cloud (EC2) integration, we report data from your Amazon EC2 instances. Amazon EC2-related attributes are common attributes present for any events reported from your EC2 instances. These attributes and their values are subject to change if Amazon changes the data they expose.
The AWS account id (determined by Amazon Web Services).
The region (determined by Amazon Web Services) where the AWS server exists.
The availability zone (determined by Amazon Web Services) where the AWS server exists.
The Amazon Web Services instance type, displayed in AWS-specific codes.
The Amazon Web Services instance's unique identifying number for the server.
The Amazon Machine Image (AMI) identification number of the image used by Amazon Web Services to bootstrap the Amazon EC2 instance.
The networking sub-net identifier on which the server is connected.
The Virtual Private Cloud identifier (if any) for this server.
If Amazon Web Services changes the metadata they make available to us, other attributes and values collected also may be available.
A sub-set of these attributes are collected from the infrastructure agent when installed in the EC2 instances: