Tutoriel NerdGraph : règle d'alerte

Pour les alertes New Relic , vous pouvez gérer votre règle d'alerte à l'aide de notre API NerdGraph.

Conseil

Pour savoir comment démarrer avec NerdGraph, consultez Introduction à NerdGraph.

Liste et filtrage des politiques

La requête policiesSearch vous permet de parcourir l'ensemble de votre règle d'alerte par compte. Il permet également certaines fonctionnalités de filtrage sur les politiques de compte.

Voici un exemple :

{
  actor {
    account(id: YOUR_ACCOUNT_ID) {
      alerts {
        policiesSearch {
          policies {
            id
            name
            incidentPreference
          }
        }
      }
    }
  }
}

Afin de parcourir vos politiques, vous devez demander le champ nextCursor lors de votre requête initiale.

Avec la pagination du curseur, vous continuez à effectuer une requête via l'ensemble de résultats jusqu'à ce que le nextCursor renvoyé par la réponse revienne vide. Cela signifie que vous avez atteint la fin de vos résultats.

Voici un exemple :

{
  actor {
    account(id: YOUR_ACCOUNT_ID) {
      alerts {
        policiesSearch {
          nextCursor
          policies {
            id
            name
            incidentPreference
          }
          totalCount
        }
      }
    }
  }
}

Le code ci-dessus renvoie un ensemble de résultats comme celui-ci :

{
  "data": {
    "actor": {
      "account": {
        "alerts": {
          "policiesSearch": {
            "nextCursor": "/8o0y2qiR54m6thkdgHgwg==:jZTXDFKbTkhKwvMx+CtsPVM=",
            "policies": [
              {
                "id": "3455",
                "incidentPreference": "PER_POLICY",
                "name": "First Policy Name"
              },
              {
                "id": "2123",
                "incidentPreference": "PER_POLICY",
                "name": "Another Policy"
              }
              // ... more policies here in reality
            ],
            "totalCount": 745
          }
        }
      }
    }
  }
}

Ainsi, dans votre requête suivante, fournissez le curseur comme ceci, jusqu'à ce que le curseur soit vide :

{
  actor {
    account(id: YOUR_ACCOUNT_ID) {
      alerts {
        policiesSearch(
          cursor: "/8o0y2qiR54m6thkdgHgwg==:jZTXDFKbTkhKwvMx+CtsPVM="
        ) {
          nextCursor
          policies {
            id
            name
            incidentPreference
          }
          totalCount
        }
      }
    }
  }
}

L'API permet l'interrogation de politiques par une sous-sélection d'identifiants. Cela ne renverra que les informations relatives aux politiques que vous fournissez.

{
  actor {
    account(id: YOUR_ACCOUNT_ID) {
      alerts {
        policiesSearch(
          searchCriteria: { ids: [A_POLICY_ID, ANOTHER_POLICY_ID] }
        ) {
          policies {
            id
            name
            incidentPreference
          }
        }
      }
    }
  }
}

L'API permet d'interroger les politiques par nom. Utilisez name pour une correspondance par noms exacts ou nameLike pour une correspondance partielle. Les deux critères de recherche ne sont pas sensibles à la casse. Cela renverra uniquement les informations pour les politiques qui correspondent au nom fourni.

Dans cet exemple, nous souhaitons trouver les politiques avec DevOps dans le nom :

{
  actor {
    account(id: YOUR_ACCOUNT_ID) {
      alerts {
        policiesSearch(searchCriteria: { nameLike: "DevOps" }) {
          policies {
            id
            name
          }
        }
      }
    }
  }
}

L'API vous permet d'effectuer une requête par identifiant de politique :

{
  actor {
    account(id: YOUR_ACCOUNT_ID) {
      alerts {
        policy(id: YOUR_POLICY_ID) {
          id
          name
          incidentPreference
        }
      }
    }
  }
}

Créer une politique

Pour créer une politique, fournissez un nom et un incidentPreference.

La préférence incident configurera la manière dont l'incident est créé pour chaque condition créée dans la politique. Pour plus d'informations, reportez-vous à la documentation sur le choix de votre préférence d'incident.

mutation {
  alertsPolicyCreate(
    accountId: YOUR_ACCOUNT_ID
    policy: { name: "Your Policy Name", incidentPreference: PER_CONDITION }
  ) {
    id
    name
    incidentPreference
  }
}

Mettre à jour une politique

Lorsque vous mettez à jour une politique, notez que vous n'avez pas besoin de fournir tous les attributs de la politique. Par exemple, vous n'avez besoin de fournir le nom que si vous avez l'intention de le mettre à jour :

mutation {
  alertsPolicyUpdate(
    accountId: YOUR_ACCOUNT_ID
    id: YOUR_POLICY_ID
    policy: { name: "Updated Policy Name" }
  ) {
    id
    name
    incidentPreference
  }
}

Supprimer une politique

Vous pouvez supprimer des politiques via l'API NerdGraph. Notez que seul l'identifiant peut être demandé à partir d'une ressource supprimée :

mutation {
  alertsPolicyDelete(accountId: YOUR_ACCOUNT_ID, id: YOUR_POLICY_ID) {
    id
  }
}

Cette traduction automatique est fournie pour votre commodité.

Conseil

Liste et filtrage des politiques

Liste de toutes les politiques d'un compte

Pagination des politiques avec pagination du curseur

Rechercher toutes les politiques par identifiants sélectionnés

Trouver toutes les politiques par nom

Rechercher une politique par identifiant

Créer une politique

Mettre à jour une politique

Supprimer une politique

Cette traduction automatique est fournie pour votre commodité.

Tutoriel NerdGraph : règle d'alerte

Conseil

Liste et filtrage des politiques .css-21sua1{background:none;border:none;width:0;padding:0;}

Pagination des politiques avec pagination du curseur

Rechercher toutes les politiques par identifiants sélectionnés

Trouver toutes les politiques par nom

Rechercher une politique par identifiant

Créer une politique

Mettre à jour une politique

Supprimer une politique

Liste et filtrage des politiques