• /
  • EnglishEspañolFrançais日本語한국어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

Utilize métricas dimensionais para consultar mais dados

|View as Markdown (English)

visualização

Ainda estamos trabalhando nesse recurso, mas adoraríamos que você experimentasse!

Atualmente, esse recurso é fornecido como parte de um programa de visualização de acordo com nossas políticas de pré-lançamento.

As métricas dimensionais são um padrão da indústria para armazenar e consultar dados métricos. O New Relic armazena todas as métricas de infraestrutura como dados de eventos, mas você também pode consultá-las como métricas dimensionais.

Na New Relic, reportamos métricas de diversas maneiras, incluindo métricas dimensionais, que nossa API métrica, SDK de telemetria, alguma integração de código aberto e nossos serviços de infraestrutura podem usar.

Este tipo de métrica permite que você:

  • Aproveite uma experiência de consulta aprimorada para dados de infraestrutura.
  • Descubra todas as suas métricas em um só lugar.
  • Use fontes mais métricas, como Prometheus.

Por exemplo, você pode usar a seguinte consulta para obter a duração máxima da sua função do Lambda:

Query with samples

FROM ServerlessSample
SELECT max(provider.duration.Maximum)
WHERE provider = 'LambdaFunction'

Query with metrics

FROM Metric
SELECT max(aws.lambda.function.duration)

Iniciar

Você não precisa de nenhuma atualização de agente ou integração para usar essas métricas. Oferecemos suporte a alertas de NRQL com base em métricas dimensionais, exceto para dados provenientes de integração na nuvem (como métricas de AWS polling integração, GCP e Azure). A New Relic ingere a métrica do AWS CloudWatch Metric Streams como métrica dimensional e recomendamos que você use NRQL nesses casos.

Onde e como consultar métrica dimensional

New Relic oferece suporte a todos os recursos de consulta NRQL atuais. Você pode usar WHERE, FACET e funções de seleção de tempo, como SINCE, UNTIL e COMPARE WITH para consulta.

Convenções de nomenclatura para métrica e atributo

Todos os nomes de métricas e atributos para métricas dimensionais seguem a mesma convenção de nomenclatura para torná-los fáceis de encontrar e usar. os nomes de métrica e atributo são separados por pontos: por exemplo, o prefixo host. é usado para métrica de host, o prefixo k8s. é usado para métrica de Kubernetes e aws. é usado para métrica de AWS.

O gráfico abaixo mostra como um ProcessSample que contém três métricas (cpuPercent, ioTotalReadBytes e ioTotalWriteBytes) é dividido em três métricas separadas. Observe a nomenclatura atualizada da métrica e do atributo.

naming-convention.png

Convenção de nomenclatura métrica dimensional

Diferenças na consulta de métricas dimensionais e eventos

Métricas dimensionais são um tipo de dados fundamentalmente diferente em comparação com dados de eventos. Abaixo, você encontrará algumas diferenças notáveis ao consultar métricas dimensionais:

  • Consulta métrica com * não retorna dados amostrais de infraestrutura. Por exemplo:

    SELECT * FROM Metric
  • Consulta métrica com metricName LIKE não retorna dados amostrais de infraestrutura. Por exemplo:

    SELECT uniques(metricName) FROM Metric where metricName like 'k8%'
  • Para selecionar um atributo começando com tags. , um nome de métrica deve ser fornecido. Por exemplo, isso não funciona sem a cláusula WHERE :

    SELECT uniques(tags.environment) FROM Metric WHERE metricName='aws.lambda.function.duration'
  • Os resultados poderão não estar completos se os critérios de seleção corresponderem a demasiadas amostras. Por exemplo, esta consulta mapeia todas as amostras de infraestrutura e pode retornar resultados incompletos:

    SELECT uniqueCount(entity.guid) FROM Metric
  • Não oferecemos suporte ao recurso curinga de métrica recém-introduzido, por exemplo:

    SELECT average(host.swap%Bytes) FROM Metric
  • Funções usadas em múltiplas métricas podem falhar ou retornar resultados incorretos, por exemplo:

    FROM Metric SELECT latest(metricNameA + metricNameB)
  • Quando você inclui RAW em uma consulta, a solicitação é transformada internamente e imprime dados de evento agregados equivalentes. Não imprimirá dados brutos. Consulte a consulta de exemplo para ver este comportamento:

    SELECT max(host.cpuPercent) FROM Metric TIMESERIES 1 MINUTE SINCE 60 MINUTES AGO RAW
  • Não oferecemos suporte ao uso de keyset com TIMESERIES e isso retornará um erro. Veja o exemplo abaixo:

    FROM Metric SELECT keyset() WHERE instrumentation.provider = 'infrastructure' TIMESERIES

Para obter uma visão geral das diferenças de tipos de dados, consulte Tipos de dados New Relic.

Exemplos de consulta dimensional

Aqui estão alguns exemplos de consulta NQRL com e sem métrica dimensional:

Copyright © 2026 New Relic Inc.

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