La observabilidad de New Relic se basa en el concepto de entities. Este documento explica cómo definimos entidad, qué puede hacer con ellas y cómo puede crear su propia entidad o agrupaciones de entidades.
Sugerencia
¿Quieres un recorrido introductorio por la plataforma New Relic? Ver Conozca la plataforma.
¿Qué es una entidad?
Desde la perspectiva de New Relic, entity es intencionadamente un concepto amplio. Una entidad es cualquier cosa que a) reporta datos a New Relic o que contiene datos a los que tenemos acceso, y b) es algo que hemos identificado con una ID de entidad única. Para la mayoría de las entidades, el ID se indica mediante el atributo entityGuid.
Una entidad puede ser cualquier componente fundamental de generación de informes de datos, como una aplicación, un host o un servicio de base de datos, pero también puede referirse a grupos más grandes de esos componentes. Por ejemplo, para monitor un centro de datos, puede agregar esos hosts en New Relic para que sean una carga de trabajo (una agrupación personalizada de entidades). Esa carga de trabajo es, en sí misma, también una entidad. Te damos la posibilidad de crear tu propia entidad.
También son muy importantes las relaciones entre entidades. Nuestro mapeo de relaciones detrás de escena nos ayuda a comprender cómo están conectadas las entidades, cómo se afectan entre sí. Y esto nos permite darle el poder de configurar cómo se relacionan los datos que ingresa con una entidad existente o cómo se relaciona con otra entidad.
Nuestro enfoque en la entidad y sus relaciones es importante porque nuestro objetivo es brindarle practical information about your business-important entities, en lugar de brindarle un flujo enorme e inútil de datos de una lista enorme de servicios y sistemas de monitoreo. Con más información valiosa a nivel de entidad, puede monitor y solucionar mejor los problemas de sistemas modernos y complejos.
one.newrelic.com: Cuando abres New Relic, llegas a la página All entities , que te brinda una descripción general de la entidad de tu monitor. Desde esta página, puede ver los metadatos de una entidad o hacer clic en una entidad para ver los detalles de rendimiento.
Filtra y explora tu entidad
La barra de filtro de entidades está disponible en muchas páginas UI de New Relic, incluida la vista de lista de entidades principal, APM, laUI , la UI de infraestructura y más. Para aprender a usar la barra de filtros para explorar entidades y guardar filtros útiles, consulte filtro de entidades.
Más información sobre la entidad
Para encontrar el GUID de una entidad y otros metadatos en la UI: desde cualquier lista de entidades, haga clic en el nombre de una entidad. icono y haga clic en See metadata & tags.
Cada entidad tiene un número de identificación específico New Relic , que se informa como el atributo entityGuid. Puede ejecutar NRQL consulta de entidad utilizando su GUID.
Conozca las relaciones entre entidades
A continuación se muestran algunas opciones para comprender las relaciones entre entidades monitoras:
- Al ver una entidad en la UI, utilice la UIRelated entities .
- Utilice mapas de servicios para ver una representación visual de las conexiones.
- Utilice rastreo distribuido para ver cómo las entidades se llaman entre sí en la transacción.
- Utilice nuestra API NerdGraph para ver información de relaciones.
Conozca detalles técnicos sobre la entidad
Para conocer detalles técnicos sobre los tipos de entidades, consulte nuestro repositorio de GitHub para nuestros tipos de entidades. Por ejemplo, para obtener detalles sobre la entidad APM-monitor, consulte Aplicación APM.
Cada entidad contiene varios archivos que rigen la forma en que informa los datos. Por ejemplo, el archivo golden_metrics contiene información sobre su métrica más importante, que suele estar resaltada en nuestras experiencias UI . Aquí está el archivo golden_metrics.yml de APM-monitor entidad.
El archivo definition de una entidad contiene información como:
- El
domain: por ejemplo,APMoInfra. - Es
type: por ejemplo,ApplicationoAWSECSCONTAINERINSTANCE. - Etiqueta predeterminada.
- El
entityExpirationTime: para obtener más información sobre esto, consulte Caducidad de la entidad.
Caducidad de la entidad
Los diferentes tipos de entidad tienen diferentes períodos de vida, determinados por el entityExpirationTime establecido en el archivo definition para cada tipo de entidad. Este tiempo de vencimiento rige cuánto tiempo existe el registro de esa entidad en New Relic después de que la entidad deja de informar datos.
New Relic monitorea una gran cantidad de entidades, y muchas de esas entidades son de corta duración (por ejemplo, el contenedor de Kubernetes). Por estas razones es necesario eliminar periódicamente los registros de entidades que han dejado de reportar datos.
Este tiempo de vencimiento se relaciona con el registro de la propia entidad y no está relacionado con telemetry data. Dicho de otra manera: los telemetry data informados por su entidad monitora se pueden encontrar en NRDB y están disponibles a través de NRQL, dependiendo de su configuración de retención de datos. Pero el registro de la entidad en sí, una vez que caduque, ya no existirá en New Relic.
Las opciones para el tiempo de vencimiento de la entidad son estas:
FOUR_HOURSDAILY(24 horas)EIGHT_DAYS: Valor predeterminado que se aplica si no se define ninguna fecha límite en el archivodefinition.QUARTERLY(3 meses)MANUAL: Esta configuración se aplica solo para entidades cuya creación y eliminación se controlan manualmente (por ejemplo, carga de trabajo y panel de control).
Agrupar y organizar entidad.
Puede colocar entidad en grupos que reflejen relaciones comerciales importantes en su organización. Por ejemplo, podrías agrupar todas las entidades relacionadas con un equipo o departamento específico, o relacionadas con un servicio específico. O puede agrupar varios hosts para reflejar su agrupación en un centro de datos.
Para agrupar su entidad, consulte:
- etiqueta entidad.
- Cree carga de trabajo, que le permitirá agrupar conjuntos de entidades importantes para el negocio.
- Crear entidad y personalizar datos de entidad
Crea y gestiona tu propia entidad con síntesis de entidad
Si tiene telemetría de cualquier fuente que no sea compatible con New Relic de fábrica, puede proponer un mapeo para ello. Una vez aprobada, cualquier telemetría recibida por New Relic que coincida con su archivo de definición se sintetizará en una entidad.
Aprender más:
- Para conocer el atributo reservado y cómo se definen las relaciones entre entidades, siga leyendo este documento.
- Para saber cómo realizar el trabajo de modificar los tipos de entidades existentes o crear otros nuevos, consulte nuestro repositorio de GitHub sobre síntesis de entidades.
Atributo reservado para entidad sintetizada
Estos atributos están pensados para ser sintetizados a partir de la telemetría que recibimos. No los establezca a menos que sea consciente de las participaciones y consecuencias.
Atributo | Descripción |
|---|---|
| Generalmente, no debe configurar este campo de atributo en sus telemetry data. New Relic puede agregar este campo a los datos ingeridos para almacenar un identificador único para la entidad asociada con el punto de datos. Si la telemetría llega con el atributo Un caso de uso para pasar este atributo es asociar la telemetría ingerida con una entidad que ya monitor. Cuando se envía el atributo |
| Este atributo no debe colocarse en telemetry data ingeridos a menos que esté intentando anular el nombre de la entidad que habría sido seleccionado por nuestro sistema de identificación de entidades. Si bien no cambiaremos el valor si ya está presente en los datos, podemos agregar el atributo a sus datos. Por lo tanto, los valores no válidos o inesperados pueden provocar un comportamiento indefinido, como que falte una entidad en la UI o que la telemetría no se asocie con la entidad esperada. Si este campo está presente en la telemetría ingerida, su valor se utilizará para nombrar la entidad asociada con el punto de datos. Este nombre se utilizará en lugar del nombre seleccionado por nuestro sistema de identificación de entidades (por ejemplo, definiciones de síntesis de entidades). Tenga en cuenta que muchas entidades utilizan el nombre como parte de su identificación, por lo que cambiar este campo puede resultar en la generación de una nueva entidad. |
| Este atributo no se debe colocar en telemetry data ingeridos, excepto en ciertos casos legacy en los que es necesario distinguir tipos de entidades. Pasar este campo puede interferir con la detección de entidades, particularmente si se envían valores no reconocidos en este campo. Si bien New Relic no cambiará el valor si ya está presente en los datos, no se garantiza que el campo proporcione un filtrado inequívoco de la telemetría en el momento de la consulta. Las definiciones de entidad existentes ya tienen valores superpuestos y recomendamos evitar New Relic utiliza este campo, lo que significa que los valores no válidos o inesperados pueden provocar un comportamiento indefinido, como que falte una entidad en la UI o que la telemetría no se asocie con la entidad esperada. |
Para aprender cómo realizar el trabajo de modificar tipos de entidades existentes o crear otros nuevos, consulte nuestro repositorio de GitHub sobre síntesis de entidades.
Entidad no instrumentada
Usando su telemetría, podemos detectar entidades que no están siendo instrumentadas en este momento pero que están siendo utilizadas por su aplicación. Por ejemplo, una de sus entidades instrumentadas puede estar llamando a una base de datos de Amazon RDS que actualmente no está instrumentada por New Relic, por lo que no podemos proporcionar ninguna herramienta como monitoreo o alerta para ello.
En ese caso, creamos una denominada "entidad no instrumentada" junto con la relación con la instrumentada. Se muestra en el mapa de servicios de la entidad instrumentada. Proporcionamos instrucciones claras para instrumentarlo, que se muestran con solo hacer clic sobre la entidad.
Relaciones de entidad
New Relic crea automáticamente las conexiones entre entidades en función de lo que podemos inferir de su telemetría. Por ejemplo, cuando dos servicios que se comunican mediante HTTP están instrumentados con New Relic, inferimos una relación de "llamadas/llamados por" entre ellos.
Al visualizar una entidad en las vistas Explorador de entidades, Navegador y Lookout, puede ver su Related entities en el panel derecho. Esto da una visualización de las diversas entidades conectadas directamente a la entidad actual. Puede ver rápidamente métricas importantes para estas entidades relacionadas y navegar de una entidad a otra, a través de todas las partes conectadas de su stack.
Sugerencia
Aprenda a profundizar en las relaciones entre entidades con nuestra API NerdGraph.
Tipos de relaciones de entidad
Las entidades pueden estar relacionadas entre sí de varias maneras. El colapsador a continuación enumera las relaciones de entidades admitidas. Una vez que comprenda las posibles relaciones, eche un vistazo a la lista de relaciones creadas automáticamente o considere si desea crear relaciones de entidad personalizadas.
¿Qué relaciones se crean automáticamente?
Las relaciones automáticas se crean en base a la telemetría que está reportando la entidad. Estas relaciones tienen un Tiempo de Vida (TTL). Esto significa que se eliminarán automáticamente si las métricas utilizadas para crear la relación no son reportadas en un período de tiempo determinado. El TTL predeterminado para una relación es 75 minutos. El TTL puede variar desde 10 minutos hasta 3 días dependiendo del tipo de relación.
Estas son las relaciones entre entidad que creamos automáticamente:
Crear relaciones de entidad personalizadas
Cuando las relaciones no se detectan automáticamente, puede crearlas manualmente usando nuestra API NerdGraph, o puede hacerlo en la UI de New Relic con el enlace Add/edit related entities en Related entities. Actualmente, solo puede crear manualmente relaciones de llamadas/llamados por entre entidades de servicio.
Sugerencia
Para gestionar relaciones manuales, debe tener capacidades de modificación y eliminación de relaciones entre entidades. Si no ve el botón editar relaciones, comuníquese con el administrador de su cuenta.