Gerenciar entidade em condição de alerta

Em alerta, um entity é definido como qualquer destino para monitoramento, como um aplicativo, um browser ou um host. A interface do alerta mostra a entidade disponível que você pode selecionar. Você também pode usar a API REST e o API Explorer para adicionar ou remover entidade para uma condição.

Antes de usar a API REST

A API REST não é mais a forma preferencial de gerenciar programaticamente seu alerta. Para mais contexto, leia a introdução à API para e inteligência aplicada.

Requisitos

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

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

Procedimento geral

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

Localize o ID da entidade apropriado; por exemplo, ID do aplicativo e ID do browser.
Identifique o ID da política por nome ou tipo.
Obtenha a lista de condições associadas à política e escolha aquela que deseja modificar para a categoria apropriada:
Modifique a condição usando as solicitações de API de adição ou remoção .

Importante

Siga os requisitos para o número mínimo e máximo de entidades que você pode adicionar às condições.

Exemplo: Adicionar/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.

Obtenha o entity_id; por exemplo, {application_id}:
```
curl -X GET 'https://api.newrelic.com/v2/applications.json' \
     -H "X-Api-Key:$API_KEY" -i
```
OU
Se você souber o nome do aplicativo, use este comando e especifique app_name:
```
curl -X GET 'https://api.newrelic.com/v2/applications.json' \
     -H "X-Api-Key:$API_KEY" -i \
     -d 'filter[name]=TimberTime'
```
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",
      ...
    },
```

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:

curl -X GET 'https://api.newrelic.com/v2/alerts_policies.json' \
     -H "X-Api-Key:$API_KEY" -i \
     -G -d 'filter[name]= Logjam Alert'    <---<<<  {policy_name}

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
    },

Liste todas as condições desta política e localize {condition_id}:

curl -X GET 'https://api.newrelic.com/v2/alerts_conditions.json' \
     -H "X-Api-Key:$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"
        }
      ]
    }
  ]
}

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:

curl -X PUT 'https://api.newrelic.com/v2/alerts_entity_conditions/12345.json' \
     -H "X-Api-Key:$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:

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