El APM de New Relic asigna ID a entidades relacionadas con una aplicación. Se utilizan para recopilar información sobre el funcionamiento y el rendimiento desde diferentes puntos de vista. Estos ID se pueden devolver a través de la API REST de New Relic.
Las identificaciones pueden incluir:
- ID de la aplicación
$APP_IDpara cada aplicación instrumentada - ID del host
$HOST_IDpara cada host - ID de la instancia
$INSTANCE_IDsi hay varias instancias de la aplicación
Para enumerar cualquiera de estos ID en el Explorador de API de New Relic, necesita una clave de API.
Utilice el Explorador de API
- Vaya a API Explorer.
- Desde el menú desplegable Servers, elija una URL de API basada en EE. UU. o la UE.
- Haz clic en Authorize, ingresa tu clave de API de usuario y haz clic en Authorize de nuevo.
- Expanda una de las funciones de API disponibles: GET, PUT, DELETE.
- (Opcional) Agregue valores Parameters a su llamada API para filtrar la respuesta (consulte la UI para obtener descripciones y requisitos para la v2).
- Desde el desplegable Media type, elija un formato para su solicitud: JSON o XML.
- Haga clic en Try it out, luego Execute.
Listar ID de productos
Para devolver una lista de todos los ID de producto para un producto en particular:
- Haz clic en el desplegable
GET /applications.json. - Haz clic en Try it out, luego en Execute.
- Explora la respuesta para ver todos los ID de producto.
Una vez que haya localizado un ID de producto específico, cópielo para usarlo más adelante en sus otras llamadas API REST.
ID de lista de la aplicación
A cada monitor de aplicación realizado por un agente se le asigna un nombre. Un $APP_ID único también está asociado con ese nombre. El $APP_ID es fundamental para recuperar información sobre tus aplicaciones. Para obtener más información sobre cómo incluir y usar $APP_ID y obtener los datos resumidos, consulte Cómo incluir el ID de su aplicación.
Lista ID del host
El $HOST_ID se utiliza para obtener datos de APM para un host específico que ejecuta una aplicación. Un servidor físico puede tener más de un host. Por ejemplo, un programa de servidor web que se ejecuta en un servidor físico puede configurarse para tener más de un host virtual.
Los ID del host y del servidor físico no son los mismos. Cada ID del host es único y representa diferentes elementos.
Utilice $HOST_ID para recuperar métricas resumidas para el host, así como valores de intervalo de tiempo de métrica específicos. Para más información sobre métricas disponibles:
- Vaya al API Explorer, luego seleccione el nombre de su cuenta del desplegable Select an account.
- Ve a la página Application host de API Explorer en api.newrelic.com/docs.
ID de lista de la instancia
El significado del ID de la instancia depende del agente de lenguaje de New Relic que se utilice. Puede listar este ID desde la API REST.
Agente | ID de la instancia representa |
|---|---|
Go | El programa Go en el host informa al nombre de la aplicación |
Java | Una máquina virtual Java (JVM) |
.NET | Para el agente para .NET framework, este es el |
Node.js | Un proceso de trabajo |
PHP | El agente daemon |
Ruby | Un proceso de trabajo individual de Ruby |
Python | Los procesos maestro y trabajador. |
Puede recuperar métricas de resumen para la instancia, así como valores específicos de intervalo de tiempo de métrica mediante el INSTANCE_ID. Para obtener detalles sobre las métricas disponibles, use la página Instancia de aplicación del explorador de la API REST.
Ejemplo de lista de aplicaciones de API REST
El siguiente ejemplo muestra cómo localizar toda la información de ID de una aplicación utilizando APP_ID. Si tiene una cuenta de la UE, el extremo comienza con https://api.eu.newrelic.com.
$curl -X GET 'https://api.newrelic.com/v2/applications.json' \> -H "Api-Key:$API_KEY" -i \> -d 'filter[ids]=1441' <----<<<< APP_IDEl resultado del ejemplo resultante se ejecuta en cinco servidores. Un servidor aloja dos hosts virtuales para un total de seis hosts. El resultado incluye una sección links que enumera application_instances y application_hosts para la aplicación.
{ "applications": [ { "id": 1441, <----<<<< APP_ID "name": "RPM Combined Production", "language": "ruby", "health_status": "green", "reporting": true, "last_reported_at": "2015-11-10T23:19:47+00:00", "application_summary": { . . . }, "end_user_summary": { . . . }, "settings": { . . . }, "links": { "application_instances": [ <---<<<< INSTANCE_ID list 21790, 24810, 27948, 35120, 35121, 35122, 186288, 247253, 247254, 247255, 247256 ], "application_hosts": [ <---<<<< HOST_ID list 21788, 24808, 34966, 186283, 247245, 286551 ] } } ],. . .