Recursos de OpenTelemetry en New Relic

Todos los datos de OpenTelemetry están asociados con un recurso. Un recurso es una representación de la entidad que produce telemetría como atributo de recurso. Los atributos de recurso se emplean para adaptar un recurso a New Relic la noción de entidad.

Los datos recibidos se asocian con una entidad a través de un proceso llamado síntesis de entidades mediante el cual el atributo de recurso presente se compara con reglas que determinan el tipo de entidad a la que se asociarán los datos. Para los datos obtenidos de OpenTelemetry, las reglas de síntesis de entidades están diseñadas para respetar las OpenTelemetry convenciones semánticas de recursos de .

Las convenciones semánticas de recursos definen diferentes cuerpos de convenciones para describir diferentes tipos de entidad. Por ejemplo, las convenciones de servicio y host definen el atributo de recurso que describe una instancia de servicio u host, respectivamente.

Tipos de entidad admitidos

Aquí se describen los tipos de entidad New Relic que son compatibles cuando se emplea la instrumentación OpenTelemetry . Para cada tipo de entidad admitida se incluyen:

• El atributo de recurso requerido para la síntesis de entidades.
• Atributo recomendado que impulsa ciertos aspectos de la New Relic UI.
• Atributo que se convierte en entidad etiqueta, cuando está presente.

Servicios

Una entidad de servicio se sintetiza siguiendo las convenciones semánticas de recursos de OpenTelemetry que describen una instancia de servicio.

Consulte nuestra documentación y ejemplos para monitorear entidades de servicio usando OpenTelemetry.

Atributo requerido

• service.name: el nombre del servicio que ves en la UI proviene de este valor.

Atributo recomendado

• service.instance.id: habilita el facetado entre varias instancias del mismo servicio.
• telemetry.sdk.language: cuando está presente, este valor controla la visualización de cualquier UI específica del tiempo de ejecución, como la página de tiempo de ejecución JVM para la aplicación Java.

Entidad etiqueta

• service.namespace
• telemetry.sdk.language (agregado como etiqueta de idioma)
• telemetry.sdk.version
• k8s.cluster.name
• k8s.namespace.name
• k8s.deployment.name

Hospedadores

Una entidad de host se sintetiza siguiendo las convenciones semánticas de recursos de OpenTelemetry que describen un host.

Consulte el ejemplo de monitoreo de host en recolector de monitoreo de infraestructura para obtener más detalles.

Atributo requerido

• host.name: el nombre de host que ves en la UI proviene de este valor.
• host.id

Entidad etiqueta

• cloud.provider
• cloud.account.id
• cloud.region
• cloud.availability_zone
• cloud.platform
• host.id
• host.name
• host.type
• host.arch
• host.image.name
• host.image.id
• host.image.version

Instancia Redis

Una instancia de Redis se sintetiza empleando datos emitidos desde el recolector receptorRedis . Lamentablemente, actualmente no existen convenciones semánticas para la instancia Redis ni para identificar atributos en la métrica que emite el receptor Redis . Por lo tanto, los usuarios deberán incluir manualmente el atributo que se describe a continuación.

Consulte el ejemplo Redis en el recolector de monitoreo de infraestructura para obtener más detalles.

Atributo requerido

• server.address: el nombre de la instancia Redis que ves en la UI proviene de este valor.
• server.port

Entidad etiqueta

• redis.version
• redis.role
• host.type
• cloud.provider
• cloud.account.id
• cloud.region
• instrumenation.name
• server.address
• server.port

Relaciones entre entidades soportadas

New Relic soporta relaciones entre entidades provenientes de la instrumentación OpenTelemetry . Estas relaciones se sintetizan automáticamente cuando se cumplen los criterios de relación adecuados. A continuación se detallan las relaciones que se admiten actualmente y sus criterios requeridos.

Servicio de hospedaje

Las relaciones entre un servicio y una entidad host requieren que el servicio incluya el atributo de recurso host.id y que coincida con el host.id del host en el que se ejecuta.

Amazon CloudWatch Metric Streams

Su infraestructura alojada en AWS se puede monitorear con la integración de New Relic con Amazon CloudWatch Metric Streams. Esta no es una solución OpenTelemetry para monitorear su infraestructura. Sin embargo, New Relic admite un serial de relaciones entre los servicios instrumentados OpenTelemetry y la infraestructura monitoreada mediante Amazon CloudWatch Metric Streams.

ElastiCache (Memcached)

La integración de Amazon CloudWatch Metric Streams para Elasticache genera la entidad ElastiCache en New Relic. Estas entidades tendrán la siguiente etiqueta de entidad:

• aws.elasticache.configurationEndpointAddress o aws.elasticache.endpointAddress
• aws.elasticache.configurationEndpointPort o aws.elasticache.endpointPort

Si sus servicios emplean instrumentación OpenTelemetry para Memcached debe emitir el siguiente atributo para que se genere una relación:

• db.system:Este atributo debe tener el valor memcached.
• net.peer.name: Este atributo debe coincidir con la etiqueta de extremo correspondiente de la entidad ElastiCache.
• net.peer.port:Este atributo debe coincidir con la etiqueta de puerto correspondiente de la entidad ElastiCache.

Amazon MQ (ActiveMQ)

La integración de Amazon CloudWatch Metric Streams para Amazon MQ genera entidades de Amazon MQ en New Relic. Estas entidades tendrán la siguiente etiqueta de entidad:

• aws.mq.endpoint

Si sus servicios emplean instrumentación OpenTelemetry para ActiveMQ debe tener el siguiente atributo para que se genere una relación:

• messaging.system:Este atributo debe tener el valor activemq.
• server.address: Este atributo debe coincidir con la etiqueta de extremo correspondiente de la entidad Amazon MQ.
• span.kind:Esta relación se genera a partir de datos de intervalo donde span.kind es producer o consumer.

Kafka gestionado por Amazon (MSK)

La integración de Amazon CloudWatch Metric Streams para MSK genera entidad MSK en New Relic. Estas entidades tendrán la siguiente etiqueta de entidad:

• aws.clusterName o aws.kafka.ClusterName
• aws.awsRegion o aws.region
• aws.topic o aws.kafka.Topic

Si sus servicios emplean instrumentación OpenTelemetry para MSK debe tener el siguiente atributo para que se genere una relación:

• messaging.destination.name:El tema MSK en el que el servicio produce o consume mensajes.
• server.address: Este atributo debe coincidir con la etiqueta de extremo correspondiente de la entidad MSK.
• span.kind:Esta relación se genera a partir de datos de intervalo donde span.kind es producer o consumer.

Agregar una etiqueta personalizada a una entidad

Puedes usar etiqueta para organizar y filtrar tu entidad en la UI. etiqueta son pares de valores principales, por ejemplo team: operations, agregados a varios conjuntos de datos, como aplicaciones de monitoreo y hosts. Ciertos atributos importantes están disponibles automáticamente como etiqueta, como el ID de cuenta; También puedes agregar tu propia etiqueta personalizada directamente en la UI o con uno de los métodos siguientes.

Agregar un atributo de recurso con el prefijo tags dará como resultado una etiqueta en su entidad en New Relic. Por ejemplo, agregar el atributo tags.mytag=myvalue dará como resultado la etiqueta de entidad mytag=myvalue.