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.
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: