New Relic products automatically populate your Insights account with data contained in specific events. You can add additional data to those events (called custom attributes), or send your own events with your own attributes entirely (called custom events). Then, use NRQL or the Insights Event explorer to sample, query, and chart event data, including your custom events.
Guidelines and requirements
Adding a high number of custom attributes and events may cause degraded query performance and run up against insertion rate limits for events. For optimal performance, first think about what data you want to analyze, and then create only the custom attributes required for the events.
Be aware of the following data and subscription requirements for inserting and accessing custom data:
- Ensure you follow general data requirements around event/attribute data types, naming syntax, and size.
- The amount of data you can access in Insights depends on your New Relic subscription's data retention policy.
Ways to send custom data
Use these methods to send custom data to Insights, based on what other New Relic products and agents you are using.
|Source||How to send custom data|
|APM agent||Use agent API to send custom events and custom attributes to the APM
|Insights REST API||Insert custom events with the Insights REST API.|
|Infrastructure||Add custom attributes to default Infrastructure events.|
|Mobile agent||Use the mobile agent API to send custom events and custom attributes.|
|Synthetics||Add custom attributes to the