Ajude a moldar o futuro das operações de software e manifeste-se na pesquisa de estado de DevOps 1202.

Como criar consultas de registro

Nesta página, descrevemos como criar consultas no Explorador de registros do console do Google Cloud para recuperar, refinar e analisar registros.

Antes de começar

Para visualizar os registros que você está enviando de uma conta da Amazon Web Services (AWS) para o Logging, selecione o projeto de conector da AWS no seletor de projetos do Console do Google Cloud e use o Visualizador de registros legado. O projeto de conector da AWS armazena o Amazon Resource Name (ARN) da sua conta da AWS e vincula sua conta da AWS aos serviços do Google Cloud. Para mais informações, consulte Como visualizar métricas para contas da AWS.

Primeiros passos

Para navegar até o Explorador de registros, faça o seguinte:

  1. Acesse o menu de navegação do Google Cloud e selecione Logging > Explorador de registros:
    Acessar o Explorador de registros
  2. Selecione um projeto do Google Cloud.
  3. No menu Upgrade, alterne de Visualizador de registros legado para Explorador de registros.

Agora você está no Explorador de registros.

Como criar consultas

O painel do criador de consultas fornece várias maneiras de recuperar registros:

  1. Menus suspensos do criador de consultas
  2. Consultas usando a linguagem da consulta do Logging.
  3. Guias de consulta Recentes, Salvas e Sugeridas.

query-builder-pane

Nas seções a seguir, mostramos como criar e executar consultas para recuperar registros.

Menus suspensos do criador de consultas

Os menus suspensos permitem adicionar parâmetros de consulta ao criador de consultas. É possível usar os menus suspensos para selecionar recursos, nomes de registros, gravidade de registros e intervalos de tempo. Essas opções correspondem aos campos LogEntry para todos os registros do Logging.

Menus suspensos do criador de consultas

  • Recurso: permite que você especifique o resource.type. É possível selecionar um único recurso de cada vez para adicionar ao Criador de consultas. Entradas usam o operador lógico AND.
  • Nome do registro: permite que você especifique o logName. é possível selecionar vários nomes de registro ao mesmo tempo para adicionar ao Criador de consultas. Ao selecionar várias entradas, o operador lógico OR é usado.
  • Gravidade: permite especificar a gravidade. é possível selecionar vários níveis de gravidade ao mesmo tempo para adicionar ao Criador de consultas. Ao selecionar várias entradas, o operador lógico OR é usado.

Para usar qualquer um dos menus do parâmetro de pesquisa, expanda-os e selecione um parâmetro ou vários parâmetros. Em seguida, clique em Adicionar.

Depois de criar a consulta, clique em Executar consulta para recuperar as entradas de registro que você quiser.

Consultas com restrição de tempo

Há duas maneiras de consultar registros com base no tempo:

  1. Consultar usando uma expressão de carimbo de data/hora
  2. Consultar usando o seletor de intervalo de tempo

    O Explorador de registros mostra duas maneiras de filtrar por tempo

Se você tiver uma consulta com carimbo de data/hora, o seletor de intervalo de tempo será desativado e a consulta usará a expressão de carimbo de data/hora como a restrição de intervalo de tempo. Se uma consulta não usar uma expressão de carimbo de data/hora, a consulta usará o seletor de intervalo de tempo como a restrição de intervalo de tempo.

Consultas usando a linguagem de consulta do Logging

É possível usar a linguagem de consulta do Logging para criar consultas no painel do criador de consultas do Cloud Logging, bem como na API Logging ou na interface da linha de comando.

Para mais detalhes, consulte a linguagem da consulta do Logging.

Consultas salvas

O painel do criador de consultas apresenta a guia Salvas, que possibilita acessar as consultas salvas.

Lista de consultas salvas

As consultas salvas permitem que você armazene expressões de consulta para explorar registros com mais consistência e eficiência.

Para salvar uma consulta criada no painel do criador de consultas, faça isto:

  1. Selecione Salvar no painel do criador de consultas. A caixa de diálogo Salvar consulta é aberta, com a expressão de consulta no campo Consulta.

  2. Adicione um Nome para a consulta.

    Os nomes são limitados a 64 caracteres.

  3. Opcional: para adicionar campos de resumo à consulta, alterne para Incluir campos de resumo.

  4. Opcional: adicione uma Descrição para a consulta.

    As descrições estão limitadas a 1.000 caracteres. Não inclua informações confidenciais.

  5. Selecione Salvar consulta na caixa de diálogo.

As consultas salvas aparecem em uma lista na guia Salvas no painel do criador de consultas.

Para executar uma consulta salva, clique em Executar consulta.

Consultas compartilhadas

As consultas compartilhadas permitem que os usuários de um projeto compartilhem as consultas salvas uns com os outros.

Para os papéis e permissões necessários para visualizar e editar consultas compartilhadas, consulte a seção Permissões e papéis na página de controle de acesso.

Como compartilhar uma consulta

É possível compartilhar consultas já salvas ou uma nova.

Para compartilhar uma nova consulta, faça o seguinte:

  1. Digite uma consulta no Criador de consultas.

  2. Selecione Salvar no painel do criador de consultas.

  3. Preencha os campos na caixa de diálogo de salvamento.

  4. Ative Compartilhar com projeto.

Sua consulta agora é compartilhada com outros usuários do projeto.

Para compartilhar uma consulta já salva, faça o seguinte:

  1. Selecione Salvos.

  2. Selecione Mais opções > Editar ou selecione a consulta diretamente.

  3. Na caixa de diálogo "edit-query", ative Compartilhar com o projeto e selecione Atualizar consulta.

Sua consulta agora é compartilhada com outros usuários do projeto.

Como visualizar consultas compartilhadas

Para visualizar rapidamente todas as consultas compartilhadas, classifique a coluna Visibilidade para exibi-las primeiro:

  1. Selecione a guia Salvos.

  2. Selecione Todas.

  3. Classifique a coluna Visibilidade.

A coluna "Visibilidade" é classificada

A coluna Visibilidade distingue consultas compartilhadas com você de consultas você são compartilhadas com outros usuários do projeto.

Como visualizar apenas as consultas

Para ver as consultas compartilhadas que você criou ou compartilhou, clique em Mine. Agora, você verá uma lista das consultas que criou e salvou. Na coluna Visibilidade, é possível ver suas consultas particulares não compartilhadas. As consultas que você compartilhou são indicadas por Compartilhados comigo.

Consultas sugeridas

O Logging gera consultas sugeridas com base no entendimento dos produtos do Google Cloud que você está usando. Ele também propõe consultas que podem ajudar você a identificar problemas e fornece insights sobre a integridade geral dos seus sistemas. Por exemplo, se você detectar que está usando o Google Kubernetes Engine, o Logging poderá sugerir uma consulta que encontre todos os registros de erro dos seus contêineres.

Para visualizar e executar consultas sugeridas no painel do criador de consultas, faça o seguinte:

  1. Clique na guia Sugeridas.

    Guia de consultas sugeridas que mostram um conjunto de consultas

  2. Analise a descrição da consulta sugerida.

  3. Para analisar os detalhes de uma consulta sugerida, siga uma destas instruções:

    a. Clique na linha.

    b. Clique em Mais e selecione Visualizar.

  4. No painel do criador de consultas, você verá a consulta e as opções para Executar ou Salvar.

    a. Para salvar a consulta, clique em Salvar. A consulta será exibida na lista Salvo, em que você poderá executar a consulta posteriormente.

    b. Para executar a consulta, clique em Executar. A consulta será exibida em Visualização da consulta no painel do criador de consultas.

  5. Depois de analisar a consulta, clique em Executar consulta. Os resultados da consulta sugerida são exibidos em Resultados da consulta.

As consultas sugeridas são criadas dinamicamente com base no contexto do projeto do Google Cloud. Os carregamentos de página sucessivos podem não mostrar as mesmas consultas na mesma ordem. Este comportamento é esperado.

Consultas recentes

O painel do criador de consultas tem uma guia Recentes. Quando você executa uma consulta, ela é adicionada à lista de consultas Recentes, que contém as últimas 10.000 consultas únicas em um período de 30 dias.

A guia "Recentes" exibe as consultas recentes.

Para ver suas consultas recentes, selecione a guia Recente no painel do criador de consultas. Na guia Recente, você tem as seguintes opções:

  • Stream: Faz streaming de registros com base nos parâmetros de consulta fornecidos.
  • Executar. Executa a consulta.
  • Mais opções . Permite visualizar os parâmetros de consulta com as opções de execução da consulta ou salvá-la na lista de consultas salvas. Também é possível selecionar a consulta diretamente para ver essas opções.

    Para executar a consulta, selecione Executar.

    Para salvar a consulta, selecione Salvar como e preencha os seguintes campos:

    • Nome (obrigatório): forneça um nome.
    • Descrição (opcional): forneça uma descrição para ajudar a identificar a finalidade da consulta.
    • Incluir campos de resumo (opcional): ative Incluir campos de resumo e insira os campos que você quer exibir.
    • Truncar campos de resumo (opcional): ative a opção Truncar campos de resumo e selecione o número de caracteres a serem truncados e se o truncamento ocorre no início ou no fim de campos.

    Selecione Salvar consulta. A consulta agora está disponível na sua lista de consultas salvas.

Também é possível filtrar suas consultas recentes. o filtro corresponde ao texto na expressão da consulta.