Criar e salvar consultas usando a linguagem de consulta do Logging

Neste documento, descrevemos como recuperar e analisar registros usando o A Análise de registros grava consultas no campo do editor de consultas e seleções nos menus de filtro usando as opções incluídas nas entradas de registro. O as consultas que você cria são escritas no Linguagem de consulta do Logging.

Também é possível salvar as consultas na página "Análise de registros" ou usando o Método savedQueries.create da API Logging.

Antes de começar

• Para criar consultas, você precisa ter permissões para ler dados de registro. Esses as permissões estão incluídas no papel Leitor do Logging (roles/logging.viewer). Para detalhes sobre as permissões necessárias do IAM, consulte Permissões do console do Google Cloud.

• Para criar e usar consultas particulares, seu papel do Identity and Access Management precisa inclua logging.queries.{list, create, get, update e delete}. permissões.

• Para criar e usar consultas compartilhadas, o papel do Identity and Access Management precisa incluir o seguinte: logging.queries.{listShared, share, getShared, updateShared, deleteShared}.

Criar consultas

Para criar consultas usando o console do Google Cloud, faça o seguinte:

1. No console do Google Cloud, acesse a página Análise de registros:

   Acessar a Análise de registros

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

2. Selecione o projeto do Google Cloud ou outro projeto do Google Cloud recurso para o qual você quer exibir registros.

   Para acessar os registros enviados por um servidor da Amazon Web Services (AWS), no Logging, selecione o Projeto do conector da AWS no seletor de recursos do console do Google Cloud e depois use o Análise de registros. 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 Coletar métricas de contas da AWS.

3. Use o painel Consulta para criar sua consulta.

   

   O painel Consulta oferece várias maneiras de criar e executar expressões de consulta:

   • Pesquise texto em todos os campos de registro.
   • Selecione as opções nos menus de filtro.
   • Crie ou modifique consultas usando o editor de consultas.
   • Acesse, edite ou execute as consultas nos campos Recentes, Salvos, Sugeridos e Biblioteca.

Pesquisar texto nos campos de registro

Para pesquisar texto em todos os campos de registro e encontrar todas as entradas de registro correspondentes, digite os termos de pesquisa no campo de pesquisa:

É possível pesquisar palavras e frases, e seus termos de pesquisa podem incluir Operadores booleanos e expressões regulares:

• Para realizar uma pesquisa com diferenciação entre maiúsculas e minúsculas, você deve usar uma expressão regular.

• Para realizar uma pesquisa que não diferencia maiúsculas de minúsculas ao longo dos limites do token, digite o termos sem crases ou aspas duplas.

  Por exemplo, para pesquisar entradas de registro que contenham a palavra hello e a palavra world, digite hello world. Esse comando, que é convertido em SEARCH("hello world"), corresponde a entradas de registro que contêm os tokens hello e world, em qualquer ordem. Como a pesquisa não diferencia maiúsculas de minúsculas, a pesquisa também corresponde a uma entrada de registro que contém os tokens Hello e World. A pesquisa não corresponde ao token worlds.

• Para realizar uma pesquisa sem diferenciação de maiúsculas e minúsculas para uma frase ao longo de limites de token, coloque a frase entre crases.

  Por exemplo, para pesquisar a frase hello world, digite `hello world`. Esse comando, que é convertido em SEARCH("`hello world`"), corresponde a entradas de registro que contêm o token hello world. A pesquisa não corresponde ao token hello worlds.

• Para realizar uma pesquisa sem diferenciação entre maiúsculas e minúsculas em uma substring, quebre o texto aspas duplas. Por exemplo, "hello world" corresponde a Hello World e Hello world A mesma consulta também corresponde a hello worlds, porque a pesquisa não é realizada ao longo de limites de token.

  Observação: as pesquisas de substring são mais lentas do que as pesquisas baseadas em token. Portanto, é recomendável usar pesquisas baseadas em token sempre que possível.

Para ver os termos de pesquisa na expressão de consulta, ative Mostrar consulta.

Depois de inserir os termos de pesquisa, clique em Executar consulta ou pressione Enter de dados. Os resultados da consulta são exibidos no painel Resultados da consulta.

Operadores booleanos

Suas entradas do campo de pesquisa são convertidas em expressões booleanas que especificam uma subconjunto de todas as entradas de registro no recurso selecionado do Google Cloud.

O campo de pesquisa é compatível com o uso dos operadores booleanos AND, OR e NOT Ao usar operadores Booleanos em expressões de pesquisa, observe o seguintes:

• Não é possível usar parênteses para aninhar regras. Parênteses na pesquisa são analisados como termos de pesquisa.
• Os operadores Booleanos devem estar em maiúscula. and minúsculo, or, e not são analisados como termos de pesquisa, não como operadores.

Se você não incluir operadores, todos os termos de pesquisa e frases serão unidos por AND: É possível omitir o operador AND entre os termos de pesquisa.

Os operadores AND e OR são operadores de curto-circuito. É possível combinar as regras AND e OR na mesma expressão. Por exemplo, quando dois operadores forem misturados, a expressão a AND b OR c AND d se transformará na seguinte expressão de linguagem de consulta do Logging:

"a"
"b" OR "c"
"d"

O operador NOT tem a precedência mais alta, seguido por OR e AND, nessa ordem.

O operador NOT realiza uma negação do termo subsequente. Por exemplo: NOT error retorna entradas de registro que não contêm error. Também é possível substituir o operador NOT com o operador - (menos). Por exemplo, os dois são as mesmas:

"response" AND "successful" AND NOT "error"

"response successful" -"error"

Essa lógica também funciona com uma frase, se o operador - (menos) estiver fora do aspas. Por exemplo, as duas consultas a seguir são iguais:

-"response successful"

NOT "response successful"

Criar consultas com menus de filtro

Use os menus de filtro no painel Consulta para adicionar o recurso, o nome do registro, e os parâmetros de gravidade de registro no campo do editor de consultas. Essas opções correspondem aos campos LogEntry para todos os registros em a geração de registros.

As opções nos menus Recurso e Nome do registro são derivadas dos que são armazenadas pelo Cloud Logging.

• Recurso: permite especificar os atributos resource.type e associado resource.labels. É possível selecionar um único tipo de recurso usando este menu de filtros e zero ou mais rótulos de recursos para aplicar ao seu consulta. Os parâmetros do recurso são unidos pelo operador lógico AND.
• Nome do registro: permite que você especifique logName. Selecione vários nomes de registro para aplicar à consulta. Ao selecionar vários registros nomes, o operador lógico OR é usado.
• Gravidade: permite que você especifique a gravidade. Selecione vários níveis de gravidade ao mesmo tempo para adicionar à sua consulta. Ao selecionar vários níveis de gravidade, o operador lógico OR é usados.

Para usar qualquer um dos menus de filtro, faça o seguinte:

1. Expanda o Menu em qualquer dos menus de filtro no painel Consulta.

2. Refine os parâmetros de filtro.

3. Clique em Aplicar. Os parâmetros estão no campo do editor de consultas.

   Para ver os termos de pesquisa na expressão de consulta, ative Mostrar consulta.

4. Depois de analisar a consulta, clique em Executar consulta. Os resultados do são exibidas no painel Resultados da consulta.

Para determinados tipos de recursos do Compute Engine, como gce_instance e gce_network, o nome do recurso será mostrado com o ID como subtexto. Para Por exemplo, para o tipo de recurso gce_instance, é exibido o nome da VM ao lado do ID da VM. Os nomes dos recursos ajudam a identificar ID do recurso, em que você pode criar consultas.

Exibir registros por intervalo de tempo

Há duas maneiras de exibir registros que foram gravados em um intervalo de tempo específico:

1. Use o seletor de intervalo de tempo.
2. Inclua uma expressão de carimbo de data/hora no campo do editor de consulta.

Usar o seletor de intervalo de tempo

O intervalo de tempo padrão é de uma hora, mas é possível selecionar as opções de horário predefinidas, especificar horários de início e término personalizados ou centralizar o período de acordo com uma data usando o seletor de intervalo de tempo. Por exemplo, se você quiser exibir os dados da última semana e, em seguida, selecione Última semana no período seletor.

Também é possível definir suas preferências de fuso horário usando o seletor de período.

Incluir uma expressão de carimbo de data/hora no campo do editor de consulta

Para adicionar uma expressão de carimbo de data/hora diretamente ao campo do editor de consulta, use o método Linguagem de consulta do Logging.

Se o campo do editor de consulta contiver uma expressão com carimbo de data/hora, o o seletor de intervalo de tempo está desativado e a consulta usa 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 usa o seletor de intervalo de tempo como sua restrição de intervalo de tempo.

Criar consultas avançadas usando a linguagem de consulta do Logging

Você pode usar o Linguagem de consulta do Logging para criar consultas mais avançadas no campo do editor de consultas da Análise de registros:

1. Se você não vir o campo do editor de consultas no painel Consulta, ative Mostrar consulta.

2. Insira as expressões de consulta diretamente no campo do editor de consulta.

   Se você adicionou termos de pesquisa ao campo de pesquisa ou selecionou parâmetros nos menus de filtro, eles também aparecerão nos query-editor e são avaliadas como parte da expressão da consulta.

3. Depois de revisar sua consulta, clique em Executar consulta.

   Os registros que correspondem à consulta são listados Resultados da consulta . O Histograma e Campos de registro os painéis também se ajustam de acordo com a expressão da consulta.

Para exemplos de consultas comuns que podem ser usadas, veja Amostra de consultas usando o Explorador de registros.

Observação: o tamanho de uma consulta não pode exceder 20.000 caracteres.

Usar consultas recentes

Quando você executa qualquer consulta, ela é adicionada à lista Consultas recentes, que contém as últimas 10.000 consultas únicas em um período de 30 dias.

Para acessar suas consultas recentes, selecione a guia Recentes no painel Consulta. Na guia Recentes, você tem as seguintes opções:

• Stream: para executar a consulta e transmitir os resultados, escolha esta opção. é a melhor opção.
• Executar: para executar a consulta, escolha esta opção.

• Mais opções: Permite visualizar a expressão de consulta com as opções para executar a consulta ou salvar à sua lista de consultas salvas. Também é possível selecionar a consulta diretamente para ver essas opções.

  Para salvar a consulta, faça o seguinte:

  1. Clique em Salvar como. A caixa de diálogo Salvar consulta é aberta.

  2. Preencha os seguintes campos:

     • Nome (obrigatório): forneça um nome para sua consulta. Os nomes estão limitados a 64 caracteres.
     • 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 de resumo que você quer mostrar.
     • Truncar campos de resumo (opcional): ativar Truncar campos de resumo e selecionar o número de caracteres a truncar e se o truncamento ocorre no início ou no fim do campos.

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

Você também pode classificar e filtrar suas consultas recentes. o filtro faz correspondência com o texto na expressão de consulta.

Salvar e compartilhar consultas

Observação: caso seus dados sejam gerenciados por meio de uma Ambiente do Assured Workloads, ele pode ser afetado ou restrito. Para mais informações, consulte Restrições e limitações no Assured Workloads.

As consultas salvas permitem armazenar expressões de consulta para você analisar melhor os registros de maneira consistente e eficiente. No painel Consulta da Análise de registros. exibe uma guia Salvas, onde é possível acessar as consultas salvas. Você também pode salve as consultas usando o método da API Logging savedQueries.create:

É possível salvar a consulta para que ela fique particular e visível apenas para você e pode compartilhá-lo com outros membros do projeto do Google Cloud. Quando você compartilhar uma consulta, ela não pertence mais a você nem a qualquer membro do projeto com as permissões necessárias pode acessar a consulta.

Console

Para salvar uma expressão de consulta que você criou no campo do editor de consultas, execute seguintes:

1. Clique em Salvar no painel Consulta. A caixa de diálogo Salvar consulta é aberta. pela expressão de consulta no campo do editor de consulta.

2. Preencha os seguintes campos:

   • Nome (obrigatório): forneça um nome para sua consulta. Os nomes estão limitados a 64 caracteres.
   • Descrição (opcional): forneça uma descrição para ajudar a identificar a finalidade da consulta.
   • Incluir campos de resumo personalizados (opcional): ative Incluir resumo campos e digite os campos de resumo que você quer exibir.
   • Truncar campos de resumo (opcional): ativar Truncar campos de resumo e selecionar o número de caracteres a truncar e se o truncamento ocorre no início ou no fim do campos.
   • Compartilhar com o projeto: se quiser, ative Compartilhar com o projeto para compartilhar sua consulta com outros membros do projeto do Google Cloud.

3. Clique em Salvar consulta. Suas consultas salvas aparecem em um lista na guia Salvos.

Para executar uma consulta salva, clique em Executar. Para executar a consulta e fazer streaming os resultados, clique em Fazer streaming.

Você também pode classificar e filtrar suas consultas salvas. o filtro corresponde ao texto na expressão de consulta.

API

Para salvar uma consulta usando a API Logging, use o savedQueries.create. Para mais informações sobre esse método, sua parâmetros e dados de resposta, consulte a página de referência para savedQueries.create.

É possível executar o método savedQueries.create usando o widget do APIs Explorer na página de referência do método. Para consultas da Análise de registros, especifique o loggingQuery . O exemplo a seguir ilustra um exemplo de corpo de solicitação, que contém uma instância de SavedQuery:

{
"parent": "projects/my-project/locations/global"
"savedQueryId": "compute-query"
{
  "displayName": "compute-admin-activity-query",
  "description": "Queries for Compute Engine Admin Activity logs.",

  "loggingQuery":
    {
      "filter": resource.type="gce_instance" AND log_id("cloudaudit.googleapis.com/activity"),
    },
  "visibility": "PRIVATE"
}
}

Para compartilhar a consulta com outros membros do projeto do Google Cloud, especifique um valor de SHARED no campo visibility;

1. Insira uma consulta no campo do editor de consultas.

2. Clique em Salvar.

3. Preencha os campos na caixa de diálogo Salvar consulta.

4. Ative Compartilhar com o projeto.

5. Clique em Salvar consulta.

Sua consulta agora está compartilhada com outros usuários do projeto do Google Cloud.

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

1. Selecione a guia Salvos.

1. Selecione Mais opções e selecione Editar ou selecione a consulta diretamente.

2. Preencha a caixa de diálogo Editar consulta.

   Por exemplo, para compartilhar uma consulta com outros membros, ative Compartilhar com o projeto e depois clicar em Atualizar consulta.

Ver consultas salvas

Você pode ver as consultas particulares e as que foram compartilhadas com outros membros no projeto do Google Cloud na guia Salvos:

Console

1. No console do Google Cloud, acesse a página Análise de registros:

   Acessar a Análise de registros

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

2. Selecione o projeto do Google Cloud ou outro projeto do Google Cloud recurso para o qual você quer exibir registros.

3. Clique em Todos.

4. Classifique a coluna Visibilidade.

A coluna Visibilidade indica se e como as consultas são compartilhadas:

A coluna Visibilidade indica se as consultas estão compartilhadas:

• Compartilhada: consultas que são compartilhadas com outros membros do projeto do Google Cloud.
• Particular: consultas que você salvou e que só estão visíveis para você.

API

É possível usar a API Logging para acessar dados as consultas usando o método savedQueries.list.

Por exemplo, o corpo da solicitação a seguir lista todas as Análises de registros compartilhadas. consultas com um ID de local curinga:

{
"parent": "name": projects/PROJECT_ID/locations/-
    "visibility": "SHARED"
    "filter": "explorer"
}

Usar consultas sugeridas

O Logging gera consultas sugeridas com base no contexto da sua projeto do Google Cloud, como os produtos do Google Cloud que você está usando. As consultas sugeridas podem ajudar a identificar problemas e fornecer insights sobre a integridade geral dos sistemas. Por exemplo, detectar que você está usando o Google Kubernetes Engine, o Logging pode sugerir uma consulta todos os registros de erros dos contêineres.

Para visualizar e executar consultas sugeridas, selecione a guia Sugestões no Painel Consulta. A guia Suggested mostra uma lista de consultas, cada uma com descrições e as seguintes opções:

• Stream: para executar a consulta e transmitir os resultados, escolha esta opção. é a melhor opção.
• Executar: para executar a consulta, escolha esta opção.

• Mais opções: Permite exibir os detalhes da expressão de consulta com as opções para executar o a consulta ou salvá-la. Também é possível selecionar a consulta diretamente para ver essas opções.

  Para revisar os detalhes de uma consulta sugerida, siga um destes procedimentos:

  • Selecione a linha da consulta.

  • Clique em Mais. e selecione Visualizar. A caixa de diálogo Detalhes da consulta é aberta.

  Na caixa de diálogo Detalhes da consulta, você vê a consulta e as opções para Executar, Transmitir ou Salvar como:

  • Para salvar a consulta, faça o seguinte:

    1. Clique em Salvar como.
    2. Preencha os campos na caixa de diálogo Salvar consulta.

    A consulta editada aparece na sua lista Salvas, onde você pode escolher executar a consulta mais tarde.

  • Para executar a consulta agora, clique em Executar. A consulta é executada e aparece query-editor.

  • Para executar a consulta agora e transmitir os resultados, clique em Fazer streaming.

  • Para fechar a caixa de diálogo e retornar à lista de consultas sugeridas, clique em Fechar.

Observe os seguintes comportamentos esperados:

• Os carregamentos de página sucessivos podem não mostrar as mesmas consultas na mesma ordem.
• Talvez você não veja nenhuma sugestão de consulta.
• Às vezes, a execução de uma consulta sugerida não retorna nenhum registro.

Selecionar consultas da biblioteca

O Logging oferece uma biblioteca de consultas baseadas em e produtos do Google Cloud. Essas consultas podem ajudar você de forma eficiente encontre registros durante sessões críticas de solução de problemas e analise seus registros para entender melhor quais dados de registro estão disponíveis.

Para visualizar e executar as consultas da biblioteca, faça o seguinte:

1. Selecione a guia Biblioteca no painel Consulta.

2. Na coluna Todas as consultas, aparecem categorias amplas de consultas consultas e subconjuntos de consultas com base nos produtos do Google Cloud. Para restringir a seleção de consultas exibidas, clique em um dos produtos.

   Você também pode usar o campo de pesquisa para buscar as consultas disponíveis por a categoria, a descrição ou o conteúdo da expressão de consulta.

3. Para revisar uma expressão de consulta, siga um destes procedimentos:

   a. Clique na linha da consulta.

   b. Clique em Mais e selecione Ver.

4. Na caixa de diálogo Detalhes da consulta, você vê a consulta e as opções para Executar, Fazer streaming ou Salvar como:

   • Para salvar a consulta, faça o seguinte:

     1. Clique em Salvar como.
     2. Preencha os campos na caixa de diálogo Salvar consulta.

     A consulta editada aparece na sua lista Salvas, onde você pode escolher executar a consulta mais tarde.

   • Para executar a consulta agora, clique em Executar. A consulta é executada e aparece query-editor.

   • Para executar a consulta agora e transmitir os resultados, clique em Fazer streaming.

   • Para fechar a caixa de diálogo e retornar à lista de consultas sugeridas, clique em Fechar.

A seguir

• Exemplos de consultas