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.namespacetelemetry.sdk.language(adicionado como tag de idioma)telemetry.sdk.versionk8s.cluster.namek8s.namespace.namek8s.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
Etiqueta entidade
cloud.providercloud.account.idcloud.regioncloud.availability_zonecloud.platformhost.idhost.namehost.typehost.archhost.image.namehost.image.idhost.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.versionredis.rolehost.typecloud.providercloud.account.idcloud.regioninstrumenation.nameserver.addressserver.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.
Relacionamentos de serviço para infraestrutura usando o OpenTelemetry Collector
O OpenTelemetry Collector pode ser usado para monitorar sua infraestrutura. relacionamentos de entidade são suportados entre serviços instrumentados OpenTelemetry e infraestrutura de entidade criada a partir do OpenTelemetry Collector.
Os seguintes relacionamentos com seus serviços são suportados:
Anfitriões
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.
Contêiner
Os relacionamentos entre um serviço e uma entidade de contêiner exigem que o serviço inclua o atributo de recurso container.id e que ele corresponda ao container.id do contêiner no qual está sendo executado.
Atendimento a relacionamentos de infraestrutura utilizando o agente New Relic Infrastructure
O agente de infraestruturaNew Relic pode ser usado para monitorar sua infraestrutura. os relacionamentos de entidade são suportados entre os serviços instrumentados OpenTelemetry e a infraestrutura da entidade criada a partir do agente New Relic Infrastructure.
Para que esses relacionamentos funcionem, a telemetria emitida pelo seu serviço deve ser configurada para que possa ser correlacionada com a telemetria emitida pelo agente de infraestrutura. Isso requer que a telemetria do seu serviço inclua atributos de recursos que identifiquem o host, contêiner, etc. nos quais o serviço está sendo executado. Geralmente, isso é tão fácil quanto configurar detectores de recursos fornecidos pelo OpenTelemetry SDK para seu idioma ou usar o processador de detecção de recursos do OpenTelemetry Collector.
Os seguintes relacionamentos com seus serviços são suportados:
Hosts monitorados com o agente de infraestrutura New Relic
Os relacionamentos de host entre os serviços instrumentados OpenTelemetry e a entidade host gerada pelo agente da New Relic Infrastructure exigem duas coisas:
- O atributo de recurso
host.iddeve estar presente na telemetria do serviço. - O
host.iddeve estar correlacionado com a identidade do host derivada pelo agente de infraestrutura.
Derivando a identidade do host
Importante
A identidade do host derivada pelo agente da New Relic Infrastructure não corresponde exatamente à semântica do atributo de recurso host.id do OpenTelemetry em todas as circunstâncias. Isso pode causar dificuldades na correlação de serviços com hosts monitorados com o agente de infraestrutura. Leia esta seção com atenção para entender os possíveis desafios.
A identidade do host derivada pelo agente da New Relic Infrastructure depende do ambiente de hospedagem e da configuração do agente.
Para que os serviços sejam correlacionados corretamente aos hosts monitorados pelo agente da New Relic Infrastructure, o atributo de recurso host.id emitido pelo serviço deve corresponder à identidade do host computada pelo agente. As seções a seguir descrevem, em ordem de prioridade, como o agente de infraestrutura computa a identidade de um host para que você possa entender como definir corretamente o host.id do serviço.
agente de infraestrutura configurado com um display_name
Se o agente de infraestrutura estiver configurado para usar um display_name , ele o usará como a identidade do host. Seu serviço instrumentado OpenTelemetry deve ser configurado para emitir um host.id que seja igual ao display_name.
Host em execução em um ambiente cloud
Se o host estiver sendo executado em um ambiente cloud (por exemplo, AWS ou Azure), o agente usará o ID da instância atribuído pelo provedor cloud . Seu serviço de instrumentação OpenTelemetry deve ser configurado para usar um detector de recursos apropriado para seu ambiente cloud .
Host em execução em um ambiente não-nuvem
Em ambientes não conteinerizados o agente de infraestrutura computa um nome de domínio totalmente qualificado (FQDN) do host. A maneira como o agente determina o FQDN difere com base em vários fatores, como o sistema operacional. Não é possível confiar que os detectores de recursos computarão o mesmo valor que o FQDN resolvido pelo agente de infraestrutura. É recomendável que você configure explicitamente um display_name para o agente de infraestrutura e o host.id do seu serviço para que eles correspondam.
Serviço de contêiner monitorado com o agente New Relic Infrastructure
Os relacionamentos entre um serviço e uma entidade de contêiner exigem que o serviço seja configurado com um detector de recursos apropriado que inclua o atributo de recurso container.id .
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, New Relic oferece suporte a uma série de relacionamentos entre serviços instrumentados OpenTelemetry e infraestrutura monitorada usando Amazon CloudWatch Metric Streams. Os relacionamentos suportados estão listados abaixo.
Importante
Alguns relacionamentos são automaticamente suportados pela instrumentação. Esses relacionamentos utilizam convenções semânticas OpenTelemetry para correlacionar a telemetria dos serviços instrumentados com OpenTelemetry aos recursos AWS monitorados pelo CloudWatch Metric Streams. No entanto, esteja ciente de que muitas dessas convenções ainda não são estáveis e ainda estão evoluindo. instrumentação que produz telemetria para o framework abaixo variam em seu nível de maturidade e conformidade com as convenções semânticas. Dessa forma, a instrumentação que você usa pode não emitir o atributo necessário para que esses relacionamentos funcionem. Entre em contato com os mantenedores da instrumentação que você está usando caso tenha alguma dúvida sobre a maturidade da instrumentação em relação às convenções semânticas do OpenTelemetry.
Se um relacionamento não for suportado automaticamente pela instrumentação, ou se a instrumentação existente não seguir as convenções padrão, você deverá transmitir manualmente a telemetria para o New Relic para estabelecer o relacionamento. Faça isso transmitindo um log ou intervalo com o atributo newrelic.aws_metric_streams.arn que inclui o ARN do recurso. É recomendável transmitir logs por intervalos porque os intervalos podem ser amostrados. Tenha em mente que esses relacionamentos têm um tempo de vida (TTL) de 75 minutos, então você precisa emitir telemetria periodicamente para manter o relacionamento.
Apoiado por instrumentação | Produto AWS |
|---|---|
✅ | |
✅ | |
✅ | |
✅ | |
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.