• /
  • EnglishEspañol日本語한국어Português
  • EntrarComeçar agora

Esta tradução de máquina é fornecida para sua comodidade.

Caso haja alguma divergência entre a versão em inglês e a traduzida, a versão em inglês prevalece. Acesse esta página para mais informações.

Criar um problema

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 métrica que ele recebe por meio do New Relic OTLP endpoint. Veja as seguintes páginas:

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.

Tipo de instrumento

Exemplo de uso

Agregação padrão

Tipo de métrica exportada

Counter

Bytes processados

Soma

Sum métrica, com is_monotonic=true

Contador assíncrono

Observe o tempo total de CPU do processo

Soma

Sum métrica, com is_monotonic=true

UpDownCounter

Itens em uma fila

Soma

Sum métrica, com is_monotonic=false

UpDownCounter assíncrono

Observe o uso atual da memória

Soma

Sum métrica, com is_monotonic=false

Histogram

Duração das solicitações http

Histograma de intervalo explícito

Histogram métrica [1]

Gauge

Alterar evento para velocidade do ventilador da CPU

Último valor

Gauge métrica

Medidor assíncrono

Observe a temperatura ambiente atual

Último valor

Gauge métrica

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 métrica OTLP para o tipo de dadosMetric . A tabela abaixo descreve como os campos das mensagens protométricas são interpretados. Veja tipo de instrumento para tipo métrico para obter detalhes sobre como os vários tipos métricos são produzidos pela OpenTelemetry API e SDKs .

Campo proto métrico OTLP

Campo New Relic Metric

ResourceMetrics.Resource.attributes

Cada valor principal é um atributo no Metric[1]

ScopeMetrics.InstrumentationScope.name

otel.library.name

ScopeMetrics.InstrumentationScope.version

otel.library.version

ScopeMetrics.InstrumentationScope.attributes

Cada valor principal é um atributo no Metric[1]

Metric.name

metricName

Metric.description

description

Metric.unit

unit

Metric.*.data_points.start_time_unix_nano

timestamp

Metric.*.data_points.time_unix_nano

endTimestamp

Metric.*.data_points.attributes

Cada valor principal é um atributo no Metric[1]

Metric.gauge.data_points

Mapas para New Relic gauge

Metric.sum.data_points

Mapas para New Relic count, cumulativeCount ou gauge

Veja métrica OTLP sum

Metric.histogram.data_points

Mapas para New Relic distribution

Veja histograma métrico OTLP

Metric.exponential_histogram.data_points

Mapas para New Relic distribution

Veja histograma métrico OTLP

Metric.summary.data_points

Mapas para New Relic summary

Veja métrica de resumo OTLP

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

Consulte os tipos de atributos New Relic OTLP endpoint para obter detalhes sobre os tipos de atributos suportados OTLP .

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:

is_monotonic

aggregation_temporality

Comportamento

true

cumulative

Mapas para New Relic cumulativeCount

true

delta

Mapas para New Relic count

false

cumulative

Mapas para New Relic gauge

false

delta

Não suportado porque os dados não são significativos. Veja esta discussão para obter detalhes.

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

Os resumos métricos do OTLP são semelhantes aos histogramas, pois resumem uma população de medições, incluindo soma e contagem. Entretanto, enquanto os histogramas incluem intervalos para descrever a distribuição das medições, 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 o New Relic summary. Observe que o tipo de resumo do New Relic não suporta quantis.

Importante

Embora os resumos sejam ingeridos e traduzidos para um New Relic summary, eles não são suportados adequadamente. New Relic assume que os resumos representam um delta desde a última medição quando, na verdade, são métricas cumulativas (consulte temporalidade de agregação). Resumos são mais comumente emitidos pelo Prometheus, que é um sistema métrico cumulativo. Portanto, o New Relic atualmente não oferece suporte ao caso de uso mais comum. Dessa forma, você experimentará um comportamento inesperado na sua métrica de resumo, incluindo falha na ingestão.

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.

Copyright © 2024 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.