Te ofrecemos esta traducción automática para facilitar la lectura.
En caso de que haya discrepancias entre la versión en inglés y la versión traducida, se entiende que prevalece la versión en inglés. Visita esta página para obtener más información.
Si tiene APM, puede informar datos de eventos personalizados. Luego podrá consultar y visualizar sus datos en New Relic.
Consideraciones de datos
El agente New Relic envía datos de eventos a New Relic como parte del ciclo de recolección normal cada cinco segundos para las versiones de agente que admiten transmisión en tiempo real.
Enviar muchos eventos puede aumentar la sobrecarga de memoria del agente. New Relic impone un límite superior de 833 eventos personalizados cada 5 segundos. Además, no se registrarán publicaciones con un tamaño superior a 1 MB (10^6 bytes), independientemente del límite del evento personalizado.
También puedes enviar eventos personalizados usando la API de eventos (sin necesidad de APM). Sin embargo, tenga en cuenta que el evento personalizado enviado con las API del agente no es compatible con el modo de alta seguridad.
Para grabar un evento personalizado, sigue los procedimientos de tu agente de lenguaje de New Relic. Para agregar un atributo personalizado al evento APM, primero debe habilitarlos para su agente APM y luego realizar una llamada API para registrar el atributo. Siga los procedimientos de atributo personalizado específicos del agente.
Al crear su propio evento personalizado y atributo, siga los requisitos de datos para:
Para agregar un evento personalizado al monitoreo de aplicaciones por parte del agente Go, use RecordCustomEvent. Luego puede agregar un atributo personalizado para su aplicación Go.
La colección de eventos personalizados está habilitada de forma predeterminada en agente de Java versión 3.13.0 o superior. Para enviar un evento personalizado, llame al recordCustomEvent. Por ejemplo:
El primer argumento define el nombre de su tipo de evento y el segundo argumento es un mapa con el atributo para su evento personalizado. El atributo del evento debe ser cadenas o números. Asegúrese de limitar la cantidad de nombres de tipos de eventos únicos que crea y no genere estos nombres dinámicamente. Para conocer las restricciones sobre los nombres de tipos de eventos, consulte nuestra documentación sobre límites y caracteres restringidos y palabras reservadas NRQL.
Puede cambiar el número máximo de eventos registrados por el agente de Java mediante un parámetro de configuración en newrelic.yml.
Especifique el número máximo de eventos para registrar por minuto como un número entero. Por ejemplo, si desea enviar menos eventos que los 10000 predeterminados:
custom_insights_events:
max_samples_stored:5000
Para desactivar completamente el evento personalizado, agregue lo siguiente a su newrelic.yml:
Para versiones de agente de Java anteriores a 4.1.0, utilice la siguiente configuración YAML:
custom_insights_events.enabled:true
custom_insights_events.max_samples_stored:5000
La colección de eventos personalizados está habilitada de forma predeterminada en la versión 4.6.29.0 o superior del agente .NET. Para enviar un evento personalizado, simplemente llame al RecordCustomEvent(). Por ejemplo:
var eventAttributes =newDictionary<String, Object>();
El primer argumento define el nombre de su tipo de evento y el segundo argumento es un IEnumerable con el atributo de su evento personalizado. Asegúrese de limitar la cantidad de nombres de tipos de eventos únicos que crea y no genere estos nombres dinámicamente. Para conocer las restricciones sobre los nombres de tipos de eventos, consulte nuestra documentación sobre límites y caracteres restringidos y palabras reservadas NRQL.
Puedes desactivar el evento personalizado por completo configurando customEvents.enabled en false en newrelic.config.
La colección de eventos personalizados está habilitada de forma predeterminada en la versión 1.15.0 o superior del agente Node.js. Para enviar un evento personalizado, simplemente llame a la API correspondiente. Por ejemplo:
recordCustomEvent(eventType, attributes)
Utilice recordCustomEvent() para registrar una métrica basada en eventos, generalmente asociada con una duración particular. El eventType debe ser una cadena alfanumérica de menos de 255 caracteres. El atributo debe ser un objeto de pares clave y valor. Las claves deben tener menos de 255 caracteres y los valores deben ser cadenas, números o booleanos. Para conocer las restricciones sobre los nombres de tipos de eventos, consulte nuestra documentación sobre límites y caracteres restringidos y palabras reservadas NRQL.
Para deshabilitar completamente el evento personalizado, agregue custom_insights_events.enabled: false a newrelic.js.
La colección de eventos personalizados está habilitada de forma predeterminada en la versión 4.18 o superior del agente PHP. Para enviar un evento personalizado, simplemente llame a la función API correspondiente. Por ejemplo:
El primer argumento define el nombre de su tipo de evento y el segundo argumento es una matriz con el atributo para su evento personalizado. Asegúrese de limitar la cantidad de nombres de tipos de eventos únicos que crea y no genere estos nombres dinámicamente. Para conocer las restricciones sobre los nombres de tipos de eventos, consulte nuestra documentación sobre límites y caracteres restringidos y palabras reservadas NRQL.
De forma predeterminada, el número máximo de eventos personalizados registrados por minuto es 10.000. Esta configuración no se puede cambiar.
Para deshabilitar completamente el evento personalizado, agregue newrelic.custom_insights_events.enabled = false a su newrelic.ini y reinicie el agente.
La colección de eventos personalizados está habilitada de forma predeterminada en la versión 2.60.0.46 o superior del agente Python. Para enviar un evento personalizado, simplemente llame a la API correspondiente. Por ejemplo:
El event_type define el nombre (o tipo) del evento personalizado. El atributo del evento personalizado debe pasarse como un diccionario mediante el argumento de palabra clave params . Asegúrese de limitar la cantidad de nombres de tipos de eventos únicos que crea y no genere estos nombres dinámicamente. Para conocer los límites y restricciones de event_type y params, consulte nuestra documentación sobre límites, caracteres restringidos y palabras reservadas.
Si se llama fuera del contexto de una solicitud web de monitor o de una tarea en segundo plano, la llamada se ignorará a menos que se proporcione el argumento de palabra clave application y se proporcione un objeto de aplicación correspondiente a la aplicación en la que se debe registrar la excepción. Se puede obtener un objeto de aplicación adecuado utilizando la función newrelic.agent.application() .
Para deshabilitar completamente el evento personalizado, establezca custom_insights_events.enabled en False en su archivo de configuración newrelic.ini .
La colección de eventos personalizados está habilitada de forma predeterminada en la versión 3.9.8.273 o superior del agente Ruby. Para enviar un evento personalizado, simplemente llame a la API correspondiente. Por ejemplo:
El primer argumento define el nombre de su tipo de evento y el segundo argumento es un hash con el atributo de su evento personalizado. Asegúrese de limitar la cantidad de nombres de tipos de eventos únicos que crea y no genere estos nombres dinámicamente. Para conocer las restricciones sobre los nombres de tipos de eventos, consulte nuestra documentación sobre límites y caracteres restringidos y palabras reservadas NRQL.
Puede cambiar la cantidad máxima de eventos registrados por el agente Ruby a través de un parámetro de configuración en newrelic.yml:
Especifique el número máximo de eventos para registrar por minuto como un número entero. Por ejemplo, si desea poder enviar hasta 5000 eventos por minuto, agregue:
Para deshabilitar completamente el evento personalizado, agregue custom_insights_events.enabled: false a newrelic.yml.
Marca de tiempo
No puede especificar una timestamp en un evento que se recopila y registra a través del agente. El agente asignará automáticamente una timestamp al evento en función de cuándo se registran a través de la API.
Antes de crear un atributo personalizado, revise la lista de términos reservados utilizados por NRQL de New Relic. De lo contrario, pueden producirse resultados inesperados.