Tutorial NerdGraph: consulte seus dados usando NRQL

Você pode usar nossa API NerdGraph para fazer consultas de NRQL .

Visão geral da consulta com NerdGraph

Você pode executar a consulta NRQL usando o criador de consulta na interface ou pode usar nossa API NerdGraph. O NerdGraph oferece a capacidade de fazer algumas coisas que você não pode fazer na interface do usuário, como consultar várias contas e executar uma consulta assíncrona.

Requisitos

• Todos os tipos de usuários podem consultar dados das contas às quais têm acesso. Se você não consegue consultar via NerdGraph, pode ser porque você não tem acesso a essa conta.
• Todas as consultas estão sujeitas aos limites de consulta NRQL

Consulta básica de NRQL com NerdGraph

Para fazer consultas básicas de NRQL usando NerdGraph, existem dois requisitos principais:

• Você deve passar a consulta NRQL como um argumento de string para o objeto NRQL
• Você deve incluir o campo results em sua consulta

Por exemplo, para obter uma contagem de todos os eventos de transação na última hora, você executaria a consulta a seguir, especificando o ID da sua conta New Relic.

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

Este exemplo de consulta retornaria um resultado como este:

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

Procurando detalhes sobre como escrever uma consulta NRQL? Consulte a seção de documentos NRQL.

Consulta entre contas

Com o NerdGraph, você pode fazer uma consulta em mais de uma conta, o que não é possível fazer no criador de consulta. Você precisará dos IDs das contas que deseja consultar.

Aqui está um exemplo de execução de uma consulta NRQL entre contas:

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

Para saber como criar um dashboard com dados de várias contas, consulte o tutorial dashboard NerdGraph.

Crie gráficos incorporáveis

Além de retornar dados brutos, você pode buscar links de gráficos incorporáveis para os dados a serem usados em um aplicativo. Consulte nossos documentos de gráficos públicos.

Facetas sugeridas

Ao usar o NerdGraph para explorar seus dados, você pode usar o campo suggestedFacets para retornar um atributo sugerido para uso na consulta facetada de NRQL.

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

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

Consulta mais longa

Se você precisar executar uma consulta NRQL de longa duração, consulte assíncrono consulta.

Outras opções de consulta

NerdGraph oferece outras opções de consulta, como:

• Assíncrono consulta
• Exportação de dados históricos
• Criar painel