Use New Relic's
NrIntegrationError event to understand problems related to data ingest, limits, and feature configuration.
Troubleshoot data ingest with NrIntegrationError
NrIntegrationError event is used to capture issues related to:
- Exceeding of our data ingest limits
- Exceeding of our query limits
- Malformed data
- Configuration issues
You can run NRQL queries to analyze
NrIntegrationError error messages. You can also set up alerts to be notified when specific types of errors, or certain quantities of errors, occur.
NrIntegrationError events are primarily categorized by the feature that is sending them, as indicated by the
newRelicFeature attribute. Values include:
Metricsindicates an issue with Metric API ingest.
Event APIindicates an issue with Event API ingest.
Logsindicates an issue with logs ingest.
Distributed Tracingindicates an issue with distributed tracing (
Infrastructureindicates an issue with infrastructure integrations
For attribute definitions, see the data dictionary.
Query and alert
You can query
NrIntegrationError events using NRQL, and set up NRQL alert conditions to get notified when issues happen.
Here are some examples of queries:
If you want to examine the structure of this event and see what attributes are attached, you can use a
keyset() query, like this:
FROM NrIntegrationError SELECT keyset()
Tutorials and examples
Here are links to docs that go into more detail about how to use
NrIntegrationError-related docs for our core ingest APIs.
NrIntegrationError events are generated not just for direct use of these APIs but for any New Relic tools that rely on those API endpoints for reporting data:
- Metric API: see Troubleshoot Metric API ingest
- Event API: see parsing errors and tips for troubleshooting event reporting.
- Log API: See No log data appears.
- Trace API: see Response validation and Troubleshoot missing data.
- View the limits UI (
NrIntegrationErroris used to create these charts)
- Limit-related query examples
Specific agents and integrations
- APM agent: Config mismatch
- Prometheus: OpenMetrics errors | Remote write errors
Programmatically use NrIntegrationError events
If you're interested in manipulating these events via API, see Programmatically use NrIntegrationError.
Understand changes to your account
If you're trying to understand changes that have been made in your New Relic account (like when a user made a change), see