This document contains general requirements and rules for inserting and using your custom data. Additional requirements may apply based on the method you use.
Access to your custom data depends on your Insights subscription's data retention.
When inserting custom events and attributes to Insights follow these general requirements for supported data types, naming syntax, and size:
|Attribute data types||
Attribute values can be either a string or a numeric (an integer or float). Insights does not support "coercion." A number stored as a string is treated as a string and cannot be operated on by functions expecting float values.
If your attribute values contain date information, define it as an unformatted Unix timestamp (in seconds or milliseconds) via the Insights' Data formatter.
Event and attribute names can be a combination of alphanumeric characters, underscores
Do not use words reserved for use by NRQL and Insights.
|Maximum size or length|
|Null values||The database does not store any data with a null value.|
Avoid using the following reserved words as names for events and attributes. Otherwise, unexpected results may occur.
This is not a complete list. In general, avoid using any MySQL reserved words as New Relic continues to add new features.
This is a reserved attribute name. If it is included, it will be dropped during ingest.
Value must be an integer. If it is not an integer, the attribute name and value will be dropped during ingest.
Must be a Unix epoch timestamp. You can define timestamps either in seconds or in milliseconds. It must be +/-1 day (24 hours) of the current time on the server.
The event type as stored by New Relic Insights. New Relic agents and scripts normally report this as
|NRQL syntax terms||
If you need to use NRQL syntax terms as attribute names, they must be enclosed in backticks; for example,
Additional Browser PageAction requirements
For additional requirements for using New Relic Browser's custom
PageAction event, see Insert custom data via New Relic Browser agent.
Additional Insights API requirements
See Insights Insert API for more requirements and details.
Event type limits
The current limit for total number of event types is 250 per sub-account, in a given 24-hour time period. If a user exceeds this limit, New Relic may filter or drop data. Event types include:
- Default events from New Relic agents
- Custom events from New Relic agents
- Custom events from Insights custom event inserter