Tutorial de NerdGraph: consulta tus datos usando NRQL

Puede utilizar nuestra API NerdGraph para realizar consultas NRQL .

Descripción general de las consultas con NerdGraph

Puede ejecutar NRQL consulta utilizando el generador de consultas en la UI o puede utilizar nuestra API NerdGraph. NerdGraph le brinda la posibilidad de hacer algunas cosas que no puede hacer desde la UI, como consultar entre varias cuentas y ejecutar una consulta asincrónica.

Requisitos

• Todo tipo de usuario puede consultar los datos de las cuentas a las que tiene acceso. Si no puedes realizar la consulta a través de NerdGraph, puede deberse a que no tienes acceso a esa cuenta.
• Todas las consultas están sujetas a los límites de consulta de NRQL.

Consulta básica de NRQL con NerdGraph

Para realizar una consulta básica de NRQL utilizando NerdGraph, existen dos requisitos principales:

• Debe pasar la consulta NRQL como argumento de cadena al objeto NRQL
• Debes incluir el campo results en tu consulta

Por ejemplo, para obtener un recuento de todos los eventos de transacciones en la última hora, ejecutaría la siguiente consulta, especificando su ID de cuenta New Relic.

{
  actor {
    account(id: YOUR_ACCOUNT_ID) {
      nrql(query: "SELECT count(*) FROM Transaction SINCE 1 HOUR AGO") {
        results
      }
    }
  }
}

Este ejemplo de consulta devolvería un resultado como este:

{
   "data": {
      "actor": {
         "account": {
            "nrql": {
               "results": [
                 {
                  "count": 1000
                 }
                ]
            }
         }
      }
   }
}

¿Busca detalles sobre cómo redactar una consulta NRQL? Consulte la sección de documentos NRQL.

Consulta entre cuentas

Con NerdGraph, puedes ejecutar una consulta en más de una cuenta, lo que no puedes hacer en el generador de consultas. Necesitará los ID de las cuentas que desea consultar.

A continuación se muestra un ejemplo de ejecución de una consulta NRQL entre cuentas:

{
  actor {
    nrql(
      accounts: [ACCOUNT_ID_1, ACCOUNT_ID_2, ACCOUNT_ID_3]
      options: {}
      query: "YOUR_NRQL_QUERY"
      timeout: 70
    ) {
      results
    }
  }
}

Para saber cómo crear un dashboard con datos de varias cuentas, consulte el tutorial dashboard NerdGraph.

Crear gráficos integrables

Además de devolver datos sin procesar, puede obtener enlaces de gráficos integrables para que los datos se utilicen en una aplicación. Por ejemplo, en lugar de un único recuento de transacciones, puede crear un gráfico que ilustre una serie temporal de recuentos agrupados a lo largo del tiempo. Agregue TIMESERIES a su consulta con embeddedChartUrl:

{
  actor {
    account(id: YOUR_ACCOUNT_ID) {
      nrql(query: "SELECT count(*) from Transaction TIMESERIES") {
        embeddedChartUrl
      }
    }
  }
}

Este ejemplo de consulta de NerdGraph devuelve la URL del gráfico en la siguiente respuesta:

{
   "data": {
      "actor": {
         "account": {
            "nrql": {
               "embeddedChartUrl": "https://chart-embed.service.newrelic.com/charts/EMBEDDABLE-CHART-ID"
            }
         }
      }
   }
}

Si ve la URL del gráfico incrustado utilizando cualquier cliente HTTP estándar, devuelve una imagen que muestra una visualización de la respuesta a la consulta que envió. Estos gráficos siguen las mismas reglas de gráficos integrados que los gráficos integrados que se crean en otros lugares. Para cambiar el estilo de la visualización de datos, pase un argumento chartType a embeddedChartUrl.

Facetas sugeridas

Cuando utilice NerdGraph para explorar sus datos, puede utilizar el campo suggestedFacets para devolver el atributo sugerido para usar en la consulta NRQL facetada.

{
   actor {
      account(id: YOUR_ACCOUNT_ID) {
         nrql(query: "SELECT count(*) from Transaction TIMESERIES") {
            suggestedFacets {
               attributes
            }
         }
      }
   }
}

{
   "data": {
      "actor": {
         "account": {
            "nrql": {
               "suggestedFacets": [
                  "attributes": ["host"]
               ]
            }
         }
      }
   }
}

Consulta de mayor duración

Si necesita ejecutar una consulta NRQL de mayor duración, consulte una consulta asincrónica.

Otras opciones de consulta

NerdGraph le ofrece otras opciones de consulta, como:

• Consulta asincrónica
• Exportación de datos históricos
• Crear panel