API de llamada REST para alerta

Nuestra API REST es la API original de New Relic para configurar mediante programación los ajustes de alerta de New Relic (obtenga más información sobre NerdGraph, nuestra API preferida).

El Explorador de API REST también incluye el formato de solicitud curl, el parámetro disponible, códigos de estado de respuesta potenciales y la estructura de respuesta JSON para cada una de las API de llamada disponibles. También puedes crear condición de alerta en la UI.

Antes de usar la API REST

Antes de utilizar la API REST para administrar datos de alertas, lea la Introducción a las API para e inteligencia aplicada.

Para alertas de infraestructura, consulte API REST para alerta de monitoreo de infraestructura.

Además, si aún no lo ha hecho, cree su cuenta New Relic gratuita a continuación para comenzar a monitorear sus datos hoy.

Datos y funciones disponibles a través de REST API

REST API functions	Comments
Ver datos de la cuenta	En general, cualquier rol puede utilizar una clave de API o REST con GET > List funciones para view alertar datos. El propietario de la cuenta y los administradores pueden utilizar su clave de API. La salida de la lista será paginada. Las funciones disponibles incluyen: Politica de alertas Condiciones para , y (se aplican algunas limitaciones). Condiciones para servicios externos. Condiciones para el monitoreo sintético Condiciones para el monitoreo sintético en múltiples ubicaciones Condiciones para NRQL (Se aplican algunas limitaciones). Evento Incidentes Incidentes
Mantener datos de cuenta	Puede tener una función de propietario o administrador en su cuenta and una clave de usuario or tener una función personalizada que otorga permisos para administrar la alerta and una clave de usuario para poder utilizar cualquier función de mantenimiento, incluidas POST > Create, PUT > Add, PUT > Update y DELETE.

REST API functions

Comments

Ver datos de la cuenta

En general, cualquier rol puede utilizar una clave de API o REST con GET > List funciones para view alertar datos. El propietario de la cuenta y los administradores pueden utilizar su clave de API.

La salida de la lista será paginada. Las funciones disponibles incluyen:

Politica de alertas
Condiciones para
,
y
(se aplican algunas limitaciones).
Condiciones para servicios externos.
Condiciones para el monitoreo sintético
Condiciones para el monitoreo sintético en múltiples ubicaciones
Condiciones para NRQL (Se aplican algunas limitaciones).
Evento
Incidentes
Incidentes

Mantener datos de cuenta

Puede tener una función de propietario o administrador en su cuenta and una clave de usuario or tener una función personalizada que otorga permisos para administrar la alerta and una clave de usuario para poder utilizar cualquier función de mantenimiento, incluidas POST > Create, PUT > Add, PUT > Update y DELETE.

Condiciones excluidas de la API REST

Este tipo de condiciones no tienen extremo disponible en la API:

APM: percentil de transacción web, condiciones dirigidas a etiquetas y anomalía
NRQL: anomalía

Politica de alertas

Estas funciones de API incluyen enlaces al Explorador de API, donde puede crear, eliminar o enumerar políticas.

Importante

Si su organización aloja datos en el centro de datos de la UE, asegúrese de utilizar los extremos de API adecuados para las cuentas de la región de la UE.

Para agregar nuevas políticas, use su clave de usuario e incluya estos dos valores en la llamada API:

Required values	Definition
Incidente `incident_preference`	Determina cómo alerta creará el incidente. Este debe ser uno de los siguientes: `PER_POLICY` (predeterminado): acumular por política. `PER_CONDITION`: Enrollar por condición. `PER_CONDITION_AND_TARGET`: Acumular por objetivo y condición.
Política `name`	La política `name` es obligatoria. Si lo deja sin cambios, se creará una política llamada cadena.

Required values

Definition

Incidente incident_preference

Determina cómo alerta creará el incidente. Este debe ser uno de los siguientes:

PER_POLICY (predeterminado): acumular por política.
PER_CONDITION: Enrollar por condición.
PER_CONDITION_AND_TARGET: Acumular por objetivo y condición.

Política name

La política name es obligatoria. Si lo deja sin cambios, se creará una política llamada cadena.

API Explorer > Alerts Policies > POST > Create

curl -X POST 'https://api.newrelic.com/v2/alerts_policies.json' \
     -H "X-Api-Key:$API_KEY" -i \
     -H 'Content-Type: application/json' \
     -d \
'{
  "policy": {
    "incident_preference": "string",
    "name": "string"
  }
}'

Utilice esta API para actualizar name y incident_preference de una política existente. Necesitará su clave de usuario.

Required values	Definition
`id`	Requerido. Para encontrar el ID de una póliza, utilice cualquiera de estas opciones: Desde la UI: en la página UI de una política, busque el ID debajo del nombre de la política. Con la API: utilice la API Listar políticas.
Incidente `incident_preference`	Determina cómo alerta creará el incidente. Debe ser uno de los siguientes: `PER_POLICY` (predeterminado): acumular por política. `PER_CONDITION`: Enrollar por condición. `PER_CONDITION_AND_TARGET`: Acumular por objetivo y condición.
Política `name`	Required. Si no cambia el nombre, el valor predeterminado es una política llamada cadena. Para encontrar el nombre exacto de una política, utilice la API Listar políticas.

Required values

Definition

id

Requerido. Para encontrar el ID de una póliza, utilice cualquiera de estas opciones:

Desde la UI: en la página UI de una política, busque el ID debajo del nombre de la política.
Con la API: utilice la API Listar políticas.

Incidente incident_preference

Determina cómo alerta creará el incidente. Debe ser uno de los siguientes:

PER_POLICY (predeterminado): acumular por política.
PER_CONDITION: Enrollar por condición.
PER_CONDITION_AND_TARGET: Acumular por objetivo y condición.

Política name

Required. Si no cambia el nombre, el valor predeterminado es una política llamada cadena.

Para encontrar el nombre exacto de una política, utilice la API Listar políticas.

API Explorer > Alerts Policies > PUT > Update

curl -X PUT 'https://api.newrelic.com/v2/alerts_policies/{id}.json' \
     -H "X-Api-Key:$API_KEY" -i \
     -H 'Content-Type: application/json' \
     -d \
'{
  "policy": {
    "incident_preference": "string",
    "name": "string"
  }
}'

Para eliminar una política existente, use su clave de usuario e incluya el policy_id (disponible en API Explorer > Alerts Policies > GET > List) en la llamada API:

API Explorer > Alerts Policies > DELETE > Delete

curl -X DELETE 'https://api.newrelic.com/v2/alerts_policies/$POLICY_ID.json' \
     -H "X-Api-Key:$API_KEY" -i

Para ver una lista de políticas existentes para su cuenta, use su clave de usuario e incluya estos valores opcionales en la llamada API:

Filtro de política opcional name

Valor de paginación opcional

API Explorer > Alerts Policies > GET > List

curl -X GET 'https://api.newrelic.com/v2/alerts_policies.json' \
     -H "X-Api-Key:$API_KEY" -i

Condiciones para APM, browser, móvil

Estas funciones de API incluyen enlaces al Explorador de API, donde puede crear, actualizar, eliminar o enumerar condiciones de políticas. Estas convocatorias son para condiciones con estos tipos de entidad:

APM: Apps y clave de transacciones
Browser: Clave de aplicaciones y transacciones
Móvil: aplicaciones móviles

Exception: Las siguientes condiciones de APM son not available de estos extremos de API:

Condiciones de etiquetas de orientación (orientación dinámica)
Condiciones percentil transacción web
Condiciones de anomalía

Importante

El API Explorer proporciona información sobre otros tipos de condiciones usando separate endpoints, incluidos servicios externos (APM y móviles) y monitoreo sintético. Considere todos los tipos de condición de alerta al realizar búsquedas o actualizaciones. Si su cuenta aloja datos en el centro de datos de la UE, asegúrese de utilizar los extremos de API adecuados para las cuentas de la región de la UE.

Para agregar condiciones a las políticas, incluya estos valores en la llamada API:

Su
El policy_id (disponible en API Explorer > Alerts Policies > GET > List)

Los valores condition requeridos en la API de llamada (descritos en la página del Explorador de API y en el glosario de API de condición de alerta)

API Explorer > Alerts Conditions > POST > Create

curl -X POST 'https://api.newrelic.com/v2/alerts_conditions/policies/$POLICY_ID.json' \
     -H "X-Api-Key:$API_KEY" -i \
     -H 'Content-Type: application/json' \
     -d \
'{
  "condition": {
    "type": "string",
    "name": "string",
    "enabled": boolean,
    "entities": [
      integer
    ],
    "metric": "string",
    "gc_metric": "string",
    "condition_scope": "string",
    "violation_close_timer": integer,
    "runbook_url": "string",
    "terms": [
      {
        "duration": "string",
        "operator": "string",
        "priority": "string",
        "threshold": "string",
        "time_function": "string"
      }
    ],
    "user_defined": {
      "metric": "string",
      "value_function": "string"
    }
  }
}'

La respuesta JSON devuelve una condición id, que deberá actualizar o eliminar. También puede ver la condición id de API Explorer > Alerts Conditions > GET > List.

Para actualizar las condiciones de las políticas, incluya estos valores en la llamada API:

Tu clave de usuario
La condición es id (disponible desde API Explorer > Alerts Conditions > GET > List)

Los valores condition requeridos en la API de llamada (descritos en la página del Explorador de API y en el glosario de API de condición de alerta)

API Explorer > Alerts Conditions > PUT > Update

curl -X PUT 'https://api.newrelic.com/v2/alerts_conditions/$CONDITION_ID.json' \
     -H "X-Api-Key:$API_KEY" -i \
     -H 'Content-Type: application/json' \
     -d \
'{
  "condition": {
    "type": "string",
    "name": "string",
    "enabled": boolean,
    "entities": [
      integer
    ],
    "metric": "string",
    "metric": "string",
    "gc_metric": "string",
    "condition_scope": "string",
    "violation_close_timer": integer,
    "runbook_url": "string",
    "terms": [
      {
        "duration": "string",
        "operator": "string",
        "priority": "string",
        "threshold": "string",
        "time_function": "string"
      }
    ],
    "user_defined": {
      "metric": "string",
      "value_function": "string"
    }
  }
}'

Para eliminar condiciones de las políticas, incluya estos valores en la llamada API:

Tu clave de usuario
El condition_id (disponible en API Explorer > Alerts Conditions > GET > List)
API Explorer > Alerts Conditions > DELETE > Delete
```
curl -X DELETE 'https://api.newrelic.com/v2/alerts_conditions/$CONDITION_ID.json' \
     -H "X-Api-Key:$API_KEY" -i
```

Para ver una lista de las condiciones existentes para su política, utilice su clave de API REST o clave de usuario y el policy_id asociado en la llamada de API.

API Explorer > Alerts Conditions > GET > List

curl -X GET 'https://api.newrelic.com/v2/alerts_conditions.json?policy_id=$POLICY_ID' \
     -H "X-Api-Key:$API_KEY" -i

Condiciones para NRQL

Estas funciones de API incluyen enlaces al Explorador de API, donde puede crear, actualizar, eliminar o enumerar condiciones NRQL para sus políticas.

Exception: Las condiciones de anomalía NRQL son not available de este extremo.

Importante

Si su organización aloja datos en el centro de datos de la UE, asegúrese de utilizar los extremos de API adecuados para las cuentas de la región de la UE.

Recommendation: Debido a la forma en que se transmiten los datos NRQL, establezca aggregation_method en EVENT_FLOW y use la configuración predeterminada de 60 para aggregation_window y 120 para aggregation_delay. EVENT_FLOW funciona en la mayoría de los casos de uso, pero para obtener información sobre qué casos de uso funcionan mejor con EVENT_TIMER, consulte ¿Qué método de agregación usar?.

API Explorer > Alerts NRQL Conditions > POST > Create

Para crear condiciones NRQL para políticas:

curl -X POST 'https://api.newrelic.com/v2/alerts_nrql_conditions/policies/$POLICY_ID.json' \
     -H "X-Api-Key:$API_KEY" -i \
     -H 'Content-Type: application/json' \
     -d \
'{
  "nrql_condition": {
    "type": "string",
    "name": "string",
    "runbook_url": "string",
    "enabled": boolean,
    "terms": [
      {
        "duration": "string",
        "operator": "string",
        "priority": "string",
        "threshold": "string",
        "time_function": "string"
      }
    ],
    "value_function": "string",
    "nrql": {
        "query": "string"
    },
    "signal": {
      "aggregation_window": "string",
      "slide_by": "integer",
      "aggregation_method": "string",
      "aggregation_delay": integer,
      "aggregation_timer": integer,
      "fill_option": "string",
      "fill_value": "string"
    },
    "expiration": {
      "expiration_duration": "string",
      "open_violation_on_expiration": boolean,
      "close_violations_on_expiration": boolean
    }
  }
}'

Si omite type o lo configura como static, se utilizarán de forma predeterminada las alertas NRQL estándar.

Para actualizar las condiciones NRQL de las políticas, incluya estos valores en la llamada API:

Tu clave de usuario
La condición es id (disponible en API Explorer Alerts NRQL Conditions > GET > List)

Los valores condition requeridos en la API de llamada (descritos en la página del Explorador de API y en el glosario de API de condición de alerta)

API Explorer > Alerts NRQL Conditions > PUT > Update

curl -X PUT 'https://api.newrelic.com/v2/alerts_nrql_conditions/$CONDITION_ID.json' \
     -H "X-Api-Key:$API_KEY" -i \
     -H 'Content-Type: application/json' \
     -d \
'{
  "nrql_condition": {
    "name": "string",
    "runbook_url": "string",
    "enabled": boolean,
    "terms": [
      {
        "duration": "string",
        "operator": "string",
        "priority": "string",
        "threshold": "string",
        "time_function": "string"
      }
    ],
    "value_function": "string",
    "nrql": {
        "query": "string"
    }
  }
}'

Para eliminar condiciones NRQL de las políticas, incluya estos valores en la llamada API:

Tu clave de usuario
La condición es id (disponible en API Explorer Alerts NRQL Conditions > GET > List)
API Explorer > Alerts NRQL Conditions > DELETE > Delete
```
curl -X DELETE 'https://api.newrelic.com/v2/alerts_nrql_conditions/$CONDITION_ID.json' \
     -H "X-Api-Key:$API_KEY" -i
```

Para ver una lista de condiciones existentes para su política de alertas, use su clave de usuario o clave de API REST y el policy_id asociado en la llamada API.

API Explorer > Alerts NRQL Conditions > GET > List

curl -X GET 'https://api.newrelic.com/v2/alerts_nrql_conditions.json' \
     -H "X-Api-Key:$API_KEY" -i \
     -d 'policy_id=$POLICY_ID'

Condiciones para servicios externos.

Estas funciones de API incluyen enlaces al Explorador de API, donde puede crear, actualizar, eliminar o enumerar condiciones de políticas. Estas convocatorias son de condiciones para servicios externos. La API de llamada se puede utilizar con y aplicaciones de monitoreo de móviles.

Importante

Si su organización aloja datos en el centro de datos de la UE, asegúrese de utilizar los extremos de API adecuados para las cuentas de la región de la UE.

Para agregar condiciones para servicios externos a políticas que tengan APM o monitoreo de aplicaciones móviles, incluya estos valores en la llamada API:

Tu clave de usuario
El policy_id (disponible en API Explorer > Alerts Policies > GET > List)

Los valores external_service_condition requeridos en la llamada API (descritos en la página API Explorer y en el glosario API condición de alerta)

API Explorer > Alerts External Service Conditions > POST > Create

curl -X POST 'https://api.newrelic.com/v2/alerts_external_service_conditions/policies/$POLICY_ID.json' \
     -H "X-Api-Key:$API_KEY" -i \
     -H 'Content-Type: application/json' \
     -d \
'{
  "external_service_condition": {
    "type": "string",
    "name": "string",
    "enabled": boolean,
    "entities": [
      integer
    ],
    "external_service_url": "string",
    "metric": "string",
    "runbook_url": "string",
    "terms": [
      {
        "duration": "string",
        "operator": "string",
        "priority": "string",
        "threshold": "string",
        "time_function": "string"
      }
    ]
  }
}'

La respuesta JSON devuelve una condición id, que deberá actualizar o eliminar. También puede ver la condición id de API Explorer > Alerts External Service Conditions > GET > List.

Para actualizar condiciones de servicios externos a políticas que tengan APM o monitoreo de aplicaciones móviles, incluya estos valores en la llamada API:

Tu clave de usuario
La condición del servicio externo id (disponible en API Explorer > Alerts External Service Conditions > GET > List)

Los valores external_service_condition requeridos en la API de llamada (descritos en la página del Explorador de API y en el glosario de API de condición de alerta)

API Explorer > Alerts External Service Conditions > PUT > Update

curl -X PUT 'https://api.newrelic.com/v2/alerts_external_service_conditions/$CONDITION_ID.json' \
     -H "X-Api-Key:$API_KEY" -i \
     -H 'Content-Type: application/json' \
     -d \
'{
  "external_service_condition": {
    "type": "string",
    "name": "string",
    "enabled": boolean,
    "entities": [
      integer
    ],
    "external_service_url": "string",
    "metric": "string",
    "runbook_url": "string",
    "terms": [
      {
        "duration": "string",
        "operator": "string",
        "priority": "string",
        "threshold": "string",
        "time_function": "string"
      }
    ]
  }
}'

Para eliminar condiciones de servicios externos de políticas con APM o monitoreo de apps móviles, incluya estos valores en la llamada API:

Tu clave de usuario
El condition_id (disponible en API Explorer > Alerts External Service Conditions > GET > List)
API Explorer > Alerts External Service Conditions > DELETE > Delete
```
curl -X DELETE 'https://api.newrelic.com/v2/alerts_external_service_conditions/$CONDITION_ID.json' \
     -H "X-Api-Key:$API_KEY" -i
```

Para ver una lista de condiciones existentes para políticas con aplicaciones de servicios externos (APM o monitoreo de móviles), use su clave de usuario o clave REST de API y el policy_id asociado en la llamada API.

API Explorer > Alerts External Service Conditions > GET > List

curl -X GET 'https://api.newrelic.com/v2/alerts_external_service_conditions.json' \
     -H "X-Api-Key:$API_KEY" -i \
     -d 'policy_id=$POLICY_ID'

Condiciones para el monitoreo sintético

Para agregar condiciones a las políticas para el monitoreo sintético, incluya estos valores en la llamada API:

Tu clave de usuario
El policy_id (disponible en API Explorer > Alerts Policies > GET > List)
Los valores synthetics_condition requeridos en la API de llamada (descritos en la página del Explorador de API y en el glosario de API de condición de alerta)
API Explorer > Alerts Synthetics Conditions > POST > Create
```
curl -X POST 'https://api.newrelic.com/v2/alerts_synthetics_conditions/policies/$POLICY_ID.json' \
     -H "X-Api-Key:$API_KEY" -i \
     -H 'Content-Type: application/json' \
     -d \
'{
  "synthetics_condition": {
    "name": "string",
    "monitor_id": "string",
    "runbook_url": "string",
    "enabled": boolean
  }
}'
```
La respuesta JSON devuelve una condición id, que deberá actualizar o eliminar. También puede ver la condición id de API Explorer > Alerts Synthetics Conditions > GET > List.

Para actualizar las condiciones de la política para el monitoreo sintético, incluya estos valores en la llamada API:

Tu clave de usuario
La condición id (disponible en API Explorer > Alerts Synthetics Conditions > GET > List)

Los valores synthetics_condition requeridos en la API de llamada (descritos en la página del Explorador de API para crear condición de alerta para Sintético y en el glosario de API de condición de alerta)

API Explorer > Alerts Synthetics Conditions > PUT > Update

curl -X PUT 'https://api.newrelic.com/v2/alerts_synthetics_conditions/$CONDITION_ID.json' \
     -H "X-Api-Key:$API_KEY" -i \
     -H 'Content-Type: application/json' \
     -d \
'{
  "synthetics_condition": {
    "name": "string",
    "monitor_id": "string",
    "runbook_url": "string",
    "enabled": boolean
  }
}'

Para eliminar las condiciones de la política para el monitoreo sintético, incluya estos valores en la llamada API:

Tu clave de usuario
El condition_id (disponible en API Explorer > Alerts Synthetics Conditions > GET > List)
API Explorer > Alerts Synthetics Conditions > DELETE > Delete
```
curl -X DELETE 'https://api.newrelic.com/v2/alerts_synthetics_conditions/$CONDITION_ID.json' \
     -H "X-Api-Key:$API_KEY" -i
```

Para ver una lista de condiciones de políticas existentes para el monitoreo sintético, use su clave de usuario o clave de API REST y el policy_id asociado en la llamada API.

API Explorer > Alerts Synthetics Conditions > GET > List

curl -X GET 'https://api.newrelic.com/v2/alerts_synthetics_conditions.json' \
     -H "X-Api-Key:$API_KEY" -i \
     -d 'policy_id=$POLICY_ID'

Condiciones de múltiples ubicaciones para el monitoreo sintético

Estas funciones de API incluyen enlaces al Explorador de API, donde puede crear, actualizar, eliminar o enumerar condiciones para su política de alertas. La API de llamada se puede utilizar para condiciones de múltiples ubicaciones con monitoreo sintético. Antes de crear o actualizar una condición, lea las reglas para la condición de alerta multiubicación.

Para agregar condiciones a las políticas para el monitoreo sintético de múltiples ubicaciones, incluya estos valores en la llamada API:

Tu clave de usuario
El policy_id (disponible en API Explorer > Alerts Policies > GET > List)

Los valores location_failure_condition requeridos en la API de llamada (descritos en la página del Explorador de API y en el glosario de API de condición de alerta)

API Explorer > Alerts Location Failure Conditions > POST > Create

curl -X POST 'https://api.newrelic.com/v2/alerts_location_failure_conditions/policies/$POLICY_ID.json' \
     -H "X-Api-Key:$API_KEY" -i \
     -H 'Content-Type: application/json' \
     -d \
'{
  "location_failure_condition": {
    "name": "string",
    "runbook_url": "string",
    "enabled": boolean,
    "entities":
    [
        "string"
    ],
    "terms": [
        {
            "priority": "string",
            "threshold": integer,
        }
    ],
    "violation_time_limit_seconds": integer
  }
}'

La respuesta JSON devuelve una condición id, que deberá actualizar o eliminar. También puede ver la condición id de API Explorer > Alerts Location Failure Conditions > GET > List.

Para actualizar las condiciones de la política para el monitoreo sintético de múltiples ubicaciones, incluya estos valores en la llamada API:

Tu clave de usuario
La condición id (disponible en API Explorer > Alerts Location Failure Conditions > GET > List)

Los valores location_failure_condition requeridos en la API de llamada (descritos en la página del Explorador de API y en el glosario de API de condición de alerta)

API Explorer > Alerts Location Failure Conditions > PUT > Update

curl -X PUT 'https://api.newrelic.com/v2/alerts_location_failure_conditions/$CONDITION_ID.json' \
     -H "X-Api-Key:$API_KEY" -i \
     -H 'Content-Type: application/json' \
     -d \
'{
  "location_failure_condition": {
    "name": "string",
    "runbook_url": "string",
    "enabled": boolean,
    "entities":
    [
        "string"
    ],
    "terms": [
        {
            "priority": "string",
            "threshold": integer,
        }
    ],
    "violation_time_limit_seconds": integer
  }
}'

Para eliminar las condiciones de la política para el monitoreo sintético de múltiples ubicaciones, incluya estos valores en la llamada API:

Tu clave de usuario
El condition_id (disponible en API Explorer > Alerts Location Failure Conditions > GET > List)
API Explorer > Alerts Location Failure Conditions > DELETE > Delete
```
curl -X DELETE 'https://api.newrelic.com/v2/alerts_location_failure_conditions/$CONDITION_ID.json' \
     -H "X-Api-Key:$API_KEY" -i
```

Para ver una lista de condiciones de políticas existentes para el monitoreo sintético de múltiples ubicaciones, use su clave de usuario o clave de API REST y el policy_id asociado en la llamada API.

API Explorer > Alerts Location Failure Conditions > GET > List

curl -X GET 'https://api.newrelic.com/v2/alerts_location_failure_conditions/policies/$POLICY_ID.json' \
     -H "X-Api-Key:$API_KEY" -i

Actividad de alerta: evento, incidente

Estas funciones API incluyen enlaces al API Explorer, donde puede ver información sobre eventos e incidentes para su política de alertas.

Importante

Si su organización aloja datos en el centro de datos de la UE, asegúrese de utilizar los extremos de API adecuados para las cuentas de la región de la UE.

Para ver el evento de entidad monitor por APM, browser, móvil, monitoreo sintético y alerta, incluya estos valores en la llamada API:

Su clave de usuario o clave REST de API
Otros valores opcionales para usar como filtros (descritos en la página de API Explorer) que dependen del tipo de producto (monitoreo de navegador, monitoreo de móviles, etc.), entidad (como apps o clave de transacción para APM, monitoreo sintético, etc. ) y tipo de evento (notificación, implementación, instrumentación, etc.)

Un valor de paginación opcional.

API Explorer > Alerts Events > GET > List

curl -X GET 'https://api.newrelic.com/v2/alerts_events.json' \
     -H "X-Api-Key:$API_KEY" -i

Para ver el incidente de cualquier monitor de entidad para su cuenta, incluya estos valores en la llamada API:

Su clave de usuario o clave REST de API
Una bandera opcional para mostrar solo aquellos incidentes que están abiertos actualmente.
Un valor de paginación opcional.
API Explorer > Alerts Incidents > GET > List
```
curl -X GET 'https://api.newrelic.com/v2/alerts_violations.json' \
     -H "X-Api-Key:$API_KEY" -i
```
Sugerencia
Para buscar información sobre políticas, condiciones e incidentes: tome los ID que se encuentran en la sección links de la propiedad violations y colóquelos en las URL contenidas en la propiedad links externa de la carga útil.

Para ver el incidente de cualquier monitor de entidad para su cuenta, incluya estos valores en la llamada API:

Su clave de usuario o clave REST de API
Una bandera opcional para mostrar solo aquellos incidentes que están abiertos actualmente.
Un indicador opcional para excluir datos de incidentes de la respuesta

Un valor de paginación opcional.

API Explorer > Alerts Incidents > GET > List

curl -X GET 'https://api.newrelic.com/v2/alerts_incidents.json' \
     -H "X-Api-Key:$API_KEY" -i

Para mostrar un único incidente asociado con su cuenta, incluya estos valores en la llamada API:

Su clave de usuario o clave REST de API

Una identificación de incidente

API Explorer > Alerts Incidents > GET > Show

curl -X GET 'https://api.newrelic.com/v2/alerts_incidents/{id}.json' \
     -H "X-Api-Key:$API_KEY" -i

Para reconocer un incidente asociado con su cuenta, incluya estos valores en la llamada API:

Tu clave de usuario

Una identificación de incidente

API Explorer > Alerts Incidents > PUT > Acknowledge

curl -X PUT 'https://api.newrelic.com/v2/alerts_incidents/{id}/acknowledge.json' \
     -H "X-Api-Key:$API_KEY" -i \
     -H 'Content-Type: application/json'

Para cerrar un incidente asociado con su cuenta, incluya estos valores en la llamada API:

Tu clave de usuario

Una identificación de incidente

API Explorer > Alerts Incidents > PUT > Close

curl -X PUT 'https://api.newrelic.com/v2/alerts_incidents/{id}/close.json' \
     -H "X-Api-Key:$API_KEY" -i \
     -H 'Content-Type: application/json'

Condiciones de la entidad de alerta

Estas funciones API incluyen enlaces al API Explorer, donde puede enumerar, agregar y eliminar entidades en las condiciones de su política de alertas.

Importante

Si su organización aloja datos en el centro de datos de la UE, asegúrese de utilizar los extremos de API adecuados para las cuentas de la región de la UE.

Para ver las condiciones que una entidad aplica a una entidad en APM, browser, móvil o clave de transacción, incluya estos valores en la llamada API:

Su clave de usuario o clave REST de API
El entity_id Esta es la entidad específica (objetivo de alerta) que se monitoreará.
El entity_type, que debe ser uno de los siguientes:
- Aplicación
- Aplicación del navegador
- Aplicación movil
- Transacción clave
API Explorer > Alerts Entity Conditions > GET > list
```
curl -X GET 'https://api.newrelic.com/v2/alerts_entity_conditions/$ENTITY_ID.json' \
     -H "X-Api-Key:$API_KEY" -i \
     -G -d 'entity_type=$ENTITY_TYPE'
```

Para agregar una entidad a una condición, incluya estos valores en la llamada API:

Tu clave de usuario
El entity_id Esta es la entidad (objetivo de alerta) que se va a monitorear. Es el ID numérico de la aplicación APM, la aplicación browser , la transacción clave o la aplicación móvil.
El condition_id (disponible en API Explorer > Alerts Conditions > GET > List)

El entity_type, que debe ser uno de los siguientes:

Aplicación
Aplicación del navegador
Aplicación movil
Transacción clave

API Explorer > Alerts Entity Conditions > PUT > Add

curl -X PUT 'https://api.newrelic.com/v2/alerts_entity_conditions/$ENTITY_ID.json' \
     -H "X-Api-Key:$API_KEY" -i \
     -H 'Content-Type: application/json' \
     -G -d 'entity_type=$ENTITY_TYPE&condition_id=$CONDITION_ID'

Para eliminar una entidad que se está monitoreando de una condición, incluya estos valores en la llamada API:

Tu clave de usuario
El entity_id Esta es la entidad de monitorización específica (objetivo de alerta) que se eliminará. Es el ID numérico de la aplicación APM, la aplicación browser , la transacción clave o la aplicación móvil.
El condition_id (disponible en API Explorer > Alerts Conditions > GET > List)

El entity_type, que debe ser uno de los siguientes:

Aplicación
Aplicación del navegador
Aplicación movil
Transacción clave

API Explorer > Alerts Entity Conditions > DELETE > Remove

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

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

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

Datos y funciones disponibles a través de REST API

Condiciones excluidas de la API REST

Politica de alertas

Importante

Actualizar políticas

Eliminar políticas existentes

Listar políticas existentes

Condiciones para APM, browser, móvil

Importante

Crear condiciones para las políticas.

Actualizar condiciones para pólizas

Eliminar condiciones de las políticas

Enumerar las condiciones existentes para las pólizas.

Condiciones para NRQL

Importante

Crear condiciones NRQL para políticas

Actualizar las condiciones NRQL para políticas

Eliminar condiciones NRQL para políticas

Enumerar las condiciones NRQL existentes para las políticas

Condiciones para servicios externos.

Importante

Servicios externos: crear condiciones para las políticas

Servicios externos: Actualizar condiciones de pólizas

Servicios externos: eliminar condiciones de las políticas

Servicios externos: enumerar las condiciones existentes para las pólizas.

Condiciones para el monitoreo sintético

Monitoreo sintético: Crear condiciones para políticas

Monitoreo sintético: Actualización de condiciones para políticas

Monitoreo sintético: Eliminar condiciones de las políticas

Monitoreo sintético: Listar condiciones existentes para políticas

Condiciones de múltiples ubicaciones para el monitoreo sintético

Sintético multiubicación: Crear condiciones para políticas

Sintético multilocalización: Actualizar condiciones de pólizas

Sintético multiubicación: Eliminar condiciones para pólizas

Sintético multiubicación: Listar condiciones existentes para pólizas

Actividad de alerta: evento, incidente

Importante

Lista de eventos

Lista de incidentes

Lista de incidentes

Mostrar incidente

Reconocer incidente

Cerrar incidente

Condiciones de la entidad de alerta

Importante

Condición de lista por entidad

Agregar una entidad a una condición

Eliminar una entidad de una condición

Antes de usar la API REST