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 API REST también incluye el formato de solicitud curl
, los parámetros disponibles, los posibles códigos de estado de respuesta 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 emplear la API REST para gestionar datos de alerta, lea el documento Introducción al uso de alertas con nuestra API NerdGraph .
Para alertas de infraestructura, consulte la API REST para alertas de monitoreo de infraestructura
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:
|
Mantener datos de cuenta | Puede tener un rol |
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 |
---|---|
| Determina cómo las alertas crearán incidentes. Este debe ser uno de los siguientes:
|
La política |
API Explorer > Alerts Policies > POST > Create
$curl -X POST 'https://api.newrelic.com/v2/alerts_policies.json' \> -H "$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 |
---|---|
| Para encontrar el ID de una política, emplee cualquiera de estas opciones:
|
| Determina cómo las alertas crearán incidentes. Debe ser uno de los siguientes:
|
La política 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 "$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
$curl -X DELETE 'https://api.newrelic.com/v2/alerts_policies/$POLICY_ID.json' \> -H "$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
bash$curl -X GET 'https://api.newrelic.com/v2/alerts_policies.json' \>-H "$API_KEY" -i
Condiciones para APM, browser y dispositivos móviles
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 Explorador de API proporciona información sobre otros tipos de condiciones que emplean 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, cerciorar de estar empleando 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
bash$curl -X POST 'https://api.newrelic.com/v2/alerts_conditions/policies/$POLICY_ID.json' \>-H "$API_KEY" -i \>-H 'Content-Type: application/json' \>-d \>'{$"condition": {$"<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#type">type</a>": "string",$"<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#name">name</a>": "string",$"<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#enabled">enabled</a>": boolean,$"<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#entities">entities</a>": [$integer$],$"<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#metric">metric</a>": "string",$"gc_metric": "string",$"<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#condition-scope">condition_scope</a>": "string",$"<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#violation_close_timer">violation_close_timer</a>": integer,$"<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#runbook_url">runbook_url</a>": "string",$"terms": [${$"<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#terms_duration">duration</a>": "string",$"<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#terms_operator">operator</a>": "string",$"<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#terms_priority">priority</a>": "string",$"<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#terms_threshold">threshold</a>": "string",$"<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#terms_time_function">time_function</a>": "string"$}$],$"user_defined": {$"<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#user_defined_metric">metric</a>": "string",$"<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#user_defined_value_function">value_function</a>": "string"$}$}$}'La respuesta JSON devuelve una condición
id
, que deberá actualizar o eliminar. También puede ver la condiciónid
de API Explorer > Alerts Conditions > GET > List.
Para actualizar las condiciones de las políticas, incluya estos valores en la llamada API:
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
bash$curl -X PUT 'https://api.newrelic.com/v2/alerts_conditions/$CONDITION_ID.json' \>-H "$API_KEY" -i \>-H 'Content-Type: application/json' \>-d \>'{$"condition": {$"<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#type">type</a>": "string",$"<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#name">name</a>": "string",$"<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#enabled">enabled</a>": boolean,$"<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#entities">entities</a>": [$integer$],$"<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#metric">metric</a>": "string",$"<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#metric">metric</a>": "string",$"gc_metric": "string",$"<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#condition-scope">condition_scope</a>": "string",$"<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#violation_close_timer">violation_close_timer</a>": integer,$"<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#runbook_url">runbook_url</a>": "string",$"terms": [${$"<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#terms_duration">duration</a>": "string",$"<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#terms_operator">operator</a>": "string",$"<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#terms_priority">priority</a>": "string",$"<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#terms_threshold">threshold</a>": "string",$"<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#terms_time_function">time_function</a>": "string"$}$],$"user_defined": {$"<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#user_defined_metric">metric</a>": "string",$"<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#user_defined_value_function">value_function</a>": "string"$}$}$}'
Para eliminar condiciones de las políticas, incluya estos valores en la llamada API:
El
condition_id
(disponible en API Explorer > Alerts Conditions > GET > List)API Explorer > Alerts Conditions > DELETE > Delete
bash$curl -X DELETE 'https://api.newrelic.com/v2/alerts_conditions/$CONDITION_ID.json' \>-H "$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 "$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.
Recomendación: debido a la forma en que se transmiten los datos NRQL, configure aggregation_method
en EVENT_FLOW
y emplee las configuraciones predeterminadas de 60
para aggregation_window
y 120
para aggregation_delay
. EVENT_FLOW
funciona en la mayoría de los casos de uso, pero para una discusión sobre qué casos de uso funcionan mejor con EVENT_TIMER
, consulte Elija su método de agregación.
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 "$API_KEY" -i \> -H 'Content-Type: application/json' \> -d \>'{$ "nrql_condition": {$ "type": "string",$ "<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#name">name</a>": "string",$ "<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#runbook_url">runbook_url</a>": "string",$ "<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#enabled">enabled</a>": boolean,$ "terms": [$ {$ "<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#terms_duration">duration</a>": "string",$ "<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#terms_operator">operator</a>": "string",$ "<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#terms_priority">priority</a>": "string",$ "<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#terms_threshold">threshold</a>": "string",$ "<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#terms_time_function">time_function</a>": "string"$ }$ ],$ "<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#user_defined_value_function">value_function</a>": "string",$ "nrql": {$ "<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#nrql-query">query</a>": "string"$ },$ "signal": {$ "<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#signal_aggregation_window">aggregation_window</a>": "string",$ "<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#signal_slide_by">slide_by</a>": "integer",$ "<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#signal_aggregation_method">aggregation_method</a>": "string",$ "<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#signal_aggregation_delay">aggregation_delay</a>": integer,$ "<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#signal_aggregation_timer">aggregation_timer</a>": integer,$ "<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#fill_option">fill_option</a>": "string",$ "<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#fill_value">fill_value</a>": "string"$ },$ "expiration": {$ "<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#expiration_duration">expiration_duration</a>": "string",$ "<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#expiration_duration">open_violation_on_expiration</a>": boolean,$ "<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#expiration_duration">close_violations_on_expiration</a>": 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:
La condición
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
bash$curl -X PUT 'https://api.newrelic.com/v2/alerts_nrql_conditions/$CONDITION_ID.json' \>-H "$API_KEY" -i \>-H 'Content-Type: application/json' \>-d \>'{$"nrql_condition": {$"<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#name">name</a>": "string",$"<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#runbook_url">runbook_url</a>": "string",$"<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#enabled">enabled</a>": boolean,$"terms": [${$"<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#terms_duration">duration</a>": "string",$"<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#terms_operator">operator</a>": "string",$"<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#terms_priority">priority</a>": "string",$"<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#terms_threshold">threshold</a>": "string",$"<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#terms_time_function">time_function</a>": "string"$}$],$"<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#user_defined_value_function">value_function</a>": "string",$"nrql": {$"<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#nrql-query">query</a>": "string"$}$}$}'
Para eliminar condiciones NRQL de las políticas, incluya estos valores en la llamada API:
La condición
id
(disponible en API Explorer) Alerts NRQL Conditions > GET > List)API Explorer > Alerts NRQL Conditions > DELETE > Delete
bash$curl -X DELETE 'https://api.newrelic.com/v2/alerts_nrql_conditions/$CONDITION_ID.json' \>-H "$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]https://api.newrelic.com/docs/#/Alerts%20NRQL%20Conditions/get\_alerts\_nrql\_conditions\_json) > Alerts NRQL Conditions > GET > List
$curl -X GET 'https://api.newrelic.com/v2/alerts_nrql_conditions.json' \> -H "$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:
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
bash$curl -X POST 'https://api.newrelic.com/v2/alerts_external_service_conditions/policies/$POLICY_ID.json' \>-H "$API_KEY" -i \>-H 'Content-Type: application/json' \>-d \>'{$"external_service_condition": {$"<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#type">type</a>": "string",$"<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#name">name</a>": "string",$"<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#enabled">enabled</a>": boolean,$"<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#entities">entities</a>": [$integer$],$"<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#external_service_url">external_service_url</a>": "string",$"<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#metric">metric</a>": "string",$"<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#runbook_url">runbook_url</a>": "string",$"terms": [${$"<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#terms_duration">duration</a>": "string",$"<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#terms_operator">operator</a>": "string",$"<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#terms_priority">priority</a>": "string",$"<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#terms_threshold">threshold</a>": "string",$"<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#terms_time_function">time_function</a>": "string"$}$]$}$}'La respuesta JSON devuelve una condición
id
, que deberá actualizar o eliminar. También puede ver la condiciónid
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:
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
bash$curl -X PUT 'https://api.newrelic.com/v2/alerts_external_service_conditions/$CONDITION_ID.json' \>-H "$API_KEY" -i \>-H 'Content-Type: application/json' \>-d \>'{$"external_service_condition": {$"<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#type">type</a>": "string",$"<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#name">name</a>": "string",$"<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#enabled">enabled</a>": boolean,$"<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#entities">entities</a>": [$integer$],$"<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#external_service_url">external_service_url</a>": "string",$"<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#metric">metric</a>": "string",$"<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#runbook_url">runbook_url</a>": "string",$"terms": [${$"<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#terms_duration">duration</a>": "string",$"<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#terms_operator">operator</a>": "string",$"<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#terms_priority">priority</a>": "string",$"<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#terms_threshold">threshold</a>": "string",$"<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#terms_time_function">time_function</a>": "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:
El
condition_id
(disponible en API Explorer > Alerts External Service Conditions > GET > List)API Explorer > Alerts External Service Conditions > DELETE
bash$curl -X DELETE 'https://api.newrelic.com/v2/alerts_external_service_conditions/$CONDITION_ID.json' \>-H "$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 "$API_KEY" -i \> -d 'policy_id=$POLICY_ID'
Condiciones 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 con monitoreo sintético.
Para agregar condiciones a las políticas para el monitoreo sintético, incluya estos valores en la llamada API:
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
bash$curl -X POST 'https://api.newrelic.com/v2/alerts_synthetics_conditions/policies/$POLICY_ID.json' \>-H "$API_KEY" -i \>-H 'Content-Type: application/json' \>-d \>'{$"synthetics_condition": {$"<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#name">name</a>": "string",$"<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#monitor_id">monitor_id</a>": "string",$"<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#runbook_url">runbook_url</a>": "string",$"<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#enabled">enabled</a>": boolean$}$}'La respuesta JSON devuelve una condición
id
, que deberá actualizar o eliminar. También puede ver la condiciónid
de API Explorer > Alerts Synthetics Conditions > GET > List.
Para actualizar las condiciones de las políticas, incluya estos valores en la llamada API:
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
bash$curl -X PUT 'https://api.newrelic.com/v2/alerts_conditions/$CONDITION_ID.json' \>-H "X-Api-Key:<a href='/docs/apis/rest-api-v2/getting-started/introduction-new-relic-rest-api-v2#api_key'>$API_KEY</a>" -i \>-H "$API_KEY" -i \>-H 'Content-Type: application/json' \>-d \>'{$"condition": {$"<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#type">type</a>": "string",$"<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#name">name</a>": "string",$"<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#enabled">enabled</a>": boolean,$"<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#entities">entities</a>": [$integer$],$"<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#metric">metric</a>": "string",$"<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#metric">metric</a>": "string",$"gc_metric": "string",$"<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#condition-scope">condition_scope</a>": "string",$"<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#violation_close_timer">violation_close_timer</a>": integer,$"<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#runbook_url">runbook_url</a>": "string",$"terms": [${$"<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#terms_duration">duration</a>": "string",$"<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#terms_operator">operator</a>": "string",$"<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#terms_priority">priority</a>": "string",$"<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#terms_threshold">threshold</a>": "string",$"<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#terms_time_function">time_function</a>": "string"$}$],$"user_defined": {$"<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#user_defined_metric">metric</a>": "string",$"<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#user_defined_value_function">value_function</a>": "string"$}$}$}'
Para eliminar las condiciones de la política para el monitoreo sintético, incluya estos valores en la llamada API:
El
condition_id
(disponible en API Explorer > Alerts Synthetics Conditions > GET > List)API Explorer > Alerts Synthetics Conditions > DELETE
bash$curl -X DELETE 'https://api.newrelic.com/v2/alerts_synthetics_conditions/$CONDITION_ID.json' \>-H "$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 "$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:
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
bash$curl -X POST 'https://api.newrelic.com/v2/alerts_location_failure_conditions/policies/$POLICY_ID.json' \>-H "$API_KEY" -i \>-H 'Content-Type: application/json' \>-d \>'{$"location_failure_condition": {$"<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#name">name</a>": "string",$"<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#runbook_url">runbook_url</a>": "string",$"<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#enabled">enabled</a>": boolean,$"<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#entities">entities</a>":$[$"string"$],$"terms": [${$"<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#priority">priority</a>": "string",$"<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#threshold">threshold</a>": integer,$}$],$"<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#violation_time_limit_seconds">violation_time_limit_seconds</a>": integer$}$}'La respuesta JSON devuelve una condición
id
, que deberá actualizar o eliminar. También puede ver la condiciónid
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:
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
bash$curl -X PUT 'https://api.newrelic.com/v2/alerts_location_failure_conditions/$CONDITION_ID.json' \>-H "$API_KEY" -i \>-H 'Content-Type: application/json' \>-d \>'{$"location_failure_condition": {$"<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#name">name</a>": "string",$"<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#runbook_url">runbook_url</a>": "string",$"<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#enabled">enabled</a>": boolean,$"<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#entities">entities</a>":$[$"string"$],$"terms": [${$"<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#priority">priority</a>": "string",$"<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#threshold">threshold</a>": integer,$}$],$"<a href="/docs/alerts-applied-intelligence/new-relic-alerts/advanced-alerts/rest-api-alerts/alerts-conditions-api-field-names#violation_time_limit_seconds">violation_time_limit_seconds</a>": 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:
El
condition_id
(disponible en API Explorer > Alerts Location Failure Conditions > GET > List)API Explorer > Alerts Location Failure Conditions > DELETE
bash$curl -X DELETE 'https://api.newrelic.com/v2/alerts_location_failure_conditions/$CONDITION_ID.json' \>-H "$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 "$API_KEY" -i
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:
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
bash$curl -X GET 'https://api.newrelic.com/v2/alerts_entity_conditions/$ENTITY_ID.json' \>-H "$API_KEY" -i \>-G -d 'entity_type=$ENTITY_TYPE'
Para agregar una entidad a una condición, incluya estos valores en la llamada API:
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
bash$curl -X PUT 'https://api.newrelic.com/v2/alerts_entity_conditions/$ENTITY_ID.json' \>-H "$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:
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
bash$curl -X DELETE 'https://api.newrelic.com/v2/alerts_entity_conditions/$ENTITY_ID.json' \>-H "$API_KEY" -i \>-G -d 'entity_type=$ENTITY_ID&condition_id=$CONDITION_ID'