La API REST de New Relic le permite recuperar datos y enviarlos a las herramientas de New Relic, así como configurar características y realizar operaciones de eliminación. También puede utilizar API Explorer para comprender los datos disponibles a través de la API REST, obtener comando curl y ver respuestas JSON.
Configuración
La estructura del comando de la API REST sigue esta plantilla:
El comando GET también podría ser POST o DELETE, según la intención de la consulta.
Para entender el marcador de posición, sigue leyendo.
Sugerencia
Nuestros ejemplos utilizan curl como una herramienta de línea de comando común para extraer datos de intervalo de tiempo de métrica de la API REST. Sin embargo, puede utilizar cualquier método para realizar sus solicitudes REST. Los comandos curl incluyen URL de destino, información de encabezado y datos que son relevantes para cualquier mecanismo de solicitud.
URL
La API de llamada requiere una URL para especificar la ubicación desde la que se accederá a los datos. Debe reemplazar el marcador de posición <URL> con la URL adecuada que cambiará según el tipo de datos que se soliciten. En general, la URL sigue esta plantilla:
https://api.newrelic.com/v2/applications/$APP_ID/metrics/data.jsonEl $APP_ID especifica la aplicación o producto exacto para el cual se solicitan los datos. La información que sigue a este parámetro variará según la solicitud de datos.
Si tiene una cuenta de región de la UE, la URL es:
api.eu.newrelic.com/v2/applications/$APP_ID/metrics/data.jsonSugerencia
Puede recuperar datos XML en lugar de JSON reemplazando .json con .xml.
Clave de API $API_KEY
La API de llamada de New Relic requiere una clave de API. Esta puede ser una de varias claves de API:
- Una clave de usuario: se recomienda. Es nuestra implementación clave más reciente y tiene menos limitaciones que una clave de API REST. La clave de usuario también se utiliza para nuestra API NerdGraph.
- Una clave REST de API: esta es nuestra implementación de clave anterior. Para obtener más información al respecto, consulte REST clave de API. Si utiliza esta clave, el encabezado requerido es
X-Api-Keyy noApi-Key. - Si tiene una cuenta de asociación de New Relic, utilizará una clave diferente: consulte Autenticación de asociación.
En nuestros ejemplos de API REST, tomamos prestado el marcador de posición de clave API $API_KEY de la programación shell de Unix. Asegúrese de reemplazar esa y otras variables específicas del usuario al realizar llamadas.
Detalles de la consulta (carga)
La carga contiene los detalles de la consulta, que definen:
- El nombre de la métrica que desea consultar y el valor que desea recuperar
- El rango de tiempo definido para recuperar métrica
- (Opcional): El promedio del intervalo de tiempo de métrica datos usando resumen
Ejemplos
Consulte los siguientes documentos para ver ejemplos de casos de uso de API REST:
Ejemplos de APM (cómo recuperar datos de intervalo de tiempo de métrica de
).
Ejemplos de navegador (cómo recuperar datos de intervalo de tiempo de métrica de
). La API REST solo devuelve el script Lite agente del navegador. Para obtener más información, consulte esta tabla que compara los tipos Lite, Pro y Pro+SPA.
Ejemplos de alertas (crear condición de alerta y configurar canal de notificación, y más).