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

NrdbQuery

Data source:

Each time a query is executed on behalf of a user in your account an NrdbQuery event is published. Events contain the full query string, information about when and where it originated, and how it performed.

Attribute nameDefinitionData types
durationMs
milliseconds (ms)

The total time that it took for the query to execute.

inspectedCount
count

The number of events, if any, that were inspected while executing the query.

productCapability
enum

The New Relic capability where the query originated.

query

The NRQL query string that was executed.

query.eventType

The event type specified in the FROM clause of the query. A query with a FROM clause can return more than one event type.

scannedEvents
count

The count of data points scanned, if any, to return the query result.

source.apiKeyId
ID

The API key used to execute the query for 'query-api' sources.

source.dashboardId
ID

The dashboard ID that executed this query for 'dashboard' sources. This value can be entered into the dashboard search bar to display that dashboard.

source.grafana.dashboardId
ID

The Grafana dashboard where the query originated for 'prometheus-api' sources.

source.grafana.panelId
ID

The panel on the Grafana dashboard where the query originated for 'prometheus-api' sources.

source.name

String description of the feature or tool the query originates from. Available values:

  • apm: Application performance monitoring
  • dashboard: Dashboards displayed on the New Relic platform
  • Distributed tracing: Distributed tracing
  • errors-inbox: Errors inbox
  • infrastructure: Infrastructure monitoring
  • metrics-explorer: Metrics explorer
  • nerdgraph: NerdGraph, our GraphQL API
  • nerdpack: A New Relic application or visualization
  • New Relic user interface: A New Relic curated UI
  • nrql-console: NRQL console
  • prometheus-api: Queries via the Prometheus integration
  • query-api: Insights query API
  • query-builder: Query builder
  • service-levels: Service levels
  • other: Source not specified
source.nerdpackUuid
ID

The unique identifier of the Nerdpack that executed the query, for 'nerdpack' sources.

source.promql.query

The PromQL query string that was translated into the NRQL query that was executed, for 'prometheus-api' sources.

source.url

The URL of the UI page that executed this query.

source.widgetId
ID

The ID of the dashboard widget that executed the query, for 'dashboard' sources.

status
enum

Indicates the successful or unsuccessful execution of the query. Available values:

  • successful: Query executed successfully.
  • error: Query failed to execute due to an error.
  • cancelled: Query execution stopped before fully completed.
  • limited - congestion: Query dropped due to internal New Relic system congestion.
  • limited - inspected count: Query dropped due to your account being over its inspected count resource limits.
  • limited - memory estimation: Query dropped as its estimated memory consumption exceeded system constraints. Reducing the complexity of this query could increase the probability of successful execution.
  • limited: Query dropped, no reason available.
  • timedout: Query timed out before execution completed and did not return results. Try reducing the scope of the query by changing the time window or reducing the number of EventTypes in the FROM clause.
timestamp
milliseconds (ms)

The UNIX timestamp (milliseconds since epoch) of the date and time when the query was executed.

timeWindowMinutes
minutes (min)

The difference in minutes between the SINCE and UNTIL clauses of the query. Often, the longer the time window, the longer the query will run and the more events will be inspected.

user

The email address of the user who executed the query.