• 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

Regras para criação de métricas: requisitos e dicas

Aqui estão alguns limites, requisitos e recomendações ao criar métricas a partir de evento, log ou spans.

Agregação métrica

Sua consulta NRQL deve usar uma das seguintes funções summary, uniqueCount ou distribution para métrica agregada:

Função

Comentários

summary

Cria um ponto de dados métricos resumidos para cada janela de tempo (atualmente 1 minuto). Use isto se sua consulta NRQL usar funções agregadoras suportadas pelo tipo de métrica de resumo, como média, soma, mínimo ou máximo.

Example rule-creation query:

SELECT summary(duration) AS 'service.responseTime' FROM Transaction
WHERE appName = 'Data Points Staging' FACET name, appName, host

uniqueCount

Cria um ponto de dados de métrica uniqueCount para cada intervalo de tempo de 1 minuto. Use isto se sua consulta NRQL usar o tipo de agregador uniqueCount .

Exemplo de consulta de criação de regra:

FROM Transaction SELECT uniqueCount(request.headers.userAgent)
AS 'server.request.header.userAgent.uniqueCount'
WHERE appName = 'Browser Monitoring Router' FACET http.statusCode, name, appName, host

distribution

Cria um ponto de dados de métrica de distribuição para cada janela de tempo de 1 minuto. Use isto se sua consulta NRQL usar funções agregadoras , como percentil, histograma, mínimo, máximo, média, soma ou contagem. Use apenas o atributo de interesse como argumento e descarte o restante dos argumentos de percentile ou histogram. A métrica gerada oferece suporte a qualquer argumento em percentile ou histogram.

Example of creating a distribution rule:

SELECT distribution(duration) AS 'service.responseTime' FROM Transaction
WHERE appName = 'Data Points Staging' FACET name, appName, host

Contagem simples: summary(1) e sum

Se você quiser uma métrica que seja uma contagem simples de eventos, registros ou períodos que correspondam a uma cláusula WHERE específica, use a métrica summary(1) . Este tipo de métrica conta o número de eventos, logs ou intervalos especificados por minuto. Ao consultar a métrica criada, utilize o método sum para ver o resultado.

Example: Se você quiser criar uma métrica chamada foo.count que conte a transação chamada foo, o NRQL ficaria assim:

FROM Transaction SELECT summary(1) AS 'foo.count' WHERE name = 'foo'

Então você consultaria assim:

FROM Metric SELECT sum(foo.count) SINCE 30 minutes ago

Para mais informações sobre métrica, consulte nossa documentação sobre tipos de métrica.

Limites de criação de regras

Esses limites afetam a criação de regras métricas:

Limites

Comentários

Limites da conta

Uma conta pode ter no máximo 1.000 regras de criação de métricas.

Limites da regra métrica

Uma regra pode:

  • Crie no máximo 10 métricas.
  • Use apenas um tipo de dados (evento, log ou spans).
  • Selecione no máximo 20 atributos (facetas) para incluir em uma métrica.

Limites de janela de tempo

Limite de 50 mil em combinações exclusivas de nome de métrica/valor de atributo para uma única métrica em um intervalo de tempo de 30 segundos. Serão aplicados limites normais de cardinalidade em rollups .

Se o limite de 50 mil em uma janela de 30 segundos for excedido, a regra será desativada e um eventoNrIntegrationError será criado nessa conta que inclui:

  • Os detalhes da regra
  • Uma mensagem sobre ter muitas facetas
  • Um valor de atributo newRelicFeature de eventToMetric

Limites de cardinalidade

Os limites de criação de regras incluem limites ao número de combinações únicas de nomes de métricas e valores de atributos. Este limite existe porque um grande número de atributo e/ou valores de atributo pode levar a um aumento exponencial no tamanho dos dados reportados.

Example metric creation rule that attaches five attributes:

FROM ProcessSample SELECT summary(ioTotalReadBytes)
WHERE entityType = 'ComputeSample'
FACET awsRegion, awsAvailabilityZone, commandName, entityName, processId

Se cada um dos cinco atributos reportasse dez valores exclusivos dentro de uma janela de tempo de um minuto, o número de combinações únicas de nome-métrica/atributo teria teoricamente um máximo de 10x10x10x10x10, ou 100.000. Múltiplos atributos com múltiplos valores exclusivos podem levar a um grande número de entradas métricas únicas.

Na prática, normalmente não é esse o caso, porque os atributo costumam estar relacionados. Por exemplo, se um atributo for hostname e outro for awsRegion, quando você vir o nome do host A, ele sempre estará na região B da AWS; você nunca veria o nome do host A e outros valores de região da AWS.

É por isso que é importante, durante o processo de criação de NRQL, usar a função uniqueCount para verificar quantas combinações exclusivas de nome de métrica/valor de atributo sua consulta NRQL está gerando.

Múltiplas métricas de uma regra

Uma regra pode criar até dez métricas. Não existem diferenças funcionais entre métricas criadas uma de cada vez e aquelas criadas com uma única regra. Razões para criar múltiplas métricas com uma única regra:

Example creating multiple metrics with a single rule:

FROM Transaction SELECT uniqueCount(request.headers.userAgent) AS 'server.request.header.userAgent.uniqueCount',
summary(duration) AS 'server.duration', summary(totalTime) AS 'server.totalTime'
WHERE appName = 'Browser Monitoring Router' FACET http.statusCode, name, appName, host

Nomenclatura métrica

Uma métrica recebe um nome com a cláusula AS , como parte do processo de criação de regras NRQL. No exemplo de NRQL a seguir, o nome da métrica é io.totalread.bytes:

FROM ProcessSample SELECT summary(ioTotalReadBytes) AS 'io.totalread.bytes' WHERE entityType = 'ComputeSample' FACET awsRegion, awsAvailabilityZone, commandName

Se não houver nenhum nome atribuído com a cláusula AS , o nome da métrica será o nome do atributo de consulta. Neste exemplo, se nenhum nome fosse atribuído, o nome da métrica seria ioTotalReadBytes.

Nomes métricos

Requisitos e recomendações

Requisitos

Requisitos para nomear uma métrica:

  • Menor ou igual a 255 (UTF-16) unidades de código de 16 bits. Uma maneira de garantir que você está abaixo do limite é manter cada string abaixo de 127 do que for mais fácil de contar.

  • Sem espaços.

  • Comece com uma carta.

    Exemplos de nomes métricos fortes:

  • rubyvm.memory.heap_used

  • redis.container.cpu.percent

  • memcached.process_virtual_memory.bytes

Comprimento e estrutura

Decida um nome e uma estrutura que torne mais fácil para outras pessoas encontrarem, compreenderem e usarem essa métrica.

  • Recomendamos manter o nome da sua métrica com menos de 40 caracteres para uma legibilidade ideal. Nomes mais longos podem ser cortados ou sobrepostos a outros nomes.
  • Seu esquema de nomenclatura de métrica dependerá de sua lógica de negócios. Talvez você queira usar o namespace para prefixar o nome da sua métrica ou talvez seus nomes precisem ser mais gerais.

Componentes dentro do nome

Se você deseja criar componentes dentro do nome da sua métrica (como a fonte das métricas e o que você está medindo), recomendamos ir do amplo ao específico (da esquerda para a direita):

  1. Use um ponto para separar esses componentes para ser consistente com os nomes das métricas da New Relic.

  2. Em seguida, use um sublinhado para separar as palavras dentro dos pontos.

    Example:

    application.page_view.duration

Atributo

Evite colocar atributo no nome da sua métrica. atributo são qualidades da sua métrica que você pode usar para filtrar ou facetar seus dados, como cluster ou zona de disponibilidade.

Example: Se você incluísse a zona de disponibilidade no nome da sua métrica, isso significaria que, para essa métrica, você não conseguiria ver resultados em todas as zonas de disponibilidade.

Alterando nomes de métricas

Se você alterar o nome de uma métrica, os dados históricos não serão atualizados para esse novo nome. Para consultar ou mapear esses dados históricos, você precisará especificar o nome da métrica mais antiga.

Copyright © 2024 New Relic Inc.

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