Règles de création de métriques : exigences et conseils

Voici quelques limites, exigences et recommandations lorsque vous créez des métriques à partir d'événements, de logs ou d'étendues.

Agrégation métrique

Votre requête NRQL doit utiliser l'une des fonctions summary, uniqueCount ou distribution suivantes pour métrique agrégée :

Fonction	Commentaires
`summary`	Crée un point de données récapitulatif métrique pour chaque fenêtre temporelle (actuellement 1 minute). Utilisez ceci si votre requête NRQL utilise des fonctions d'agrégateur prises en charge par le type métrique récapitulatif, telles que `average`, `sum`, `min` ou `max`. Example rule-creation query: `SELECT summary(duration) AS 'service.responseTime' FROM Transaction WHERE appName = 'Data Points Staging' FACET name, appName, host`
`uniqueCount`	Crée un point de données métrique `uniqueCount` pour chaque fenêtre temporelle d'une minute. Utilisez ceci si votre requête NRQL utilise le type d'agrégateur `uniqueCount` . Exemple de requête de création de règle : `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`	Crée un point de données de métrique de distribution pour chaque fenêtre temporelle d'une minute. Utilisez ceci si votre requête NRQL utilise des fonctions d'agrégation telles que `percentile`, `histogram`, `min`, `max`, `average`, `sum` ou `count`. Utilisez uniquement l’attribut qui vous intéresse comme argument et ignorez le reste des arguments de `percentile` ou `histogram`. La métrique générée prend en charge tout argument sur `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`
Comptage simple : `summary(1)` et `sum`	Si vous souhaitez une métrique qui est un simple décompte de l'événement, du log ou des étendues qui correspondent à une clause `WHERE` particulière, utilisez la métrique `summary(1)` . Ce type métrique compte le nombre d'événements, de logs ou de périodes spécifiés par minute. Lors de l'interrogation de la métrique créée, utilisez la méthode `sum` pour voir le résultat. Example: Si vous souhaitez créer une métrique nommée `foo.count` qui compte les transactions nommées `foo`, le NRQL ressemblerait à ceci : `FROM Transaction SELECT summary(1) AS 'foo.count' WHERE name = 'foo'` Ensuite, vous l'interrogeriez comme ceci : `FROM Metric SELECT sum(foo.count) SINCE 30 minutes ago` Pour plus d'informations sur les métriques, consultez notre documentation sur les types de métriques.

Limites de création de règles

Ces limites affectent la création de règles métriques :

Limites	Commentaires
Limites du compte	Un compte peut avoir un maximum de 1 000 règles de création de métriques.
Limites de la règle métrique	Une règle peut : Créez un maximum de 10 métriques. Utilisez un seul type de données (événement, log ou étendues). Sélectionnez un maximum de 20 attributs (facettes) à inclure sur une métrique.
Limites de la fenêtre de temps	Limite de 50 000 pour les combinaisons uniques de nom de métrique/valeur d'attribut pour une seule métrique dans une fenêtre temporelle de 30 secondes. Les limites de cardinalité normales sur les cumuls s'appliqueront. Si la limite de 50 000 dans une fenêtre de 30 secondes est dépassée, la règle est désactivée et un événement`NrIntegrationError` est créé dans ce compte qui inclut : Les détails de la règle Un message sur le fait d'avoir trop de facettes Une valeur d'attribut `newRelicFeature` de `eventToMetric`

Limites

Commentaires

Limites du compte

Un compte peut avoir un maximum de 1 000 règles de création de métriques.

Limites de la règle métrique

Une règle peut :

Créez un maximum de 10 métriques.
Utilisez un seul type de données (événement, log ou étendues).
Sélectionnez un maximum de 20 attributs (facettes) à inclure sur une métrique.

Limites de la fenêtre de temps

Limite de 50 000 pour les combinaisons uniques de nom de métrique/valeur d'attribut pour une seule métrique dans une fenêtre temporelle de 30 secondes. Les limites de cardinalité normales sur les cumuls s'appliqueront.

Si la limite de 50 000 dans une fenêtre de 30 secondes est dépassée, la règle est désactivée et un événementNrIntegrationError est créé dans ce compte qui inclut :

Les détails de la règle
Un message sur le fait d'avoir trop de facettes
Une valeur d'attribut newRelicFeature de eventToMetric

Limites de cardinalité

Les limites de création de règles incluent des limites sur le nombre de combinaisons uniques de valeurs de nom et d'attribut métriques. Cette limite existe parce qu’un grand nombre d’attributs et/ou de valeurs d’attribut peut entraîner une augmentation exponentielle de la taille des données signalées.

Example metric creation rule that attaches five attributes:

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

Si chacun des cinq attributs rapportait dix valeurs uniques dans une fenêtre temporelle d'une minute, le nombre de combinaisons métrique-nom/attribut uniques aurait théoriquement un maximum de 10x10x10x10x10, soit 100 000. Plusieurs attributs avec plusieurs valeurs uniques peuvent conduire à un grand nombre d'entrées métriques uniques.

En pratique, ce n’est généralement pas le cas, car les attributs sont souvent liés. Par exemple, si un attribut est hostname et un autre est awsRegion, lorsque vous voyez le nom d'hôte A, il sera toujours dans la région AWS B ; vous ne verrez jamais le nom d'hôte A et d'autres valeurs de région AWS.

C'est pourquoi il est important, lors du processus de création NRQL, d'utiliser la fonction uniqueCount pour vérifier le nombre de combinaisons uniques de nom de métrique/valeur d'attribut générées par votre requête NRQL.

Plusieurs métriques à partir d'une seule règle

Une règle peut créer jusqu'à dix métriques. Il n’y a aucune différence fonctionnelle entre les métriques créées une par une et celles créées avec une seule règle. Raisons de la création de plusieurs métriques avec une seule règle :

Moins susceptible d'atteindre la limite de règles par compte.
Plus facile d'ajouter le même attribut à plusieurs métriques.

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

dénomination métrique

Un nom est attribué à une métrique avec la clause AS, dans le cadre du processus de création de règles NRQL. Dans l'exemple NRQL suivant, le nom de la métrique est io.totalread.bytes:

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

S'il n'y a pas de nom attribué à la clause AS, le nom métrique est le nom de l'attribut de requête. Dans cet exemple, si aucun nom n’a été attribué, le nom de la métrique serait ioTotalReadBytes.

Noms métriques	Exigences et recommandations
Exigences	Conditions requises pour nommer une métrique : Inférieur ou égal à 255 unités de code 16 bits (UTF-16). Une façon de vous assurer que vous êtes en dessous de la limite est de garder chaque chaîne en dessous de 127 de ce qui est le plus facile à compter. Pas d'espaces. Commencez par une lettre. Exemples de noms métriques forts : `rubyvm.memory.heap_used` `redis.container.cpu.percent` `memcached.process_virtual_memory.bytes`
Longueur et structure	Choisissez un nom et une structure qui permettent aux autres de trouver, de comprendre et d’utiliser facilement cette métrique. Nous vous recommandons de conserver le nom de votre métrique à moins de 40 caractères pour une lisibilité idéale. Les noms plus longs peuvent être coupés ou chevaucher d’autres noms. Votre schéma de nommage métrique dépendra de votre logique métier. Vous souhaiterez peut-être utiliser l'espace de nommage pour préfixer votre nom métrique, ou vos noms devront peut-être être plus généraux.
Composants dans le nom	Si vous souhaitez créer des composants au sein du nom de votre métrique (comme la source des métriques et l'élément que vous mesurez), nous vous recommandons d'aller du large au spécifique (de gauche à droite) : Utilisez un point pour séparer ces composants afin d'être cohérent avec nos noms métriques New Relic. Ensuite, utilisez un trait de soulignement pour séparer les mots à l’intérieur des points. Example: `application.page_view.duration`
Attributs	Évitez de mettre un attribut dans votre nom métrique. Les attributs sont des qualités de votre métrique que vous pouvez utiliser pour filtrer ou facetter vos données, comme cluster ou la zone de disponibilité. Example: Si vous incluez la zone de disponibilité dans le nom de votre métrique, cela signifie que, pour cette métrique, vous ne pourrez pas voir les résultats dans toutes les zones de disponibilité.
Modification des noms métriques	Si vous modifiez le nom d'une métrique, les données historiques ne seront pas mises à jour avec ce nouveau nom. Pour interroger ou tracer ces données historiques, vous devrez spécifier l'ancien nom de la métrique.