Administrar entidad en condición de alerta

En alerta, un entity se define como cualquier objetivo para monitoreo, como una aplicación, un browser o un host. La UIde alerta muestra la entidad disponible que puede seleccionar. También puede utilizar la API REST y el Explorador de API para agregar o eliminar entidades para una condición.

Antes de usar la API REST

La API REST ya no es la forma preferida de administrar su alerta mediante programación. Para obtener más contexto, lea la Introducción a las API de y la inteligencia aplicada.

Requisitos

Modificar la lista de entidades en una condición requiere que sepas:

Tu clave de API
El {entity_ID} de la entidad que deseas monitor
El {condition_ID} de la condición que deseas modificar

Procedimiento general

Para actualizar la lista de entidades para una condición:

Localice el ID de entidad apropiado; por ejemplo, ID de la aplicación y ID del navegador.
Identifique el ID de la política por nombre o tipo.
Obtenga la lista de condiciones asociadas a la póliza y elija la que desea modificar para la categoría adecuada:
Modifique la condición mediante las solicitudes de API para agregar o eliminar .

Importante

Siga los requisitos para la cantidad mínima y máxima de entidades que puede agregar a las condiciones.

Ejemplo: agregar/eliminar una entidad

El siguiente ejemplo muestra cómo agregar una aplicación Ruby denominada TimberTime en una condición y cómo eliminar una entidad de esa misma condición.

Solo el primer paso de este ejemplo es exclusivo de elegir la aplicación Ruby como entidad. Los pasos restantes serán los mismos para cualquier entidad que elijas.

Obtenga el entity_id; por ejemplo, {application_id}:
```
curl -X GET 'https://api.newrelic.com/v2/applications.json' \
     -H "X-Api-Key:$API_KEY" -i
```
O
Si conoce el nombre de la aplicación, utilice este comando y 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 el resultado para encontrar el {application_id} y utilícelo como {entity_id}:
```
{
  "applications": [
    {
      "id": 12345,    <---<<<  {application_id} == {entity_id}
      "name": "TimberTime",
      "language": "ruby",
      "health_status": "gray",
      ...
    },
```

Obtenga el policy_id que desea actualizar; por ejemplo, la política Logjam Alert de la aplicación TimberTime . Para obtener el 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}

Revisar el resultado de la política; Por ejemplo:

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

Enumere todas las condiciones de esta política y localice el {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'

Revisar las condiciones de la póliza; Por ejemplo:

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

Utilice solicitudes API para agregar entidad o eliminar entidad de la condición de la póliza:

Para agregar {entity_id} 12345 a {condition_id} 234567, con {entity_type} configurado 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 eliminar {entity_id} 8288171 de {condition_id} 234567, con {entity_type} configurado 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'