Enumere el ID de su aplicación y el intervalo de tiempo de datos métricos (v2)

A continuación se muestran ejemplos de cómo utilizar la API REST de New Relic (v2) para obtener nombres métricos y valores promedio para un ID de aplicación y una clave API específicos. Los ejemplos también muestran diferentes rangos de tiempo.

Al adquirir datos, los valores devueltos pueden verse afectados por el período de tiempo que especifique y la forma en que se almacenan los datos. Para obtener más información, consulte Extracción de datos de intervalo de tiempo de métrica.

Listar todos los ID de la aplicación

También puede utilizar el Explorador de API REST de New Relic para obtener el mismo intervalo de tiempo de datos métrico para la información de su aplicación que en este ejemplo.

Para ver todos los ID de sus aplicaciones, use el siguiente comando.

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

• Reemplace $API_KEY con su clave de API.

La salida será una matriz de datos donde el elemento es una aplicación y los datos asociados a ella. Por ejemplo, estos son los dos primeros elementos del ID de aplicación 96785 ("GreatTimes de prueba") y 1622 ("GreatTimes Prod"):

{
  "applications": [
    {
      "id": 96785,
      "name": "GreatTimes Staging",
      "language": "ruby",
      "health_status": "gray",
      ...
    },
    {
      "id": 1622,
      "name": "GreatTimes Prod",
      "language": "ruby",
      "health_status": "green",
      ...
    }
  ]
}

Mostrar ID de aplicación por nombre

Para ver el ID de una aplicación específica si conoce el nombre, sustituya el nombre de $NAME y $API_KEY con su clave de API en el siguiente comando:

$
curl -X GET 'https://api.newrelic.com/v2/applications.json' \
>
     -H "Api-Key:$API_KEY" -i \
>
     -d "filter[name]=$NAME"

El resultado será el mismo que se muestra en la lista de ejemplo de todos los ID de aplicaciones , pero solo para la aplicación específica.

Pautas de listado de nombres métricos

Enumerar los nombres métricos disponibles para su aplicación puede ser una operación muy intensiva y sólo debe usarse cuando sea necesario. Enumerar una gran cantidad de nombres métricos puede tener un efecto perjudicial en su capacidad de respuesta, así como en la de otros usos, y puede llevar a invocar protección contra sobrecarga.

Siga estas pautas para optimizar su uso:

Lista de nombres métricos para tu aplicación

Para ver los nombres métricos disponibles para su aplicación:

$
curl -X GET "https://api.newrelic.com/v2/applications/${APP_ID}/metrics.json" \
>
     -H "Api-Key:$API_KEY" -i

• Reemplace $API_KEY con su clave de API.

El resultado será similar al siguiente. Esto muestra dos de los muchos nombres métricos disponibles y sus valores. Estas listas pueden ser largas. Considere las pautas para enumerar sus nombres métricos.

{
  "metrics": [
    {
      "name": "ActiveRecord/Account/create",
      "values": [
        "average_response_time",
        "calls_per_minute",
        "call_count",
        "min_response_time",
        "max_response_time",
        "average_exclusive_time",
        "average_value",
        "requests_per_minute",
        "standard_deviation"
      ]
    },
    ...
    {
      "name": "Apdex/members/destroy",
      "values": [
        "s",
        "t",
        "f",
        "count",
        "score",
        "value",
        "threshold",
        "threshold_min"
      ]
    },
    ...
  ]
}

Filtre la salida del nombre de su métrica, para devolver una lista más pequeña, especificando el filtro name= de esta manera:

$
curl -X GET "https://api.newrelic.com/v2/applications/${APP_ID}/metrics.json" \
>
     -H "Api-Key:$API_KEY" -i \
>
     -d "name=Controller/welcome/index"

• Reemplace $API_KEY con su clave de API.

Obtenga los valores de datos de intervalo de tiempo de métrica de su aplicación

Para ver los datos del intervalo de tiempo de métrica para su aplicación:

$
curl -X GET "https://api.newrelic.com/v2/applications/${APP_ID}/metrics/data.json" \
>
     -H "Api-Key:$API_KEY" -i \
>
     -d 'names[]=EndUser&values[]=call_count&values[]=average_response_time&summarize=true'

{
  "metric_data": {
    "from": "2014-05-20T23:41:15+00:00",
    "to": "2014-05-21T00:11:15+00:00",
    "metrics": [
      {
        "name": "EndUser",
        "timeslices": [
          {
            "from": "2014-05-20T23:39:00+00:00",
            "to": "2014-05-21T00:08:59+00:00",
            "values": {
              "call_count": 724,
              "average_response_time": 2110
            }
          }
        ]
      }
    ]
  }
}

$
curl -X GET "https://api.newrelic.com/v2/applications/${APP_ID}/metrics/data.json" \
>
     -H "Api-Key:$API_KEY" -i \
>
     -d "names[]=EndUser&names[]=EndUser/Apdex&values[]=call_count&values[]=average_response_time&values[]=score&summarize=true"

{
  "metric_data": {
    "from": "2014-05-20T23:41:15+00:00",
    "to": "2014-05-21T00:11:15+00:00",
    "metrics": [
      {
        "name": "EndUser",
        "timeslices": [
          {
            "from": "2014-05-20T23:39:00+00:00",
            "to": "2014-05-21T00:08:59+00:00",
            "values": {
              "call_count": 724,
              "average_response_time": 2110
            }
          }
        ]
      },
      {
        "name": "EndUser/Apdex",
        "timeslices": [
          {
            "from": "2015-03-31T20:33:00+00:00",
            "to": "2015-03-31T21:02:59+00:00",
            "values": {}
          }
        ]
      }
    ]
  }
}