Recursos do OpenTelemetry: práticas recomendadas

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 da.

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 monitoramento de serviços de entidade usando OpenTelemetry.

Atributo obrigatório

• service.name: O nome da entidade que você vê na interface vem desse valor.
• host.name: O nome do host que você vê na interface vem desse valor.

Atributo recomendado

• service.instance.id

  • Permite o facetamento entre múltiplas instâncias do mesmo serviço.

• telemetry.sdk.language

  • Quando presente, direciona a exibição de qualquer interface específica de tempo de execução. Por exemplo, 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 nossa documentação para monitoramento de entidade host usando o receptor métrico de host para o coletor OpenTelemetry .

Atributo obrigatório

• host.name
• 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

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.