consulta monitoramento sintético dados

Após configurar sua infraestrutura de monitoramento, você poderá utilizar a consulta para recuperar informações sobre sua entidade Sintética. consulta faz requests para buscar dados sobre monitores, localização privada, credenciais e período de inatividade. Este tutorial fornece exemplos de como usar a API do NerdGraph para consultar dados sintéticos de monitoramento.

Para conhecer os recursos adicionais de consulta disponíveis para sua entidade Sintético, confira o tutorial API NerdGraph entidade.

Monitor de consulta

Esta consulta recupera todos os monitores Sintético em sua conta, retornando informações essenciais, incluindo o GUID do monitor, nome, ID da conta, tipo de monitor e tag associada. A tag contém detalhes adicionais de configuração e metadados sobre cada monitor.

Parâmetro de entrada

Exemplo de consulta

{
  actor {
    entitySearch(query: "domain = 'SYNTH' AND type = 'MONITOR'") {
      results {
        entities {
          ... on SyntheticMonitorEntityOutline {
            guid
            name
            accountId
            monitorType
            tags {
              key
              values
            }
          }
        }
      }
    }
  }
}

Consulta localização privada

Esta consulta recupera todos os locais privados da sua conta, retornando informações essenciais, incluindo o GUID do local, o nome, o ID da conta e a etiqueta associada. localização privada permite que você monitore aplicativos atrás de seu firewall, e seus detalhes de configuração são acessíveis através da tag.

Parâmetro de entrada

Exemplo de consulta

{
  actor {
    entitySearch(query: "domain = 'SYNTH' AND type = 'PRIVATE_LOCATION'") {
      results {
        entities {
          accountId
          guid
          name
          tags {
            key
            values
          }
        }
      }
    }
  }
}

Consultar monitor período de inatividade

Esta consulta recupera todos os períodos de inatividade do monitor em sua conta, retornando informações essenciais, incluindo o GUID do período de inatividade, nome, ID da conta e tag associada. O período de inatividade dos monitores são períodos programados em que os monitores da Sintético param de funcionar, úteis durante manutenções planejadas ou interrupções conhecidas. Detalhes de configuração, como tipo de agendamento, fuso horário e padrões de recorrência, são armazenados na tag.

Parâmetro de entrada

Exemplo de consulta

{
  actor {
    entitySearch(query: "domain = 'SYNTH' AND type = 'MONITOR_DOWNTIME'") {
      results {
        entities {
          accountId
          guid
          name
          tags {
            key
            values
          }
        }
      }
    }
  }
}

Consultar credenciais seguras

Esta consulta recupera todas as credenciais seguras da sua conta, retornando informações específicas, incluindo o GUID da credencial, nome, ID da conta, etiqueta e data timestamp da última atualização. Credenciais seguras ajudam a armazenar, proteger e gerenciar centralmente informações confidenciais, como senhas, chaves de API ou certificados criptografados. Por motivos de segurança, a consulta de credenciais seguras retorna apenas metadados, e não os valores reais das credenciais.

Parâmetro de entrada

Exemplo de consulta

{
  actor {
    entitySearch(query: "domain = 'SYNTH' AND type = 'SECURE_CRED'") {
      results {
        entities {
          ... on SecureCredentialEntityOutline {
            accountId
            guid
            name
            tags {
              key
              values
            }
            updatedAt
          }
        }
      }
    }
  }
}

Scriptdo monitor de consulta

Esta consulta recupera o conteúdo script usado em uma API com script ou monitor de browser com script. O script contém o código JavaScript que define o comportamento do monitor, como chamadas de API, interação com o navegador ou lógica de validação personalizada. Esta consulta só funciona com tipos de monitoramento que utilizam scripts; outros tipos de monitoramento (simples, ping, passo a passo, verificação de certificado, links quebrados) retornarão um erro, pois não utilizam scripts personalizados.

Parâmetro de entrada

Exemplo de consulta

{
  actor {
    account(id: ACCOUNT_ID) {
      synthetics {
        script(monitorGuid: "ENTITY_GUID") {
          text
        }
      }
    }
  }
}

Etapas do monitor de consulta

Esta consulta recupera os passos configurados para um monitor de passos. Os monitores de etapas fornecem monitoramento baseado em navegador, sem código e em várias etapas, por meio de uma sequência de ações predefinidas, como navegação, cliques, entradas de formulário e asserções. Cada etapa possui uma posição ordinal, um tipo que define a ação e valores que contêm os dados de configuração da etapa. Esta consulta funciona apenas com monitores de passo; outros tipos de monitor retornarão um erro, pois não utilizam configuração baseada em passos.

Parâmetro de entrada

Exemplo de consulta

{
  actor {
    account(id: ACCOUNT_ID) {
      synthetics {
        steps(monitorGuid: "ENTITY_GUID") {
          ordinal
          type
          values
        }
      }
    }
  }
}

Consulta para mapear o ID do monitor para o GUID da entidade

Esta consulta recupera o GUID da entidade para um monitor Sintético utilizando o ID do monitor. Isso é útil quando você tem o ID numérico legado do monitor e precisa convertê-lo para o formato GUID da entidade, exigido para a maioria das operações do NerdGraph. O GUID da entidade é o identificador moderno usado para atualizações, exclusões e outras tarefas de gerenciamento de monitores, enquanto o ID do monitor é o identificador numérico mais antigo que pode aparecer em URLs ou integrações legadas.

Parâmetro de entrada

Exemplo de consulta

{
  actor {
    entitySearch(query: "(domainId = 'MONITOR_ID')") {
      results {
        entities {
          ... on SyntheticMonitorEntityOutline {
            guid
            name
            monitorId
          }
        }
      }
    }
  }
}

status da atualização do runtime do consulta (todos os monitores)

Esta consulta recupera o status de todos os testes de atualização de tempo de execução para monitores de tempo de execução legados em sua conta. Esses testes validam se os monitores que usam ambientes de execução mais antigos (como Chrome 72 ou API legada Node.js ) podem ser executados com sucesso em ambientes de execução mais recentes (Chrome 100+ ou Node.js 16.10). Os resultados são exibidos na interface de atualização de tempo de execução e ajudam você a identificar quais monitores estão prontos para atualização. O resultado do teste é armazenado na tag validationStatus e, se o teste de atualização falhar, informações detalhadas sobre o erro estarão disponíveis na tag validationError.

Parâmetro de entrada

Exemplo de consulta

{
  actor {
    entitySearch(query: "domain = 'SYNTH' AND type = 'RUNTIME_VALIDATION'") {
      results {
        entities {
          accountId
          guid
          name
          tags {
            key
            values
          }
        }
      }
    }
  }
}

consultar o status da atualização do runtime (monitor específico)

Esta consulta recupera o status de um teste de atualização de tempo de execução para um monitor de tempo de execução legado específico, usando o ID do monitor. Isso é útil quando você deseja verificar se um monitor específico está pronto para atualização, em vez de todos os monitores da sua conta. O teste valida se o monitor pode ser executado com sucesso em versões mais recentes do ambiente de execução, e esses resultados são exibidos na interface do usuário de atualizações do ambiente de execução. O resultado do teste é armazenado na tag validationStatus e, se o teste de atualização falhar, informações detalhadas sobre o erro estarão disponíveis na tag validationError.

Parâmetro de entrada

Exemplo de consulta

{
  actor {
    entitySearch(
      query: "domain = 'SYNTH' AND type = 'RUNTIME_VALIDATION' AND domainId = 'MONITOR_ID'"
    ) {
      results {
        entities {
          accountId
          guid
          name
          tags {
            key
            values
          }
        }
      }
    }
  }
}