Esta página descreve 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 válidas do PromQL.
Esta página não aborda a linguagem PromQL. Para mais informações sobre o PromQL, recomendamos consultar a documentação de código aberto. Os recursos abaixo podem ajudar você a começar:
Acessar o editor de código
Acesse o PromQL nas seguintes páginas do console do Google Cloud:
- Metrics Explorer
- Adicionar widget ao criar painéis
Para abrir o editor de código usando o Metrics Explorer, faça o seguinte:
-
No painel de navegação do console do Google Cloud, selecione Monitoramento e leaderboard Metrics Explorer:
- Na barra de ferramentas do painel do criador de consultas, selecione o botão com o nome code MQL ou code PromQL.
- Verifique se PromQL está selecionado no botão de alternância Language. O botão de alternância está na mesma barra de ferramentas que permite formatar a consulta.
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 fica desativada por padrão.
Para ativar a opção de execução automática, use o botão Execução automática. 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 fixa 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
A forma 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 no Metrics Explorer, você tem a opção de salvar seu gráfico em um painel personalizado. Para salvar o gráfico, faça o seguinte:
-
No painel de navegação do console do Google Cloud, selecione Monitoramento e leaderboard Metrics Explorer:
- Na barra de ferramentas do painel do criador de consultas, selecione o botão com o nome code MQL ou code PromQL.
- Verifique se PromQL está selecionado no botão de alternância Language. O botão de alternância está na mesma barra de ferramentas que permite formatar a consulta.
- Insira sua consulta no editor.
Se você não tiver ativado a opção de execução automática do editor de código, execute sua consulta clicando em Executar consulta antes de salvar o gráfico. Por padrão, os painéis personalizados salvam as alterações periodicamente. Quando você não executa a consulta primeiro, o editor de código salva a última consulta executada.
Clique em Salvar gráfico.
Para continuar salvando o gráfico:
- Dê um título descritivo ao gráfico.
- Selecione o painel desejado para o novo gráfico.
- 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:
Dê um título descritivo ao gráfico.
Se você não tiver ativado a opção de execução automática do editor de código, execute sua consulta clicando em Executar consulta antes de salvar o gráfico. Por padrão, os painéis personalizados salvam as alterações periodicamente. Quando você não executa a consulta primeiro, o editor de código salva a última consulta executada.
Se o salvamento automático não estiver ativado no painel, clique em Salvar.
O console do Google Cloud é compatível com filtros no nível da página para painéis personalizados. Esses filtros são compatíveis com gráficos PromQL nos seus painéis personalizados.
Sair do editor de código
Para sair do editor de código sem salvar a consulta, clique em uma das outras guias do seletor. Todo o texto de consulta no editor é descartado, mas você tem a opção de salvá-lo na área de transferência.