Nesta página, descrevemos como usar o editor de código para PromQL. O editor está disponível no console do Google Cloud e oferece sugestões e outras ferramentas para criar consultas válidas do PromQL.
Esta página não aborda a linguagem PromQL. para informações sobre PromQL, recomendamos consultar a documentação de código aberto. Os recursos a seguir podem ajudar você a começar:
Acessar o editor de código
O PromQL pode ser acessado nas seguintes páginas do 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:
-
No Console do Google Cloud, acesse a página do leaderboard Metrics Explorer:
Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoring.
- Na barra de ferramentas do painel do criador de consultas, selecione o botão code MQL ou code PromQL.
- 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.
Depois de concluir a consulta, você pode configurar a legenda ou mudar a forma como os dados são mostrados. Para mais informações, consulte as seguintes páginas:
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. Você pode configurar o editor para executar automaticamente sua consulta como que 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 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 que não tenha erros, o editor mostrará um triângulo amarelo na barra de controle. Se houver for sala, o texto Consulta incompleta também será exibido.
O editor não tenta avaliar consultas incompletas.
Há também uma barra de captura 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 de salvar um gráfico depende do contexto em que você criou o gráfico:
- 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 a um painel personalizado. Para salvar o gráfico, faça o seguinte:
-
No Console do Google Cloud, acesse a página do leaderboard Metrics Explorer:
Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoring.
- Na barra de ferramentas do painel do criador de consultas, selecione o botão code MQL ou code PromQL.
- 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.
- Insira sua consulta no editor.
Se a opção de execução automática do editor de código não estiver ativada, execute a consulta clicando em Executar consulta antes de salvar o gráfico. Por padrão, os painéis personalizados salvam suas mudanças periodicamente. Quando você não executa sua 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 do 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 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 mudanças 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 para o painel, clique em Salvar.
O console do Google Cloud oferece suporte a filtros no nível da página para do Google Cloud. 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 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.