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 evento`NrIntegrationError` será criado nessa conta que inclui: Os detalhes da regra Uma mensagem sobre ter muitas facetas Um valor de atributo `newRelicFeature` de `eventToMetric`

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:

Menos probabilidade de atingir o limite de regras por conta.
É mais fácil adicionar o mesmo atributo a métricas múltiplas.

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): Use um ponto para separar esses componentes para ser consistente com os nomes das métricas da New Relic. 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.