Consultas gravadas - Amazon Managed Grafana

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Consultas gravadas

Este tópico de documentação foi desenvolvido para espaços de trabalho do Grafana que oferecem suporte à versão 8.x do Grafana.

Para espaços de trabalho do Grafana que suportam a versão 9.x do Grafana, consulte. Trabalhando na versão 9 do Grafana

Você pode ver tendências ao longo do tempo tirando um instantâneo de um ponto de dados em um intervalo definido usando consultas registradas. Isso pode lhe dar uma visão das tendências históricas.

Para os plug-ins que não retornam séries temporais, pode ser útil traçar dados históricos. Por exemplo, talvez você queira ServiceNowconsultar um histórico dos tempos de resposta da solicitação, mas ela só pode retornar point-in-time métricas atuais.

Como funcionam as consultas gravadas

As consultas gravadas só funcionam com plug-ins de fonte de dados de back-end. Para obter mais informações, consulte Plug-in de fonte de dados de back-end. Você pode registrar três tipos de consultas:

  • linha e coluna únicas - Uma consulta que retorna uma única linha e coluna.

  • contagem de linhas - Uma consulta que retorna linhas significativas a serem contadas.

  • expressão - Qualquer expressão. Para saber mais sobre como criar e usar expressões, consulte Expressões.

Depois que uma consulta gravada é criada ou ativada, ela cria imediatamente um instantâneo e continua a criar instantâneos no intervalo definido. A consulta gravada para de tirar instantâneos quando é desativada, excluída ou quando o Grafana não está em execução. Os pontos de dados são coletados no back-end executando a consulta gravada e encaminhando cada resultado para uma instância do Prometheus habilitada para gravação remota.

nota

Você deve configurar uma fonte de dados do Prometheus e associá-la a um destino de gravação remota antes que as consultas gravadas possam ser usadas.

Criar uma consulta gravada

Para criar uma consulta registrada, conclua as seguintes etapas:

  1. Encontre ou crie uma consulta que você deseja gravar em um painel em um painel de edição. A consulta deve retornar somente uma linha e coluna. Se retornar mais, você ainda poderá registrar o número de resultados retornados usando a opção de contagem. A fonte de dados da consulta deve ser uma fonte de dados de back-end. As expressões podem ser usadas para agregar dados de uma consulta de série temporal. Para saber mais sobre como criar e usar expressões, consulte Expressões.

  2. Escolha o menu de consulta de registro localizado no editor de consultas.

  3. Insira as informações da consulta gravada. Todos os campos são obrigatórios, salvo indicação em contrário.

    • Nome - Nome da consulta registrada.

    • Descrição - (opcional) Descreva a consulta registrada como você deseja que ela apareça na lista de consultas registradas.

    • Intervalo - O intervalo no qual o instantâneo será tirado. O intervalo começa quando você cria a consulta gravada e termina se você pausar ou excluir a consulta gravada. Para obter mais informações sobre como pausar e excluir consultas gravadas, consulte Gerenciando consultas gravadas.

    • Intervalo - O intervalo de tempo relativo da consulta. Se você selecionar um intervalo de 30m e um intervalo de 1h, a consulta tirará um instantâneo a cada hora dos últimos 30 minutos.

    • Contar resultados da consulta - Se você quiser contar as linhas retornadas da sua consulta, ative essa opção. Se essa opção estiver desativada, sua consulta deverá retornar uma linha com um valor.

  4. Teste sua consulta gravada escolhendo o botão Testar consulta gravada.

  5. Escolha Iniciar consulta de gravação.

Adicionando uma consulta gravada

Você pode adicionar consultas gravadas existentes aos painéis em um painel. Para cada consulta registrada que você adiciona, uma consulta Prometheus é criada:. generated_recorded_query_name{id="generated_id", name="recorded query name"} A consulta criada pelo Prometheus retorna todos os instantâneos coletados da consulta registrada.

  1. Navegue até um painel em um painel onde você deseja adicionar uma consulta gravada.

  2. Escolha o menu + Consulta gravada.

  3. Se você quiser filtrar as consultas gravadas por fonte de dados, selecione uma fonte de dados no menu suspenso Filtrar por fonte de dados.

  4. Escolha o menu Adicionar na sua consulta gravada para adicioná-la ao painel.

Depois de adicionar sua consulta gravada ao painel, a fonte de dados do painel se tornará-- Mixed --. Sua consulta registrada é representada por uma Prometheus consulta com uma etiqueta de nome correspondente ao nome da consulta registrada. Consulte Prometheus para saber mais sobre a fonte de dados do Prometheus.

Se, depois de adicionar uma consulta registrada, aparecer uma consulta com uma fonte de -- Mixed -- dados em vez da fonte de dados do Prometheus, isso pode significar que Prometheus um destino de gravação remota não foi configurado para consultas gravadas. Consulte Destino de gravação remota para configurar um ponto de gravação remoto.

Usando uma consulta gravada

Para usar uma consulta registrada, crie uma e adicione-a a um painel. Depois disso, ele pode ser gerenciado em Preferências na guia Consultas registradas.

Gerenciando consultas gravadas

As consultas gravadas podem ser pausadas ou ativadas e excluídas da guia Consultas gravadas em Preferências. A exclusão de uma consulta registrada a removerá do Grafana, mas as informações coletadas no Prometheus ainda estarão lá. Pausar uma consulta gravada não reunirá mais novos pontos de dados até que ela seja retomada.

Destino de gravação remota

O destino de gravação remota é a fonte de dados do Prometheus na qual os pontos de dados de consulta registrados são gravados. Você precisará de um Prometheus com gravação remota ativada e precisará criar uma fonte de dados para esse Prometheus.

Para editar o destino de gravação remota, escolha Editar destino de gravação remota no menu do console na guia Consultas gravadas em Preferências. Selecione a fonte de dados do Prometheus que tem a gravação remota ativada e insira o caminho de gravação remota.