New Relic data dictionary

This data dictionary defines some of our default-reported data stored in NRDB and queryable via NRQL. This includes events like Transaction, MobileRequest, and BrowserInteraction, and our Metric, Log, and Span data types. These definitions are also available from our query builder UI by mousing over applicable data type and attribute names.

This dictionary doesn't contain:

  • Data from our infrastructure integrations (for that, see docs for a specific integration)
  • Custom data
  • Detailed integration-specific attributes for Metric data

InfrastructureEvent

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

Attribute nameDefinitionData types
category

A New Relic category used to organize events in the UI. For example: automation, notification, and service.

changedPath

The fully specified name of the item that changed. This is constructed by taking the source and adding one or more additional path elements that uniquely identify the item that changed.

changeType

A simple classification of the type of change made to the entity: added, modified, or removed.

deltaId

Delta refers to a recorded change in the system. The deltaId is a number used by New Relic to organize incoming inventory change data.

eventId

The unique ID of the event, generated by New Relic.

format

The type of infrastructure event. Each format type includes attributes that may be used to render the event in the UI.

newStatus

The new agent status: disconnected or connected.

newValue

If a change is made to the entity, this attribute contains the new value of the inventory that was changed. This will have no value if no change has been made. The value will display approximately 4K bytes of data.

oldValue

If a change is made to the entity, this attribute contains the old value of the inventory that was changed. This will be blank if no change has been made.

provider

For integrations that use generic event types (like the DatastoreSample event), the provider value specifies the source of the data (the service, or a sub-category of data from that service).

Some events are generic and are used by several integrations. For example, the DatastoreSample event is used by several integrations, including the AWS DynamoDB integration and the AWS RDS integration. In these cases, the provider attribute value represents the source of that attribute. This will usually be the service that data comes from or, for integrations that use several provider values, a certain sub-category of data from that service.

When a provider value is present for a generic event, that event will have additional integration-specific attributes attached to it.

Here’s an example of a NRQL query that returns the attributes present for a DatastoreSample event reported by the AWS RDS integration:

SELECT * from DatastoreSample where provider = 'RdsDbCluster'

source

The fully specified origin of this inventory item. This is typically in the form category/plugin, where plugin is the generic word used for the tool that gathered this data.

summary

A summary of the change that happened. Uses a human-friendly string, such as Agent disconnected.

violationUpdateType

The type of change to the violation: For example: open or closed.