Recursos OpenTelemetry no New Relic

Todos os dados do OpenTelemetry estão associados a um recurso. Um recurso é uma representação da entidade que produz telemetria como atributo de recurso. Os recursos atributo são usados para adaptar um recurso à New Relic noção de entidade.

Os dados recebidos são associados a uma entidade através de um processo denominado síntese de entidade , em que os atributos de recursos presentes são comparados com regras que determinam o tipo de entidade à qual os dados serão associados. Para dados OpenTelemetry provenientes do , as regras de síntese de entidade são projetadas para respeitar as OpenTelemetry convenções semânticas de recursos.

As convenções semânticas de recursos definem diferentes corpos de convenções para descrever diferentes tipos de entidade. Por exemplo, as convenções de serviço e host definem o atributo de recurso que descreve uma instância de serviço ou host, respectivamente.

Tipos de entidade suportados

Aqui estão descritos os tipos de entidade New Relic que são suportados ao usar a instrumentação OpenTelemetry. Incluídos para cada tipo de entidade compatível estão:

• O atributo de recurso necessário para a síntese da entidade.
• Atributo recomendado que orienta certos aspectos da interface do New Relic .
• Atributo que se transforma em tag entidade, quando presente.

Serviços

Uma entidade de serviço é sintetizada aderindo às convenções semânticas de recurso OpenTelemetry que descrevem uma instância de serviço.

Consulte nossa documentação e exemplos para entidades de serviço de monitoramento usando OpenTelemetry.

Atributo obrigatório

• service.name: o nome do serviço que você vê na interface vem desse valor.

Atributo recomendado

• service.instance.id: permite o facetamento entre várias instâncias do mesmo serviço.
• telemetry.sdk.language: quando presente, esse valor orienta a exibição de qualquer interface específica de tempo de execução, como a página de tempo de execução JVM para aplicativo Java.

Etiqueta entidade

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

Anfitriões

Uma entidade host é sintetizada aderindo às convenções semânticas de recurso OpenTelemetry que descrevem um host.

Consulte o exemplo de monitoramento de host no coletor para monitoramento de infraestrutura para obter mais detalhes.

Atributo obrigatório

• host.name: o nome do host que você vê na interface vem desse valor.
• host.id

Etiqueta entidade

• 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

Instância Redis

Uma instância Redis é sintetizada usando dados emitidos pelo receptorRedis coletor. Infelizmente, atualmente não há convenções semânticas para instância Redis ou atributos de identificação na métrica que o receptor Redis emite. Portanto, o usuário deve incluir manualmente o atributo descrito abaixo.

Consulte o exemplo do Redis no coletor para monitoramento de infraestrutura para obter mais detalhes.

Atributo obrigatório

• server.address: o nome da instância Redis que você vê na interface vem desse valor.
• server.port

Etiqueta entidade

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

Relacionamentos de entidades apoiadas

New Relic suporta relacionamentos entre entidades provenientes da instrumentação OpenTelemetry . Esses relacionamentos são sintetizados automaticamente quando os critérios de relacionamento apropriados são atendidos. Abaixo estão os relacionamentos atualmente suportados e os critérios exigidos.

Serviço para hospedar

Os relacionamentos entre um serviço e uma entidade de host exigem que o serviço inclua o atributo de recurso host.id e que corresponda ao host.id do host em que está sendo executado.

Amazon CloudWatch Metric Streams

Sua infraestrutura hospedada na AWS pode ser monitorada com a integração do New Relic com o Amazon CloudWatch Metric Streams. Esta não é uma solução OpenTelemetry para monitorar sua infraestrutura. No entanto, o New Relic oferece suporte a uma série de relacionamentos entre serviços instrumentados OpenTelemetry e infraestrutura monitorada usando Amazon CloudWatch Metric Streams.

ElastiCache (Memcached)

A integração do Amazon CloudWatch Metric Streams para Elasticache gera entidade do ElastiCache no New Relic. Estas entidades terão a seguinte etiqueta entidade:

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

Se seus serviços utilizam instrumentação OpenTelemetry para Memcached ele deve emitir o seguinte atributo para que um relacionamento seja gerado:

• db.system: Este atributo deve ter o valor memcached.
• net.peer.name: Este atributo deve corresponder à correspondente endpoint tag da entidade ElastiCache.
• net.peer.port: Este atributo deve corresponder à tag de porta correspondente da entidade ElastiCache.

Amazon MQ (ActiveMQ)

A integração do Amazon CloudWatch Metric Streams para Amazon MQ gera entidade do Amazon MQ no New Relic. Estas entidades terão a seguinte tag entidade:

• aws.mq.endpoint

Se seus serviços utilizam instrumentação OpenTelemetry para ActiveMQ é necessário o seguinte atributo para que um relacionamento seja gerado:

• messaging.system: Este atributo deve ter o valor activemq.
• server.address: Este atributo deve corresponder à tag de endpoint correspondente da entidade do Amazon MQ.
• span.kind: Este relacionamento é gerado a partir de dados de intervalo onde span.kind é producer ou consumer.

Amazon Kafka gerenciado (MSK)

A integração do Amazon CloudWatch Metric Streams para MSK gera entidade MSK no New Relic. Estas entidades terão a seguinte tag entidade:

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

Se seus serviços utilizam instrumentação OpenTelemetry para MSK, ele deve ter o seguinte atributo para que um relacionamento seja gerado:

• messaging.destination.name: O tópico MSK para o qual o serviço está produzindo ou consumindo mensagens.
• server.address: Este atributo deve corresponder à correspondente endpoint tag da entidade MSK.
• span.kind: Este relacionamento é gerado a partir de dados de intervalo onde span.kind é producer ou consumer.

Adicionando tag personalizada a uma entidade

Você pode usar tag para organizar e filtrar sua entidade na interface. tag são pares de valores principais, por exemplo team: operations, adicionados a vários conjuntos de dados, como aplicativos de monitoramento e hosts. Certos atributos importantes ficam automaticamente disponíveis como tag, como ID da conta; você também pode adicionar sua própria tag personalizada diretamente na interface ou com um dos métodos abaixo.

Adicionar atributo de recurso prefixado com tags resultará em uma tag em sua entidade no New Relic. Por exemplo, adicionar o atributo tags.mytag=myvalue resultará na tag de entidade mytag=myvalue.