Gerenciar entidade em condição de alerta

Em alertas, um entity é definido como qualquer destino para monitoramento, como um aplicativo, um navegador ou um host. A interface de alertas mostra as entidades disponíveis que você pode selecionar. Você também pode usar a API REST e API Explorer para adicionar ou remover entidades para uma condição.

Antes de usar a API REST

A API REST não é mais a maneira preferida de gerenciar seus alertas programaticamente. Para mais contexto, leia a Introdução à API para alertas.

Requisitos

Modificar a lista de entidades numa condição exige que você saiba:

• Sua chave de API
• A {'{entity_ID}'} da entidade que pretende monitor
• O {'{condition_ID}'} da condição que você deseja modificar

Procedimento geral

Para atualizar a lista de entidades para uma condição:

1. Localize o ID da entidade apropriado; por exemplo, ID do aplicativo e ID do navegador.

2. Identifique o ID da política por nome ou tipo.

3. Obtenha a lista de condições associadas à política e escolha aquela que deseja modificar para a categoria apropriada:

   • APM, monitoramento de Browser e monitoramento de Mobile
   • Serviços externos
   • Monitoramento sintético

4. Modifique a condição usando as solicitações de API de adição ou remoção.

Exemplo: Adicionar ou remover uma entidade

O exemplo a seguir mostra como adicionar um aplicativo Ruby chamado TimberTime em uma condição e como remover uma entidade dessa mesma condição.

Apenas a primeira etapa neste exemplo é exclusiva para escolher o aplicativo Ruby como entidade. As etapas restantes serão as mesmas para qualquer entidade que você escolher.

1. Obtenha o entity_id; por exemplo, application_id:

   bash

   Copiar

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

   OU

   Se você souber o nome do aplicativo, use este comando e especifique app_name:

   bash

   Copiar

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

2. Revise a saída para encontrar application_id e use-a como entity_id:

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

   Copiar

3. Obtenha o policy_id que você deseja atualizar; por exemplo, a política Logjam Alert do aplicativo TimberTime . Para obter o policy_id, use este comando:

   bash

   Copiar

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

4. Rever o resultado da política; por exemplo:

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

   Copiar

5. Liste todas as condições desta política e localize condition_id:

   bash

   Copiar

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

   Revise as condições da apólice; por exemplo:

   {
     "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"
           }
         ]
       }
     ]
   }

   Copiar

6. Use solicitações de API para adicionar entidade ou remover entidade da condição da política:

   Para adicionar entity_id 12345 a condition_id 234567, com entity_type definido como Application:

   bash

   Copiar

   $
   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'

   Para remover entity_id 8288171 de condition_id 234567, com entity_type definido como Application:

   bash

   Copiar

   $
   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'