Administrar entidad en condición de alerta

En , un entity se define como cualquier objetivo de monitoreo, como una aplicación, un browser o un host. La UI de alertas muestra las entidades disponibles que puedes seleccionar. También puede emplear la API REST y el Explorador 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 gestionar programáticamente sus alertas. Para obtener más contexto, lea Introducción a las API para alertas.

Requisitos

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

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

Procedimiento general

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

Localice el ID de entidad correspondiente; por ejemplo, ID de la aplicación y IDbrowser .
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 o 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:
bash
```
$curl -X GET 'https://api.newrelic.com/v2/applications.json' \
>     -H $API_KEY -i
```
O
Si conoce el nombre de la aplicación, utilice este comando y especifique app_name:
bash
```
$curl -X GET 'https://api.newrelic.com/v2/applications.json' \
>     -H $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:

bash

$curl -X GET 'https://api.newrelic.com/v2/alerts_policies.json' \
>     -H $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:

bash

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

bash

$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 eliminar entity_id 8288171 de condition_id 234567, con entity_type configurado como Application:

bash

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

Te ofrecemos esta traducción automática para facilitar la lectura.

Administrar entidad en condición de alerta

Antes de usar la API REST .css-21sua1{background:none;border:none;width:0;padding:0;}

Requisitos

Procedimiento general

Importante

Ejemplo: Agregar o eliminar una entidad

Antes de usar la API REST