As of March 22, 2021, we are upgrading Insights to an improved web and mobile experience! All of your Insights URLs will be redirected automatically to the corresponding dashboards in New Relic One. For more details about this migration and how you can easily plan for this transition, see our Explorers Hub post.
New Relic products report a variety of default event data to your account. This document explains how to report your own custom events and attributes.
Value from custom events and attributes
Event data is one of the fundamental New Relic data types. Events are reported by most New Relic products, and we give you several options for reporting your own custom events.
By reporting custom events, you can create more useful and customized queries and charts of your data. This is a key part of optimizing how New Relic works for you.
Avoid rate limits
Reporting a large number of custom events and/or attributes can cause degraded query performance. It may also result in approaching or passing data collection rate limits. For optimal performance, first think about what data you want to analyze, and then create only the events and/or attributes necessary to meet these specific goals.
Be aware of the following data and subscription requirements for inserting and accessing custom data:
- Ensure you follow limits and requirements around event/attribute data types, naming syntax, and size.
- The amount of data you have access to over time depends on your data retention policy.
Send custom events and attributes
Methods for sending custom events and attributes include:
|Source||How to send custom data|
|APM agent||Use APM agent APIs to report custom events and custom attributes.|
|Browser monitoring agent|
|Event API||To report custom events not associated with other New Relic products, use the Event API.|
|Infrastructure monitoring agent||Add custom attributes to default Infrastructure events. Use the Flex integration tool to report your own custom event data.|
|Mobile monitoring agent||Use the mobile agent API to send custom events and attributes.|
|Synthetic monitoring||Add custom attributes to the
For ways to report other types of custom data, see:
Extend data retention
To learn how to extend how long events are retained in your account, see our documentation about event data retention.