ano const de exportação = 2023; exportar const gaDate = '4 de abril'; exportar const gaDateAndYear = gaDate + ', ' + ano;
As métricas do OpenTelemetry são amplamente compatíveis com as métricas dimensionais do New Relic. Oferecemos suporte à métrica OpenTelemetry v0.10. Todos os tipos de métricas suportados incluem um conjunto independente de atributos associados (pares nome-valor) que são mapeados diretamente para dimensões que você pode usar para facetar ou filtrar dados métricos no momento da consulta. As métricas OpenTelemetry são acompanhadas por um conjunto de atributos de recursos que identificam a entidade originadora que as produziu e mapeiam dimensões para facetação e filtragem.
O modelo de dados OpenTelemetry para métricas define vários tipos diferentes de métricas: soma, medidor, histograma e resumo.
Soma métrica
As somas do OpenTelemetry são uma métrica escalar que é a soma de todos os pontos de dados em um determinado intervalo de tempo. As somas têm uma noção de temporalidade que indica se os valores reportados incorporam medidas anteriores (temporalidade cumulativa) ou não (temporalidade delta).
Além disso, as somas podem ser monotônicas (só sobem ou só descem) ou não monotônicas (sobem e descem).
Somas delta
As somas delta são tratadas de forma diferente dependendo se são monotônicas ou não monotônicas:
- As somas delta monotônicas são mapeadas para o tipo de métrica de contagem .
- Somas delta não monotônicas não são suportadas. As coisas medidas desta forma não geram dados significativos, pois são provavelmente somados para serem usados. Para mais discussões, consulte esta pull requestda comunidade e nossos documentos sobre medidor versus contadores.
Somas cumulativas
As somas cumulativas são tratadas de forma diferente dependendo se são monotônicas ou não monotônicas.
- Somas cumulativas não monotônicas são mapeadas para o tipo de métrica de medidor .
- As somas cumulativas monotônicas são mapeadas para nosso tipo de métrica cumulativeCount .
Exemplos de configuração de soma
Para entender como configurar a temporalidade de agregação, consulte estes exemplos usando os SDKs Java e Python OpenTelemetry.
Métrica
Os pontos de dados métricos do medidor OpenTelemetry representam um valor amostrado em um determinado momento. Esses valores são convertidos para o tipo de métrica de medidor New Relic. O medidor OpenTelemetry não possui temporalidade de agregação, mas os valores amostrados podem ser agregados no momento da consulta.
Histograma métrico
O histograma OpenTelemetry representa de forma compacta uma população de valores registrados junto com uma contagem total e soma. Opcionalmente, o histograma pode incluir uma série de intervalos com limites explícitos e um valor de contagem para a população desse intervalo.
Todos os histogramas do OpenTelemetry são convertidos para o tipo de métrica de distribuição do New Relic, que é apoiado por um histograma exponencial escalonado de base 2 (consulte NrSketch para uma explicação mais completa).
Histograma Delta
Para o histograma exponencial, podemos fazer uma tradução direta para o NrSketch.
Para histogramas de limites explícitos, as contagens dos intervalos de histograma do OpenTelemetry são atribuídas aos intervalos métricos de distribuição do New Relic usando interpolação linear. Além disso, OpenTelemetry tem buckets com limite infinito negativo e positivo que representamos no New Relic como buckets de largura zero. Fazemos isso porque não temos uma representação para o infinito negativo e positivo. Por exemplo, um bucket OpenTelemetry com limites \[-∞, 10) será representado por um bucket New Relic de largura zero \[10,10) . Você pode ver contagens de buckets exageradas no ponto final da sua distribuição devido a esta tradução.
Histograma cumulativo
Os histogramas cumulativos são convertidos em um histograma Delta. Para mais informações sobre o processo de tradução, veja Métrica cumulativa.
Métrica resumida
Os pontos de dados métricos de resumo do OpenTelemetry são usados para representar resumos de quantis (por exemplo, latência P99). Eles são mapeados diretamente para o tipo de métrica de resumo do New Relic, no entanto, os únicos quantis que mantemos são os quantis 0,0 e 1,0 para mínimo e máximo. Se percentil for algo que você deseja capturar, prefira Histograma métrico.
Os pontos de dados métricos resumidos incluem valores de contagem, soma e quantil, com 0,0 como mínimo e 1,0 como máximo. OpenTelemetry fornece métricas resumidas para compatibilidade com outros formatos.
Hora de início
O campo startTimeUnixNano é opcional de acordo com a especificação OpenTelemetry. Para temporalidade de agregação delta, quando presente, ela é usada para o timestamp na métrica New Relic resultante e duration é calculado como timeUnixNano - startTimeUnixNano. O campo duration é usado para calcular o atributo endTimeStamp consultável na métrica New Relic, mas não serve a nenhum outro propósito semântico.
Se startTimeUnixNano não for fornecido, timeUnixNano será usado para o campo timestamp na métrica New Relic resultante e o campo de duração será definido como zero.
Para temporalidade de agregação cumulativa, startTimeUnixNano representa a primeira observação da série temporal e é usado para detectar reinicializações. timeUnixNano é interpretado como o timestamp de data/hora do ponto de dados cumulativo. Os pontos de dados cumulativos são então convertidos em temporalidade de agregação delta.
Valores da matriz para atributo
A métrica OpenTelemetry e outros sinais podem incluir atributos que consistem em um array homogêneo de tipos primitivos. New Relic suporta matriz homogênea não aninhada com menos de 65 elementos.
Exemplos
OpenTelemetry define valores exemplares que permitem que outros sinais, como trace, sejam conectados a um evento métrico e forneçam contexto. Os exemplares não são suportados pela New Relic.
Como consultar métrica
Considere estas dicas para construir uma consulta métrica NRQL no New Relic.
Consultar somas acumuladas armazenadas como cumulativasCounts
Aqui estão algumas maneiras de consultar seus dados:
Consultar somas acumuladas armazenadas como medidor
Os clientes da New Relic que relataram somas cumulativas antes de gaDateAndYear têm suas somas cumulativas convertidas para nosso tipo gauge .
Se suas somas cumulativas estiverem armazenadas como o tipo gauge , aqui estão algumas maneiras de consultar seus dados:
Métrica do medidor de consulta
Quando o New Relic converte somas cumulativas em medidor, você pode consultá-las usando as funções NRQL latest() ou derivative() . A função escolhida depende se você deseja ver o valor bruto ou calcular a taxa de variação.
Consultar histograma métrico
O histograma New Relic traduzido da métrica OpenTelemetry tem a mesma semântica de consulta de outros histogramas New Relic. Ou seja, a função histogram() NRQL pode ser usada para representar o histograma com um número configurável de intervalos e largura do intervalo. Traduzimos o histograma cumulativo em histograma delta, então eles são consultados da mesma forma que um histograma delta seria consultado. Observe para o histograma de limites explícitos que você pode ver contagens de intervalos maiores nos intervalos de endpoint. Isso ocorre porque estamos adicionando buckets OpenTelemetry com limite infinito negativo e positivo em um bucket New Relic de largura zero.
Importante
A palavra-chave TIMESERIES não é compatível com o histograma New Relic, a menos que seja percentiles().