Reglas para crear métrica: requisitos y consejos.

A continuación se muestran algunos límites, requisitos y recomendaciones al crear métricas a partir de eventos, registros o intervalos.

Agregación métrica

Su consulta NRQL debe utilizar una de las siguientes funciones summary, uniqueCount o distribution para métrica agregada:

Función	Comentarios
`summary`	Crea un punto de datos de métrica resumido para cada ventana de tiempo (actualmente 1 minuto). Utilícelo si su consulta NRQL utiliza funciones de agregador admitidas por el tipo de métrica de resumen, como promedio, suma, mínimo o máximo. Example rule-creation query: `SELECT summary(duration) AS 'service.responseTime' FROM Transaction WHERE appName = 'Data Points Staging' FACET name, appName, host`
`uniqueCount`	Crea un punto de datos de métrica `uniqueCount` para cada ventana de tiempo de 1 minuto. Utilícelo si su consulta NRQL utiliza el tipo de agregador `uniqueCount` . Ejemplo de consulta de creación de reglas: `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`	Crea un punto de datos de métrica de distribución para cada ventana de tiempo de 1 minuto. Utilícelo si su consulta NRQL utiliza funciones de agregador como percentil, histograma, mínimo, máximo, promedio, suma o recuento. Utilice solo el atributo de interés como argumento y descarte el resto de los argumentos de `percentile` o `histogram`. La métrica generada admite cualquier argumento en `percentile` o `histogram`. Example of creating a `distribution` rule: `SELECT distribution(duration) AS 'service.responseTime' FROM Transaction WHERE appName = 'Data Points Staging' FACET name, appName, host`
Recuento simple: `summary(1)` y `sum`	Si desea una métrica que sea un recuento simple del evento, registro o intervalos que coincidan con una cláusula `WHERE` particular, use la métrica `summary(1)` . Este tipo de métrica cuenta el número de eventos, registros o intervalos especificados por minuto. Al consultar la métrica creada, utilice el método `sum` para ver el resultado. Example: Si desea crear una métrica denominada `foo.count` que cuente la transacción denominada `foo`, el NRQL se vería así: `FROM Transaction SELECT summary(1) AS 'foo.count' WHERE name = 'foo'` Entonces lo consultarías así: `FROM Metric SELECT sum(foo.count) SINCE 30 minutes ago` Para más información sobre métrica, consulta nuestra documentación sobre tipos métricas.

Límites de creación de reglas

Estos límites afectan la creación de reglas métricas:

Límites	Comentarios
Límites de cuenta	Una cuenta puede tener un máximo de 1.000 reglas de creación métrica.
Límites de la regla métrica	Una regla puede: Crea un máximo de 10 métricas. Utilice solo un tipo de datos (evento, registro o intervalos). Seleccione un máximo de 20 atributos (facetas) para incluir en una métrica.
Límites de la ventana de tiempo	Límite de 50 000 en combinaciones únicas de nombre de métrica/valor de atributo para una sola métrica en un período de tiempo de 30 segundos. Se aplicarán los límites de cardinalidad normales en las acumulaciones . Si se excede el límite de 50k en una ventana de 30 segundos, la regla se desactiva y se crea un evento`NrIntegrationError` en esa cuenta que incluye: Los detalles de la regla Un mensaje sobre tener demasiadas facetas Un valor de atributo `newRelicFeature` de `eventToMetric`

Límites

Comentarios

Límites de cuenta

Una cuenta puede tener un máximo de 1.000 reglas de creación métrica.

Límites de la regla métrica

Una regla puede:

Crea un máximo de 10 métricas.
Utilice solo un tipo de datos (evento, registro o intervalos).
Seleccione un máximo de 20 atributos (facetas) para incluir en una métrica.

Límites de la ventana de tiempo

Límite de 50 000 en combinaciones únicas de nombre de métrica/valor de atributo para una sola métrica en un período de tiempo de 30 segundos. Se aplicarán los límites de cardinalidad normales en las acumulaciones .

Si se excede el límite de 50k en una ventana de 30 segundos, la regla se desactiva y se crea un eventoNrIntegrationError en esa cuenta que incluye:

Los detalles de la regla
Un mensaje sobre tener demasiadas facetas
Un valor de atributo newRelicFeature de eventToMetric

Límites de cardinalidad

Los límites de creación de reglas incluyen límites en el número de combinaciones únicas de nombres métricos y valores de atributos. Este límite existe porque una gran cantidad de atributos y/o valores de atributos pueden generar un aumento exponencial en el tamaño de los datos reportados.

Example metric creation rule that attaches five attributes:

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

Si cada uno de los cinco atributos reportara diez valores únicos dentro de un período de tiempo de un minuto, el número de combinaciones únicas de nombre de métrica/atributo tendría teóricamente un máximo de 10x10x10x10x10, o 100.000. Múltiples atributos con múltiples valores únicos pueden generar una gran cantidad de entradas métricas únicas.

En la práctica, este no suele ser el caso, porque los atributos suelen estar relacionados. Por ejemplo, si un atributo es hostname y otro es awsRegion, cuando vea el nombre de host A, siempre estará en la región B de AWS; nunca verá el nombre de host A ni otros valores de región de AWS.

Por eso es importante, durante el proceso de creación de NRQL, utilizar la función uniqueCount para verificar cuántas combinaciones únicas de nombre de métrica/valor de atributo está generando su consulta NRQL.

Métrica múltiple a partir de una regla

Una regla puede crear hasta diez métricas. No existen diferencias funcionales entre las métricas creadas de una en una y las creadas con una sola regla. Razones para crear múltiples métricas con una sola regla:

Es menos probable que alcance el límite de reglas por cuenta.
Es más fácil agregar el mismo atributo a múltiples métricas.

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

Denominación métrica

Una métrica recibe un nombre con la cláusula AS , como parte del proceso de creación de reglas NRQL. En el siguiente ejemplo de NRQL, el nombre de la métrica es io.totalread.bytes:

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

Si no hay ningún nombre asignado con la cláusula AS , el nombre de la métrica es el nombre del atributo de consulta. En este ejemplo, si no se asignó ningún nombre, el nombre de la métrica sería ioTotalReadBytes.

Nombres métricos	Requisitos y recomendaciones
Requisitos	Requisitos para nombrar una métrica: Menor o igual a 255 (UTF-16) unidades de código de 16 bits. Una forma de asegurarse de estar por debajo del límite es mantener cada cadena por debajo de 127 de lo que sea más fácil de contar. No hay espacios. Comience con una letra. Ejemplos de nombres métricos fuertes: `rubyvm.memory.heap_used` `redis.container.cpu.percent` `memcached.process_virtual_memory.bytes`
Longitud y estructura	Decida un nombre y una estructura que facilite que otros encuentren, comprendan y utilicen esta métrica. Recomendamos mantener el nombre de su métrica por debajo de 40 caracteres para una legibilidad ideal. Los nombres más largos pueden cortarse o superponerse con otros nombres. Su esquema de nomenclatura métrica dependerá de su lógica empresarial. Es posible que desee utilizar un espacio de nombres para anteponer el nombre de su métrica, o es posible que sus nombres deban ser más generales.
Componentes dentro del nombre	Si desea crear componentes dentro de su nombre métrico (como la fuente de las métricas y lo que está midiendo), le recomendamos ir de lo amplio a lo específico (de izquierda a derecha): Utilice un punto para separar esos componentes para que sean coherentes con nuestros nombres métricos New Relic. Luego, utiliza un guión bajo para separar las palabras dentro de los puntos. Example: `application.page_view.duration`
Atributo	Evite poner atributo en el nombre de su métrica. Los atributos son cualidades de su métrica que puede usar para filtrar o facetar sus datos, como clúster o zona de disponibilidad. Example: Si incluyera la zona de disponibilidad en el nombre de su métrica, significaría que, para esa métrica, no podría ver los resultados en todas las zonas de disponibilidad.
Cambiando nombres métricos	Si cambia el nombre de una métrica, los datos históricos no se actualizarán con ese nuevo nombre. Para consultar o trazar esos datos históricos, deberá especificar el nombre de la métrica anterior.