Métricas de OpenTelemetry em New Relic

OpenTelemetry fornece um modelo dimensional de dados métricos, uma API para registro de telemetria métrica e um SDK para agregação e exportação de dados métricos.

Esta página descreve como New Relic lida com OpenTelemetry as métricas que recebe por meio do New Relic OTLP do endpoint. A integração da métrica OpenTelemetry com New Relic requer a configuração da origem da métrica para exportar para este endpoint . Revise os requisitos de configuração endpoint . Para informações sobre configuração de serviços com métrica OpenTelemetry veja OpenTelemetry APM monitoramento.

Tipo de instrumento para mapeamento tipo métrica

A OpenTelemetry métrica API define vários tipos de instrumentos. medições de registros do instrumento, que são agregadas e exportadas via OTLP como um tipo métrico específico. A tabela abaixo descreve o comportamento padrão de como cada instrumento OpenTelemetry agrega e exporta. Consulte mapeamento métrico OTLP para obter detalhes sobre como cada tipo de métrica é tratado no New Relic.

Consulte as diretrizes complementares de métricaOpenTelemetry para obter detalhes sobre como escolher o tipo de instrumento correto.

[1] O histograma instrumento também pode ser agregado ao histograma métrico exponencial. Veja histograma métrico OTLP para mais detalhes.

Mapeamento do métrico OTLP

New Relic mapeia a métrica OTLP para o tipo de dadosMetric . A tabela abaixo descreve como são interpretados os campos das protomensagens métricas. Consulte o tipo de instrumento para o tipo métrico para obter detalhes sobre como os vários tipos de métrica são produzidos pelas OpenTelemetry API /SDKs.

[1]: Em caso de conflito nos campos de atributo de recurso, atributo de escopo, atributo de ponto métrico e métrica de nível superior, a ordem do precedente (do maior para o menor) é: campos Metric.* de nível superior > Metric.*.data_points.attributes > ScopeMetrics.InstrumentationScope.attributes > ResourceMetrics.Resource.attributes.

Métrica OTLP sum

A soma métrica do OTLP representa a soma das medições ao longo do tempo. As somas incluem um campo aggregation_temporality e um campo is_monotonic , que indicam se os valores estão aumentando monotonicamente (ou seja, só podem aumentar) ou não (ou seja, podem aumentar e diminuir). A tabela a seguir descreve como a New Relic trata diferentes variedades de soma:

Histograma métrico OTLP

O histograma métrico OTLP e o histograma métrico exponencial resumem uma população de medidas com informações como soma, contagem, mínimo, máximo e intervalos que descrevem a distribuição dos valores de medição. A variedade de histograma (também chamada de histograma de intervalo explícito) possui intervalos com limites explícitos. A variedade exponencial possui intervalos com limites descritos por uma fórmula exponencial. Ambas as variedades incluem um campo de temporalidade de agregação.

Ambas as variedades de histograma são traduzidas para New Relic distribution, que é apoiado por uma representação interna de histograma exponencial de base 2. Esta representação reflete de perto o formato de histograma exponencial OpenTelemetry. Por esse motivo, New Relic prefere o histograma exponencial (consulte a agregação de mistogramas métricos para obter detalhes sobre como configurar o OTLP para preferir o histograma exponencial). A variedade de histograma de intervalo explícito do OpenTelemetry é traduzida para a representação exponencial usando interpolação linear. Consulte NrSketch para uma explicação detalhada.

Os intervalos com limites no infinito negativo e positivo são representados no New Relic como intervalos de largura zero. Por exemplo, um bucket OpenTelemetry com limites [-∞, 10) é representado no New Relic como [10, 10). Como resultado, você poderá ver contagens exageradas de buckets no final da sua distribuição.

Métrica de resumo OTLP

As métricas de resumo OTLP são semelhantes ao histograma porque resumem uma população de medidas, incluindo soma e contagem. No entanto, onde o histograma inclui intervalos para descrever a distribuição das medidas, os resumos incluem quantis. Esses quantis são de uso limitado, pois não podem sofrer reagregação espacial ou temporal. Resumos incluídos no OpenTelemetry para suporte legado, e OpenTelemetry API e o SDK não produzem resumos.

Os resumos são traduzidos para New Relic summary.

Temporalidade de agregação

A OpenTelemetry noção de temporalidade de agregação do define se um determinado ponto de dados métricos agrega um conjunto cumulativo de medidas (normalmente desde o início do aplicativo) ou o conjunto delta de medidas desde a última exportação. OTLP soma métrica e histograma métrica possuem um campo aggregation_temporality que descreve a semântica de seus pontos.

Embora aceitemos métricas de temporalidade cumulativa e delta, New Relic geralmente é um sistema de métrica delta e incentivamos o usuário a configurar seu exportador OTLP para preferir a temporalidade delta.

Quando a temporalidade é cumulativa, as métricas são convertidas em uma representação delta (com o valor cumulativo retido para cumulativeCount, usar uma tradução com estado é um processo com estado no qual calcula o delta a partir de dois pontos cumulativos cumulativos consecutivos da mesma série. O Metric.*.data_points.start_time_unix_nano é usado para detectar reinicializações em série.

Suporte de exemplos

Exemplares métricos de OpenTelemetry não são atualmente suportados pelo New Relic.