Este documento contiene requisitos y reglas generales para insertar y utilizar eventos personalizados y sus atributos asociados. Es posible que se apliquen requisitos adicionales según el método que utilice.
Puedes reportar un evento personalizado a New Relic de varias maneras, incluyendo:
evento API (Existen requisitos adicionales al utilizar la API de eventos).
(existen requisitos adicionales con el evento personalizado
PageAction
.)
Requerimientos generales
Al informar eventos personalizados y atributos, siga estos requisitos generales para los tipos de datos admitidos, la sintaxis de nombres y el tamaño:
Requisito | Descripción |
---|---|
Payload | Tamaño o longitud máxima total: 1MB (10^6 bytes) maximum per POST. Recomendamos encarecidamente utilizar compresión. La carga útil debe estar codificada como UTF-8. La API de eventos tiene límites de velocidad HTTP adicionales. |
Tipos de datos de atributos | Los valores de los atributos pueden ser una cadena, un número entero o flotante. Para obtener información sobre cómo formatear los datos de fecha y hora, consulte Fecha/hora personalizada. |
Límites de atributos | Longitud máxima del nombre del atributo: 255 caracteres. Longitud máxima de los valores del atributo personalizado:
|
Sintaxis de nomenclatura para eventos y atributos | Los nombres de eventos pueden ser una combinación de caracteres alfanuméricos, dos puntos ( Recomendamos comenzar los nombres con una letra: si comienzan con otra cosa, deberás poner comillas graves alrededor del nombre al realizar la consulta. Para obtener más información sobre cuándo se requieren acentos graves en una consulta, consulte la referencia de NRQL. No utilice palabras reservadas para uso de NRQL. Longitud máxima del nombre del evento: 255 caracteres. |
Valores nulos | La base de datos no almacena ningún dato con un valor nulo. |
Palabras reservadas
Evite utilizar las siguientes palabras reservadas como nombres para eventos y atributos. De lo contrario, pueden producirse resultados inesperados.
Importante
Esta no es una lista completa. En general, evite el uso de palabras reservadas de MySQL para evitar colisiones con futuras funciones de New Relic.
Keyword | Description |
---|---|
| Este es un nombre de atributo reservado. Si está incluido, se eliminará durante la ingesta. |
| El valor debe ser un número entero. Si no es un número entero, el nombre y el valor del atributo se eliminarán durante la ingesta. |
| El tipo de evento almacenado en New Relic. El agente y el script de New Relic normalmente informan esto como |
Valores | Para su valor
|
| Debe ser una timestamp de Unix epoch. Puede definir la marca de tiempo en segundos o en milisegundos. Debe ser +/-1 día (24 horas) de la hora actual en el servidor. |
Términos de reenvío de logs | Las siguientes claves están reservadas por el reenvío de registros característico del agente de infraestructura: |
Términos de sintaxis NRQL | Si necesita utilizar términos de sintaxis NRQL como nombres de atributos, incluidos los atributos con puntos, deben estar entre comillas invertidas; por ejemplo,
|
Límites de tipo de evento
El límite actual para el número total de valores eventType
es 250 por cuenta (no por organización) en un período determinado de 24 horas. Si una cuenta excede este límite, New Relic puede filtrar o eliminar datos. Los tipos de eventos incluyen:
- Evento predeterminado del agente New Relic e integración
- Evento personalizado de agente o
- Evento personalizado desde evento API