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.

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.