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:
- Para requisitos de configuração endpoint , consulte New Relic OTLP endpoint.
- Para obter instruções sobre como configurar serviços com OpenTelemetry, consulte MonitoramentoOpenTelemetry APM .
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 |
|---|---|---|---|
Bytes processados |
| ||
Observe o tempo total de CPU do processo |
| ||
Itens em uma fila |
| ||
Observe o uso atual da memória |
| ||
Duração das solicitações http | |||
Alterar evento para velocidade do ventilador da CPU | |||
Observe a temperatura ambiente atual |
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 |
|---|---|
| Cada valor principal é um atributo no |
|
|
|
|
| Cada valor principal é um atributo no |
|
|
|
|
|
|
|
|
|
|
| Cada valor principal é um atributo no |
| Mapas para New Relic |
| Mapas para New Relic Veja métrica OTLP sum |
| Mapas para New Relic |
| Mapas para New Relic |
| Mapas para New Relic |
[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:
|
| Comportamento |
|---|---|---|
|
| Mapas para New Relic |
|
| Mapas para New Relic |
|
| Mapas para New Relic |
|
| 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.