Introduction à la création de données métriques à partir de données non métriques

Vous pouvez générer des données de type métrique à partir d'autres types de données dans New Relic, notamment événement, log et spans. Les métriques sont des agrégats de vos données et sont optimales pour analyser et monitoring les tendances sur de longues périodes.

Ce document explique :

• Raisons d'utiliser cette fonctionnalité
• Opérations disponibles
• Comment utiliser notre outil API NerdGraph pour effectuer des opérations

Pourquoi créer des métriques à partir d’autres types de données ?

L’utilisation de métriques permet un stockage de données plus efficace. Cela vous permet à son tour d'interroger vos données et de créer des graphiques plus facilement. La différence entre les métriques et les autres types de données dans New Relic est basée sur le temps. Pour plus d’informations, voir Comprendre les types de données.

• Events, logs, spans: Ces types de données représentent un enregistrement unique à un moment précis. Par exemple, vous pouvez avoir un événement pour chaque demande adressée au système. Ces données sont idéales pour un dépannage et une analyse approfondis.
• Metrics: Ils fournissent une vue agrégée de votre événement, de votre log ou de vos périodes. Les métriques sont plus adaptées pour montrer les tendances sur des périodes plus longues. Par exemple, vous pouvez regrouper le nombre total de requests par service en une seule métrique, puis examiner ces informations mois après mois.

Voici une vidéo montrant comment générer des données métriques à partir de données d'événement (7:47 minutes) :

Pour commencer à convertir vos données en métriques, créez une règle.

Opérations disponibles

Pour afficher, créer et supprimer des règles de génération de métriques à partir d'événements, de logs ou de plages, utilisez NerdGraph, notre API au format GraphQL. Avant d'effectuer toute opération, nous vous recommandons de lire Introduction à NerdGraph et d'explorer vos données avec l' outil API GraphiQL.

Ces opérations relèvent de deux types de requêtes de base :

• Mutations, qui sont des opérations qui modifient les règles ou les paramètres existants (par exemple, la création d'une nouvelle règle métrique).
• Queries, pour récupérer des données existantes (par exemple, récupérer des règles de métriques existantes).

Toutes les opérations sont basées sur les rôles dans NerdGraph en tant qu'utilisateur New Relic actuellement connecté.

Mutations

Les opérations de mutation d'événement en métriques, de log en métriques ou de spans en métriques incluent :

mutation {
  eventsToMetricsDeleteRule(deletes: { ruleId: "12", accountId: 123456 }) {
    successes {
      id
      name
      nrql
    }
    failures {
      errors {
        description
        reason
      }
      submitted {
        ruleId
        accountId
      }
    }
  }
}

{
  "data": {
    "eventsToMetricsDeleteRule": {
      "failures": [],
      "successes": [
        {
          "id": "12",
          "name": "Test Rule",
          "nrql": "SELECT summary(duration) AS 'server.responseTime' FROM Transaction WHERE appName = 'Data Points Staging' FACET name, appName, host"
        }
      ]
    }
  }
}

mutation {
  eventsToMetricsUpdateRule(
    updates: { ruleId: "12", accountId: 123456, enabled: true }
  ) {
    successes {
      id
      name
      nrql
    }
    failures {
      errors {
        description
        reason
      }
      submitted {
        ruleId
        accountId
      }
    }
  }
}

requête

Les opérations de requête incluent :

query {
  actor {
    account(id: 123456) {
      eventsToMetrics {
        allRules {
          rules {
            id
            name
            enabled
            nrql
            description
          }
        }
      }
    }
  }
}

{
  "data": {
    "actor": {
      "account": {
        "eventsToMetrics": {
          "allRules": {
            "rules": [
              {
                "description": "Metric for total time",
                "enabled": true,
                "id": "1",
                "name": "Total Time Tx",
                "nrql": "SELECT summary(totalTime) AS 'server.totalTime' FROM Transaction WHERE appName = 'Data Points Staging' FACET name, appName, host"
              },
              {
                "description": "Metric for duration",
                "enabled": true,
                "id": "2",
                "name": "Duration Rule",
                "nrql": "SELECT summary(duration) AS 'server.responseTime' FROM Transaction WHERE appName = 'Data Points Staging' FACET name, appName, host"
              }
            ]
          }
        }
      }
    }
  }
}

query {
  actor {
    account(id: 123456) {
      eventsToMetrics {
        rulesById(ruleIds: "36") {
          rules {
            id
            name
            enabled
            nrql
            description
            accountId
          }
        }
      }
    }
  }
}

{
  "data": {
    "actor": {
      "account": {
        "eventsToMetrics": {
          "rulesById": {
            "rules": [
              {
                "accountId": 123456,
                "description": "Metric for total time",
                "enabled": true,
                "id": "36",
                "name": "Total Time Tx",
                "nrql": "SELECT summary(totalTime) AS 'server.totalTime' FROM Transaction WHERE appName = 'Data Points Staging' FACET name, appName, host"
              }
            ]
          }
        }
      }
    }
  }
}

Utilisez l'outil d'exploration d'API NerdGraph

Vous pouvez utiliser NerdGraph API Explorer, notre outil GraphiQL, pour explorer la structure des données. Vous pouvez également l'utiliser pour créer et exécuter les opérations de conversion d'événements, de logs et de plages en métriques. Pour utiliser cet outil :

1. Créez la demande d’opération de métriques avec les paramètres requis.
2. Allez sur one.newrelic.com > All capabilities > Apps > NerdGraph API explorer et collez votre requête dans la zone.
3. Pour exécuter l'opération, cliquez sur le bouton rouge Execute query . Ou, pour obtenir le format curl, sélectionnez Tools > Copy as CURL.
4. Validez la réponse dans la zone de réponse.
5. Facultatif : pour vérifier que votre opération de création de règle a été effectuée avec succès, exécutez une requête de liste pour cet ID de règle.