---
title: Use NrIntegrationError event to understand data ingest problems
source: https://docs.newrelic.com/docs/data-apis/manage-data/nrintegrationerror
---

Use New Relic's `NrIntegrationError` event to understand problems related to data ingest, limits, and feature configuration.

## Troubleshoot data ingest with NrIntegrationError [#overview]

Our `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:

-   `Metrics` indicates an issue with [Metric API](https://docs.newrelic.com/docs/telemetry-data-platform/ingest-apis/metric-api/introduction-metric-api) ingest.
-   `Event API` indicates an issue with [Event API](https://docs.newrelic.com/docs/telemetry-data-platform/ingest-apis/introduction-event-api) ingest.
-   `Logs` indicates an issue with logs ingest.
-   `Distributed Tracing` indicates an issue with [distributed tracing](https://docs.newrelic.com/docs/distributed-tracing/concepts/introduction-distributed-tracing) (`Span`) data.
-   `Infrastructure` indicates an issue with [infrastructure integrations](https://docs.newrelic.com/docs/infrastructure/infrastructure-integrations/get-started/introduction-infrastructure-integrations/)

For attribute definitions, see the [data dictionary](/attribute-dictionary/?event=NrIntegrationError).

## Query and alert [#query-alert]

You can query `NrIntegrationError` events using [NRQL](https://docs.newrelic.com/docs/query-your-data/nrql-new-relic-query-language/get-started/introduction-nrql-new-relics-query-language), and set up [NRQL alert conditions](https://docs.newrelic.com/docs/alerts-applied-intelligence/new-relic-alerts/alert-conditions/create-nrql-alert-conditions) to get notified when issues happen.

Here are some examples of queries:

**Query of Event API issues**

Here's a simple query of `NrIntegrationError`. This one shows Event API ingest issues from the last week, with up to 100 results:

````sql
SELECT message FROM NrIntegrationError WHERE newRelicFeature = 'Event API' SINCE 1 WEEK AGO LIMIT 100
```

For more detailed queries, see [Example queries](#use-cases).

````

**Query of Metric API issues**

Here's a simple query of issues with the Metric API:

````sql
SELECT message FROM NrIntegrationError WHERE newRelicFeature = 'Metrics' SINCE 1 WEEK AGO LIMIT 100
```

For more detailed queries, see [Example queries](#use-cases).

````

**Limit-related queries**

See [Data limits](#limit-related).

**Query of distributed tracing issues**

Here's a simple query of issues with distributed tracing data:

````sql
SELECT message FROM NrIntegrationError WHERE newRelicFeature = 'Distributed Tracing' SINCE 1 WEEK AGO LIMIT 100
```

For more detailed queries, see [Example queries](#use-cases).

````

**Query of issues over time**

Here's a query showing a count of `NrIntegrationError` events over time:

````sql
SELECT count(*) FROM NrIntegrationError WHERE newRelicFeature = 'Metrics' TIMESERIES
```

For more detailed queries, see [Example queries](#use-cases).

````

**Query of blocked alert condition events**

Here's a query showing a count of `NrIntegrationError` blocked alert condition events:

````sql
SELECT count(*) FROM NrIntegrationError WHERE newRelicFeature = 'Alerts' AND name = 'ConditionBlockedNotification'
```

For more detailed queries, refer to [Example queries](#use-cases).

````

If you want to examine the structure of this event and see what attributes are attached, you can use a [`keyset()`](https://docs.newrelic.com/docs/query-your-data/nrql-new-relic-query-language/get-started/nrql-syntax-clauses-functions/#keyset) query, like this:

```sql
FROM NrIntegrationError SELECT keyset()
```

## Tutorials and examples [#use-cases]

Here are links to docs that go into more detail about how to use `NrIntegrationError`.

### Ingest APIs [#ingest-related]

Below are `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](https://docs.newrelic.com/docs/telemetry-data-platform/ingest-apis/metric-api/troubleshoot-nrintegrationerror-events)
-   Event API: see [parsing errors](https://docs.newrelic.com/docs/telemetry-data-platform/ingest-apis/introduction-event-api/#errors-parsing) and [tips for troubleshooting event reporting](https://docs.newrelic.com/docs/telemetry-data-platform/ingest-apis/introduction-event-api/#nrIntegration).
-   Log API: See [No log data appears](https://docs.newrelic.com/docs/logs/log-management/troubleshooting/no-log-data-appears-ui).
-   Trace API: see [Response validation](https://docs.newrelic.com/docs/distributed-tracing/trace-api/trace-api-general-requirements-limits/#response-validation) and [Troubleshoot missing data](https://docs.newrelic.com/docs/apm/distributed-tracing/trace-api/troubleshooting-missing-trace-api-data).

### Data limits [#limit-related]

Limit-related docs:

-   [View the limits UI](https://docs.newrelic.com/docs/telemetry-data-platform/manage-data/view-system-limits) (`NrIntegrationError` is used to create these charts)
-   [Limit-related query examples](https://docs.newrelic.com/docs/telemetry-data-platform/manage-data/query-limits)

### Specific agents and integrations [#agent-related]

-   APM agent: [Config mismatch](https://docs.newrelic.com/docs/agents/manage-apm-agents/troubleshooting/agent-nrintegrationerrors-appear-insights)
-   [StatsD](https://docs.newrelic.com/docs/integrations/host-integrations/host-integrations-list/statsd-monitoring-integration-version-2)
-   Prometheus: [OpenMetrics errors](https://docs.newrelic.com/docs/integrations/prometheus-integrations/troubleshooting/rate-limit-errors-prometheus-integration) \| [Remote write errors](https://docs.newrelic.com/docs/integrations/prometheus-integrations/install-configure-remote-write/remote-write-errors-error-messages)

## Programmatically use NrIntegrationError events [#use-api]

If you're interested in manipulating these events via API, see [Programmatically use NrIntegrationError](https://docs.newrelic.com/docs/telemetry-data-platform/ingest-apis/metric-api/troubleshoot-nrintegrationerror-events/#programmatically-retrieve-nrintegrationerror-events).

## Understand changes to your account [#audit-events]

If you're trying to understand changes that have been made in your New Relic account (like when a user made a change), see [`NrAuditEvent`](https://docs.newrelic.com/docs/telemetry-data-platform/understand-data/event-data/nrauditevent-event-data-query-examples).