Gérer l'entité en condition d'alerte

Dans alertes, un entity est défini comme toute cible de monitoring, telle qu'une application, un navigateur ou un hôte. L'UI des alertes affiche les entités disponibles que vous pouvez sélectionner. Vous pouvez également utiliser l'API REST et API Explorer pour ajouter ou supprimer une entité pour une condition.

Avant d'utiliser l'API REST

L'API REST n'est plus le moyen privilégié pour gérer vos alertes par programmation. Pour plus de contexte, lisez l'Introduction aux API pour les alertes.

Exigences

Modifier la liste des entités dans une condition nécessite de savoir :

• Votre clé API
• Le {entity_ID} de l'entité que vous souhaitez monitorer
• Le {condition_ID} de la condition que vous souhaitez modifier

Procédure générale

Pour mettre à jour la liste des entités pour une condition :

1. Localisez l'ID d'entité approprié ; par exemple, identifiant d'application et navigateur ID.

2. Identifiez l'ID de la politique par nom ou par type.

3. Obtenez la liste des conditions associées à la politique et choisissez celle que vous souhaitez modifier pour la catégorie appropriée :

   • APM, monitoring des navigateurs et monitoring des applications mobiles
   • Services externes
   • Monitoring synthétique

4. Modifiez la condition à l'aide des d'ajout ou de suppression.API requests

Exemple : ajouter ou supprimer une entité

L'exemple suivant montre comment ajouter une application Ruby nommée TimberTime dans une condition et comment supprimer une entité de cette même condition.

Seule la première étape de cet exemple est propre au choix de l’application Ruby comme entité. Les étapes restantes seront les mêmes quelle que soit l’entité que vous choisissez.

1. Obtenez le entity_id; par exemple, application_id:

   bash

   Copier

   $
   curl -X GET 'https://api.newrelic.com/v2/applications.json' \
   >
        -H $API_KEY -i

   OU

   Si vous connaissez le nom de l'application, utilisez cette commande et spécifiez le app_name:

   bash

   Copier

   $
   curl -X GET 'https://api.newrelic.com/v2/applications.json' \
   >
        -H $API_KEY -i \
   >
        -d 'filter[name]=TimberTime'

2. Examinez la sortie pour trouver le application_id et utilisez-le comme entity_id:

   {
     "applications": [
       {
         "id": 12345,         // application_id == entity_id
         "name": "TimberTime",
         "language": "ruby",
         "health_status": "gray",
         ...
       },

   Copier

3. Obtenez le policy_id que vous souhaitez mettre à jour ; par exemple, la politique Logjam Alert de l'application TimberTime . Pour obtenir le policy_id, utilisez cette commande :

   bash

   Copier

   $
   curl -X GET 'https://api.newrelic.com/v2/alerts_policies.json' \
   >
        -H $API_KEY -i \
   >
        -G -d 'filter[name]= Logjam Alert'   # policy_name

4. Examinez les résultats de la politique ; par exemple :

   {
     "policies": [
       {
         "id": 85,      // policy_id
         "incident_preference": "PER_POLICY",
         "name": "Logjam Alert",
         "created_at": 1461176510393,
         "updated_at": 1461176510393
       },

   Copier

5. Énumérez toutes les conditions de cette politique et localisez le condition_id:

   bash

   Copier

   $
   curl -X GET 'https://api.newrelic.com/v2/alerts_conditions.json' \
   >
        -H $API_KEY -i \
   >
        -G -d 'policy_id=85'

   Consultez les conditions de la police, par exemple :

   {
     "conditions": [
       {
         "id": 234567, // condition_id
         "type": "apm_app_metric",
         "name": "Throughput (web) (High)",
         "enabled": true,
         "entities": [
           "8288171" // Entity currently included in the policy
         ],
         "metric": "response_time_web",
         "terms": [
           {
             "duration": "5",
             "operator": "above",
             "priority": "critical",
             "threshold": "500",
             "time_function": "all"
           }
         ]
       }
     ]
   }

   Copier

6. Utilisez API requests pour ajouter ou supprimer une entité de la condition de la politique :

   Pour ajouter entity_id 12345 à condition_id 234567, avec entity_type défini comme Application:

   bash

   Copier

   $
   curl -X PUT 'https://api.newrelic.com/v2/alerts_entity_conditions/12345.json' \
   >
        -H $API_KEY -i \
   >
        -H 'Content-Type: application/json' \
   >
        -G -d 'entity_type=Application&condition_id=234567'

   Pour supprimer entity_id 8288171 de condition_id 234567, avec entity_type défini sur Application:

   bash

   Copier

   $
   curl -X DELETE 'https://api.newrelic.com/v2/alerts_entity_conditions/8288171.json' \
   >
        -H $API_KEY -i \
   >
        -G -d 'entity_type=Application&condition_id=234567'