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 usarem em um aplicativo. Por exemplo, em vez de uma única contagem de transações, você pode criar um gráfico que ilustra uma série temporal de contagens agrupadas ao longo do tempo. Adicione TIMESERIES à sua consulta com embeddedChartUrl:

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

Este exemplo de consulta do NerdGraph retorna o URL do gráfico na seguinte resposta:

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

Se você visualizar o URL do gráfico incorporado usando qualquer cliente HTTP padrão, ele retornará uma imagem mostrando uma visualização da resposta à consulta enviada. Esses gráficos seguem as mesmas regras de gráfico incorporado que os gráficos incorporados criados em outro lugar. Para alterar o estilo da visualização de dados, passe um argumento chartType para embeddedChartUrl.

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