Te ofrecemos esta traducción automática para facilitar la lectura.
En caso de que haya discrepancias entre la versión en inglés y la versión traducida, se entiende que prevalece la versión en inglés. Visita esta página para obtener más información.
El Explorador 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 emplear la API REST para gestionar datos de alertas, lea la Introducción a API de .
Para alertas de infraestructura, consulte [API REST para monitoreo de infraestructura alertas](/docs/infrastructure/new-relic-infrastructure/infrastructure-alert-conditions/
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:
Puede tener una función de propietario o administrador en su cuenta and una clave de usuarioor 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.
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
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)
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:
Recomendación: 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 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
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.
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:
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:
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
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
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
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:
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
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
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:
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
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
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.
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