Usar o editor de código para PromQL

Nesta página, descrevemos como usar o editor de código para PromQL. O editor está disponível no console do Google Cloud e fornece sugestões e outras ferramentas para criar consultas PromQL válidas.

Esta página não abrange a linguagem PromQL. Para mais informações sobre o PromQL, recomendamos consultar a documentação de código aberto. Os recursos a seguir podem ajudar você a começar:

• Como consultar o Prometheus
• Exemplos de consulta
• Folha de referência do PromQL

Acessar o editor de código

Acesse o PromQL nas seguintes páginas no console do Google Cloud:

• Metrics Explorer
• Adicionar widget ao criar painéis

Para abrir o editor de código ao usar o Metrics Explorer, faça o seguinte:

1. No Console do Google Cloud, acesse a página do  Metrics Explorer:

   Acesse o Metrics explorer

   Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoring.

2. Na barra de ferramentas do painel do criador de consultas, selecione o botão  MQL ou  PromQL.
3. Verifique se PromQL está selecionado na opção de ativar/desativar Idioma. A alternância de idiomas está na mesma barra de ferramentas que permite formatar sua consulta.

4. Depois de concluir a consulta, é possível configurar a legenda ou alterar a forma como os dados são exibidos. Para mais informações, consulte as seguintes páginas:

   • Definir as opções de exibição do gráfico
   • Configurar legendas

Usar o editor de código

Para usar o editor de código, digite sua consulta no campo de texto e clique em Executar consulta.

Preenchimento automático

Conforme você digita sua consulta, o editor exibe uma lista de preenchimentos sintaticamente válidos. Abra manualmente o menu de preenchimento automático pressionando Control+Space e dispense-o pressionando Escape.

Para navegar na lista de opções, use as teclas de seta. Pressionar Enter insere a opção selecionada.

Para inserir o prefixo comum a todas as opções disponíveis, pressione Tab.

Localizar e substituir

O editor tem o recurso de localizar e substituir. Para encontrar e, opcionalmente, substituir termos na consulta, pressione Control+F (ou Command+F no Mac). A captura de tela a seguir mostra o recurso:

Controles do Editor

O editor tem dois controles que determinam como ele interage com a consulta.

Por padrão, sua consulta é executada somente quando você clica em Executar consulta. É possível configurar o editor para executar automaticamente sua consulta enquanto você digita, mas essa opção está desativada por padrão.

Para ativar a opção de execução automática, use o botão Executar automaticamente. Quando essa opção está ativada, o editor funciona da seguinte maneira:

• O botão Executar consulta não é exibido.
• As mensagens de erro aparecem enquanto você digita.

• Se o cursor estiver no final de uma consulta incompleta, mas sem erros, o editor vai mostrar um triângulo amarelo na barra de controle. Se houver espaço, o texto Consulta incompleta também será exibido.

  O editor não tenta avaliar consultas incompletas.

Há também uma barra vertical entre o editor de código e a região do gráfico. Use essa barra para alterar os tamanhos relativos das duas regiões.

Salvar gráficos

O modo como você salva um gráfico depende do contexto em que ele foi criado:

• Do Metrics Explorer.
• Como parte da criação ou edição de um painel personalizado.

Salvar gráficos do Metrics Explorer

No editor de código do Metrics Explorer, é possível salvar o gráfico em um painel personalizado. Para salvar o gráfico, faça o seguinte:

1. No Console do Google Cloud, acesse a página do  Metrics Explorer:

   Acesse o Metrics explorer

   Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoring.

2. Na barra de ferramentas do painel do criador de consultas, selecione o botão  MQL ou  PromQL.
3. Verifique se PromQL está selecionado na opção de ativar/desativar Idioma. A alternância de idiomas está na mesma barra de ferramentas que permite formatar sua consulta.
4. Insira sua consulta no editor.

5. Se a opção de execução automática do editor de código não estiver ativada, execute sua consulta clicando em Executar consulta antes de salvar o gráfico. Por padrão, os painéis personalizados salvam suas alterações periodicamente. Quando você não executa a consulta primeiro, o editor de código salva a última consulta executada.

6. Clique em Salvar gráfico.

7. Para continuar salvando o gráfico:

   1. Dê um título descritivo ao gráfico.
   2. Selecione o painel do novo gráfico.
   3. Clique em Salvar na caixa de diálogo.

Salvar gráficos em um painel personalizado

Para salvar um novo gráfico no painel, faça o seguinte:

1. Dê um título descritivo ao gráfico.

2. Se a opção de execução automática do editor de código não estiver ativada, execute sua consulta clicando em Executar consulta antes de salvar o gráfico. Por padrão, os painéis personalizados salvam suas alterações periodicamente. Quando você não executa a consulta primeiro, o editor de código salva a última consulta executada.

3. Se o salvamento automático não estiver ativado no painel, clique em Salvar.

O console do Google Cloud oferece suporte a filtros no nível da página para painéis personalizados. Esses filtros são compatíveis com gráficos PromQL nos painéis personalizados.

Sair do editor de código

Para sair do editor de código sem salvar sua consulta, clique em uma das outras guias seletoras. Todo o texto de consulta no editor é descartado, mas você tem a opção de salvá-lo na área de transferência.