Ver registros usando o Explorador de registros

Neste documento, apresentamos uma visão geral da Análise de registros no console do Google Cloud, que pode ser usada para recuperar, visualizar e analisar entradas de registro armazenadas em buckets de registros. Visualizar e analisar entradas de registro individuais e uma sequência de entradas de registro podem ajudar a solucionar problemas. Também é possível ler dados de registro usando a API Logging e a Google Cloud CLI.

Para realizar operações agregadas nas entradas de registro, como a contagem do número de entradas de registro que contêm um padrão específico, faça upgrade do bucket de registros para usar a análise de registros e execute consultas na página Análise de registros do console do Google Cloud. É possível continuar usando a Análise de registros para visualizar registros em buckets que foram atualizados para usar a Análise de dados de registros. Para mais informações, consulte Visão geral da Análise de dados de registros.

Antes de começar

Para receber as permissões necessárias para visualizar as entradas de registro, peça ao administrador para conceder a você os seguintes papéis do IAM:

• Para visualizar as entradas de registro no bucket _Required e as que estão na visualização _Default no bucket _Default: Visualizador de registros (roles/logging.viewer) no projeto.
• Para visualizar as entradas de registro nos buckets _Required e _Default: Visualizador de registros particulares (roles/logging.privateLogViewer) no projeto.
• Para exibir as entradas de registro armazenadas em uma visualização de registro em um bucket de registros: Acesso de visualização de registros (roles/logging.viewAccessor) no projeto que contém o bucket definido pelo usuário. Para informações sobre como acessar uma visualização de registro específica, consulte Controlar o acesso a uma visualização de registro.
• Para ver campos LogEntry restritos em um bucket: Acesso de campo de registros (roles/logging.fieldAccessor) no projeto. Para mais informações, consulte Configurar o acesso no nível do campo.

Para mais informações sobre como conceder papéis, consulte Gerenciar acesso.

Também é possível receber as permissões necessárias com papéis personalizados ou outros papéis predefinidos.

Começar

Para começar a usar o Explorador de registros, 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 Geração de registros.

2. Selecione o projeto, a pasta ou a organização do Google Cloud.

   Se você usa o Amazon Web Services Elastic Compute Cloud (AWS EC2), suas entradas de registro estão localizadas no projeto de conector da AWS que vincula sua conta da AWS aos serviços do Google Cloud.

Interface do Explorador de registros

Na interface da Análise de registros, é possível exibir entradas de registro, analisá-las e especificar parâmetros de consulta.

Ela contém as seguintes seções, detalhadas nesta página:

1. Barra de ferramentas Ação
2. Painel Consulta
3. Barra de ferramentas de resultados
4. Painel Campos de registro
5. Histograma
6. Painel Resultados da consulta

Barra de ferramentas Ação

Com os recursos da barra de ferramentas Ação, você pode fazer o seguinte:

• Refinar escopo: configure quais entradas de registro são buscadas em buckets de registros para exibição. As consultas que você escreve filtram as entradas de registro buscadas. Para mais informações, consulte Refinar escopo.
• Saiba mais: veja links para documentação e tópicos relevantes.
• Compartilhar link: crie um URL encurtado da consulta e copie-o para a área de transferência, facilitando o compartilhamento de uma consulta. O URL copiado tem o período absoluto correspondente representado pelo período da sua consulta, por exemplo, 7:49:37 PM - 8:49:37 PM.

Observação: se os dados forem gerenciados por um ambiente do Assured Workloads, esse recurso poderá ser afetado ou restrito. Para mais informações, consulte Restrições e limitações no Assured Workloads.

Refinar escopo

Quando você abre a página Análise de registros, ela busca as entradas de registro que passam pelos coletores do recurso selecionado e que você tem permissão para visualizar. Para todos os recursos, as entradas de registro buscadas incluem aquelas originadas no recurso. Para projetos do Google Cloud, as entradas de registro buscadas também incluem aquelas que são roteadas para o projeto. Se você inserir uma consulta, a Análise de registros exibirá apenas as entradas de registro buscadas que também correspondem à consulta. Por exemplo, adicionar a consulta severity>=ERROR resulta na exibição listando apenas as entradas de registro com um nível de gravidade de pelo menos ERROR.

Na sessão atual, é possível configurar quais entradas de registro a Análise de registros vai buscar. Por exemplo, ao resolver problemas, talvez você queira examinar as entradas de registro incluídas em uma visualização de registros ou que se originam em um projeto específico do Google Cloud.

Para configurar quais entradas de registro a página Análise de registros vai buscar, faça o seguinte:

1. Na barra de ferramentas Ação, selecione Refinar escopo.

2. Selecione como você quer que a página Análise de registros busque entradas de registro:

   • Para buscar as entradas de registro transmitidas pelos coletores do recurso selecionado, selecione Escopo pelo projeto atual.

     Para todos os recursos, as entradas de registro buscadas incluem aquelas originadas no recurso. Para projetos do Google Cloud, as entradas de registro buscadas também incluíam as roteadas para o projeto.

   • Para buscar entradas de registro por visualização, selecione Escopo por armazenamento e selecione uma ou mais visualizações de registro.

     Para pastas e organizações, o menu de visualizações de registro inclui todas as que armazenam entradas originadas nesses recursos.

     Para projetos do Google Cloud, o menu de visualizações de registro inclui todas as visualizações de registro nos buckets de registro no projeto selecionado. Para selecionar visualizações de registros em buckets de registros armazenados em outro projeto do Google Cloud, clique em Importar projeto, selecione o projeto do Google Cloud e a visualização de registro.

3. Clique em Aplicar.

Painel Consulta

Use os recursos do painel Consulta para fazer o seguinte:

• Guia Consulta: crie e refine consultas usando os seguintes recursos:

  • Seletor de intervalo de tempo: especifique um período para as entradas de registro que você quer visualizar. Para mais informações, consulte Usar o seletor de intervalo de tempo.

  • Caixa de texto de pesquisa: encontre entradas de registro que correspondam aos seus termos ou frases de pesquisa. Veja mais detalhes em Pesquisar texto em campos de registro.

    Observação :o comportamento das pesquisas de texto mudou. Quando você não coloca os termos de pesquisa entre aspas duplas, a função SEARCH é invocada automaticamente.

  • Menus de filtro: crie consultas com base em Recurso, Nome do registro e Gravidade. Para mais informações, consulte Usar menus de filtro.

  • Campo do editor de consultas: crie consultas avançadas usando a linguagem de consulta do Logging. Para detalhes, consulte Criar consultas avançadas.

• Guia Recentes: confira as consultas que você executou recentemente. Para mais informações, consulte Usar consultas recentes.

• Guia Salvas: veja as consultas salvas e aquelas que outros usuários do projeto do Google Cloud compartilharam com você. Para mais informações, consulte Salvar consultas e Compartilhar consultas.

• Guia Suggested: confira as consultas sugeridas com base nos recursos do seu projeto do Google Cloud. Para mais informações, confira Usar consultas sugeridas.

• Guia Biblioteca: confira e execute consultas fornecidas pelo Google com base nos seus casos de uso. Para mais informações, acesse Selecionar consultas da biblioteca.

• Salvar: salva as consultas que podem ser visualizadas e executadas na guia Salvas.

• Limpar consulta: limpe e redefina as seleções feitas ao criar uma consulta no painel Consulta.

• Fazer streaming de registros: visualize as entradas de registro à medida que o Logging as armazena em buckets de registros. Para saber mais, consulte Fazer streaming de registros.

• Executar consulta: execute as consultas depois de criá-las no painel Consulta.

Se você não vir o campo do editor de consultas, ative Mostrar consulta. Se você adicionar termos de pesquisa na caixa de texto de pesquisa, eles também aparecerão no campo do editor de consulta e serão avaliados como parte da expressão de consulta.

Depois de revisar sua consulta, clique em Executar consulta. Os registros que correspondem à sua consulta são listados no painel Resultados da consulta. Os painéis Histograma e Campos de registro também se ajustam de acordo com a expressão de consulta.

Fazer streaming de registros

Você pode fazer streaming de registros à medida que o Logging os armazena em buckets de registros ou pode adicionar uma consulta para transmitir apenas os registros que correspondem à consulta.

Para fazer streaming de registros com base em uma consulta, adicione uma consulta no painel Consulta e selecione Fazer streaming de registros. Como o Logging armazena os dados de registros em buckets de registros, apenas os registros que correspondem à consulta são mostrados no painel Resultados da consulta. Quando uma consulta não é fornecida, o Logging mostra cada entrada de registro conforme ela está armazenada.

Para interromper o streaming, clique em Parar streaming ou role até o painel Resultados da consulta.

Barra de ferramentas de resultados

Na barra de ferramentas Resultados, você tem as seguintes opções:

• Campo de registros: mostre ou oculte o painel Campo de registros do layout da página da Análise de registros. Para mais informações, consulte a seção Painel Campo de registros deste documento.
• Histograma: mostre ou oculte o painel Histograma do layout da página da Análise de registros. Para mais informações, consulte a seção Histograma deste documento.
• Analisar resultados: agregue e crie um gráfico dos resultados da consulta usando a Análise de dados de registros. Esse botão só fica visível se o escopo selecionado contiver um bucket de registros que tenha sido atualizado para usar a Análise de dados de registros. Para mais informações, consulte a seção Analisar resultados deste documento.
• Criar métrica: configure uma métrica com base em registros.
• Criar alerta: configure uma política de alertas com base em registros.
• Ir para momento atual: faça uma atualização forçada dos resultados da consulta para incluir o horário atual. Se o seletor de intervalo de tempo usar um intervalo personalizado e um horário de término for definido, ele executará a consulta com um intervalo padrão de uma hora. Caso contrário, ele será atualizado com a data ou duração de início atual e executará a consulta. A expressão da consulta não é alterada quando você usa esse recurso.
• Mais ações: use essas outras opções para gerenciar políticas de alertas com base em registros ou criar um coletor.

Analise os resultados

É possível agregar, analisar e criar um gráfico com seus dados de registro usando consultas SQL na página Análise de dados de registros quando o projeto contiver buckets de registros que foram atualizados para usar a Análise de dados de registros. Para acessar a página Análise de registros na Análise de registros, na barra de ferramentas Resultados, clique em Analisar resultados.

O botão Analisar resultados só fica visível quando o escopo selecionado contém um bucket de registros que foi atualizado para usar a Análise de dados de registros. Por exemplo, se você selecionou Escopo por escopo de armazenamento usando o botão Refinar escopo, o botão Analisar resultados será exibido quando pelo menos um bucket no escopo de armazenamento for atualizado para usar a Análise de dados de registros. Para mais informações, consulte Fazer upgrade de um bucket de registros para usar a Análise de dados de registros.

Veja a seguir o que acontece quando você clica em Analisar resultados:

• O período na Análise de registros pode ser ajustado automaticamente para que haja dados de registro significativos na página Análise de registros.

• A página Análise de dados de registros é aberta em uma nova guia e traduz automaticamente a consulta da linguagem de consulta atual do Logging em uma consulta SQL.

• O escopo selecionado na Análise de registros é convertido em uma cláusula FROM equivalente na consulta SQL:

  • Se você tiver selecionado Escopo pelo projeto atual, as seguintes visualizações serão consultadas:

    • Uma visualização de registro do bucket _Required.

    • Uma visualização de registro do bucket _Default.

    • Todas as visualizações de registro em buckets definidos pelo usuário no projeto atual.

  • Se você selecionou Escopo por armazenamento com uma ou mais visualizações de registro selecionadas, somente os buckets de registro do projeto atual que contêm as visualizações de registro selecionadas serão consultados.

  • Se você selecionou Escopo por armazenamento e especificou uma visualização de registro em um projeto diferente, nenhum bucket de registro será consultado.

  Observação :a Análise de dados de registros não oferece suporte a consultas entre projetos ou regiões. Se o escopo selecionado na Análise de registros contiver registros armazenados em vários projetos ou regiões, os registros exibidos na página Análise de registros poderão ser diferentes.

Na página Análise de dados de registros, é possível ver os resultados em formato tabular ou gráfico. Na guia Gráfico, é possível selecionar os dados apresentados, personalizar a configuração do gráfico ou salvar um gráfico em um painel personalizado. Para informações sobre como criar gráficos com base nos resultados da sua consulta e salvar gráficos em um painel personalizado, consulte Resultados da consulta de gráficos com a Análise de dados de registros.

Para informações sobre como usar SQL para escrever consultas, consulte Consultar e visualizar registros na Análise de dados de registros.

Painel Campos de registro

O painel Campos de registro oferece um resumo de alto nível dos dados dos registros e uma maneira eficiente de refinar uma consulta. O painel mostra as entradas de registro divididas por dimensões diferentes, correspondentes aos campos delas.

Depois de executar a consulta no campo do editor de consultas, o painel Campos de registro será preenchido com base nos resultados. Esse painel exibe as contagens de entradas de registro para cada dimensão compatível. Para cada dimensão, você pode fazer uma seleção. As seguintes dimensões estão sempre disponíveis:

• Tipo de recurso

  Se você usa o BindPlane para gravar registros locais e de nuvem híbrida, selecione o tipo de recurso Nó genérico.

• Gravidade

  Se você quiser que sua consulta filtre por vários níveis de gravidade, use o menu Gravidade.

Talvez você veja uma dimensão Serviço:

• Se você tiver registros com um tipo de recurso que seja Contêiner do Kubernetes e se não tiver filtrado os registros por tipo de recurso, o menu Serviço será preenchido. As entradas nesse menu são determinadas dinamicamente pelos valores do rótulo k8s-pod/app do recurso.

  Por exemplo, se uma entrada de registro semelhante à seguinte for exibida como resultado da sua consulta, o menu de serviço incluirá o serviço chamado myservice:

  {
   ...
   labels: {
       compute.googleapis.com/resource_name: "mycluster1"
       k8s-pod/app: "myservice"
       k8s-pod/pod-template-hash: "5ffcd94fdd"
    }
    logName: "projects/my-project/logs/stdout"
    resource: {
       labels: {6}
       type: "k8s_container"
    }
    ...
  }
  

• Se você filtrar pelo tipo de recurso Recurso auditado, o menu Serviço será preenchido. As entradas nesse menu são determinadas dinamicamente pelos valores do rótulo service do recurso.

Outras dimensões, como ID do projeto, são listadas com base nas suas seleções. Por exemplo, a dimensão ID do projeto é listada quando a consulta restringe as entradas de registro àquelas com o tipo de recurso Kubernetes Container ou quando você seleciona Escopo por armazenamento.

Refine a consulta

Para refinar a consulta, selecione um valor no painel Campos de registro. Por exemplo, se você selecionar Erro no título Gravidade, o painel de consulta será atualizado para incluir severity=ERROR.

A captura de tela a seguir ilustra o campo do editor de consultas depois que uma gravidade e um tipo de recurso são selecionados usando o painel Campos de registro:

Para remover uma seleção, clique em Limpar X.

Adicionar campos no painel Campos de registro

É possível adicionar determinados pares de chave-valor LogEntry ao painel Campo de registro nas entradas de registro preenchidas no painel Resultados da consulta. Por exemplo, se você costuma filtrar pelo valor do campo jsonPayload.message, adicione-o ao painel Campo de registros.

Para adicionar um campo ao painel Campo de registros, faça o seguinte:

1. No painel Resultados da consulta, expanda uma entrada de registro clicando em Expandir.

2. Selecione o valor de um campo. No menu, selecione Adicionar campo ao painel Campos de registro.

   O campo personalizado aparece no painel Campos de registro como uma lista de pares de chave-valor.

Para remover um campo personalizado do painel Campos de registro, clique em Remover ao lado do campo.

Os seguintes tipos de campo não podem ser adicionados ao painel Campos de registro:

• Campos relacionados ao tempo, por exemplo, receiveTimestamp e protoPayload.startTime.
• Campos com alta cardinalidade, por exemplo, insertId e protoPayload.latency.
• Campos com índices de matriz no caminho, por exemplo, protoPayload.authorizationInfo[0].resource.

Histograma

Observação: cada elemento do histograma exibe o número aproximado de entradas de registro recebidas no intervalo de tempo associado ao elemento. Para ter uma contagem exata do número de entradas de registro recebidas em um intervalo de tempo, use a Análise de dados de registros ou copie os registros para um bucket do Cloud Storage.

No painel Histograma, é possível visualizar a distribuição de registros ao longo do tempo. O histograma é gerado novamente quando você executa uma consulta, o que facilita a visualização de tendências nos dados de registros e a solução de problemas.

Para mostrar ou ocultar o painel Histograma, clique em Histograma na barra de ferramentas Resultados.

Recursos de Histograma

1. Barras do histograma: cada barra do histograma representa um intervalo de tempo. Cada barra contém um detalhamento de três cores para os níveis de gravidade de registro capturados no intervalo de tempo de cada barra. As cores representam as seguintes gravidades de registro:

   • Azul: gravidade baixa, como Padrão, Depurar, Informações e Aviso.
   • Amarelo: gravidade média, como Aviso.
   • Vermelho: gravidade alta, como Erro, Crítico, Alerta e Emergência.

   Cada barra de histograma apresenta um menu com opções para analisar os registros.

2. Controles de tempo: permitem ajustar o intervalo de tempo dos registros que você vê no painel Resultados da consulta. Para detalhes sobre essas opções, consulte Analisar registros usando controles de tempo.

3. Linha do tempo: mostra o intervalo de tempo dos registros, representado por barras de histograma, exibidos no painel Resultados da consulta. A linha do tempo ajuda a se orientar para os registros que você está visualizando dentro do maior intervalo de tempo da sua consulta.

Analisar registros usando controles de tempo

Use os controles de tempo do histograma para investigar e analisar os dados dos registros.

Dica: quando você ajusta os controles de tempo do histograma, os dados de registros nos painéis Resultados da consulta e Campos de registro são ajustados de acordo com o intervalo de tempo capturado pela linha do tempo do histograma. Ajustar os controles de tempo do histograma não altera a expressão de consulta no painel Consulta.

Ajustar o horário rapidamente

O histograma fornece controles de tempo que permitem ajustar rapidamente os dados que exibidos no Explorador de registros.

• Controles de tempo: arraste os controles da linha do tempo para dentro para restringir os dados ou para fora se quiser ampliar os dados na linha do tempo do histograma Clique em Executar.

• Deslizar a linha do tempo para frente e para trás: clique na seta para frente para deslizar a linha do tempo para um momento posterior. Clique em seta para trás se quiser deslizar a linha do tempo para um momento anterior.

• Aumentar e diminuir o zoom: clique em Zoom para ampliar os dados mostrados na linha do tempo. Clique em Aumentar zoom para restringir os dados mostrados na linha do tempo.

As modificações na linha do tempo são restritas pelo horário atual ("agora") e 30 dias atrás.

Explorar intervalo ou Restringir à data/hora

Além dos controles de tempo listados anteriormente, o histograma fornece os recursos Rolar até o momento e Zoom até o momento para oferecer um controle mais aprofundado do histograma e dos dados que você vê em outros painéis da Análise de registros.

É possível que você tenha interesse em ver uma determinada barra do histograma por causa do tamanho ou dos níveis de gravidade relacionados. Selecione essa barra do histograma para ajustar os dados de registros exibidos no Explorador de registros.

Use o recurso Rolar até o momento para navegar pelos dados de registro sem alterar os valores nos painéis Histograma e Campos de registro. Quando você seleciona o recurso Explorar intervalo, acontece o seguinte:

• Os dados de registros que você vê no painel Resultados da consulta se ajustam de acordo com o intervalo de tempo capturado pela barra de histograma selecionada.

  A consulta não é executada, mas pode ocorrer uma atualização parcial dos dados para garantir que os registros do painel Resultados da consulta correspondam ao intervalo de tempo da barra de histograma selecionada.

• O URL do console é atualizado para incluir o timestamp do registro mais recente capturado pelo intervalo de tempo da barra de histograma selecionada.

Para selecionar o recurso Explorar intervalo, faça o seguinte:

1. Mantenha o ponteiro do mouse sobre uma barra na linha do tempo do histograma. Será exibido um painel com informações resumidas sobre os dados de registros do período especificado.

2. No painel, selecione Explorar intervalo.

   Como alternativa, clicar em uma barra de histograma é equivalente a selecionar Role até o momento.

O recurso Restringir à data/hora é semelhante à função Explorar intervalo, mas executa uma consulta nos dados de registros com base no período capturado por um histograma selecionado. Quando você seleciona o recurso Restringir à data/hora, acontece o seguinte:

• Os dados de registros que você vê no painel Resultados da consulta são recarregados e restritos de acordo com o intervalo de tempo capturado pela barra de histograma selecionada.
• O URL do console é atualizado para incluir o timestamp do registro mais recente capturado pelo intervalo de tempo da barra de histograma selecionada.
• O histograma muda para mostrar somente os registros que têm umtimestamp valor que se enquadra no período da barra de histograma selecionada pela barra de histograma selecionada.
• Os dados no painel Campos de registro se ajustam de acordo com o intervalo de tempo capturado pela barra de histograma selecionada.

Para selecionar o recurso Restringir à data/hora, faça o seguinte:

1. Mantenha o ponteiro do mouse sobre uma barra na linha do tempo do Histograma. Será exibido um painel com informações resumidas sobre os dados de registros do período especificado.

2. No painel, selecione Restringir à data/hora.

Resultados da consulta

Para ver os resultados das suas consultas, use o painel Resultados da consulta. Para solucionar problemas dos aplicativos, visualize os detalhes de entradas de registro individuais e agrupe e analise essas entradas para encontrar padrões.

Configure a coluna Data/hora.

A coluna Hora no painel Resultados da consulta exibe os carimbos de data/hora das entradas de registro. É possível personalizar a coluna Data/hora para que apenas algumas partes do carimbo de data/hora fiquem visíveis. Isso cria mais espaço horizontal para você conferir mais informações na entrada de registro.

Para selecionar quais partes do carimbo de data/hora serão exibidas, clique no menu Outras opções de tempo na coluna Hora e selecione uma das seguintes opções:

• Data, hora e fuso horário

• Data e hora (padrão)

• Somente horário

Encontrar padrões nos registros usando campos de resumo

Suponha que você esteja analisando as entradas de registro nos resultados da consulta e queira folhear rapidamente os resultados em um determinado campo LogEntry. Ou então, talvez você queira agrupar suas entradas de registro por um determinado par de campo-valor. É possível adicionar campos de resumo aos resultados, que aparecem como ícones no início de cada linha de entrada de registro. Por exemplo, a imagem a seguir mostra os resultados da consulta com o campo de resumo resource.type adicionado a cada linha de entrada de registro:

A Análise de registros tem campos de resumo padrão e personalizados. Os campos de resumo padrão dependem dos resultados da consulta atual. Já os campos de resumo personalizados permitem selecionar qualquer campo no LogEntry.

Para ocultar os campos de resumo nos resultados da consulta, use o botão de alternância Campos de resumo. Quando essa opção está ativada, os resultados são mostrados no formato de texto bruto. Por padrão, o conteúdo de cada entrada de registro é truncado para caber em uma linha. Para mostrar até 10 linhas para cada entrada de registro, use o botão de alternância Unir linhas. Os espaços em branco são preservados em cada entrada de registro.

Para ocultar campos de resumo específicos, ative os Campos de resumo e clique em Ocultar campo de resumo.

Para modificar os campos de resumo, faça o seguinte:

1. Clique no botão Editar na coluna Resumo para abrir o menu de edição.

   

2. Na caixa de diálogo Gerenciar campos de resumo, é possível fazer o seguinte:

   • Adicione qualquer nome de campo personalizado aos Campos de resumo personalizados.

     A seleção do campo de resumo tem os seguintes recursos:

     • Preencha automaticamente usando os registros exibidos nos resultados da consulta.
     • Correção de campo para caracteres aceitos entre aspas.

     Por exemplo, se você digitar jsonPayload.id-field, ele será alterado para jsonPayload."id-field".

     Também é possível selecionar qualquer campo LogEntry, seja ele sugerido ou não com a função de preenchimento automático.

     Para remover um campo de resumo personalizado, clique no X no ícone dele.

   • Ative e desative o truncamento nos campos de resumo personalizados.

     Para reduzir a exibição dos valores do campo de resumo, use o botão ao lado de Truncar campos de resumo personalizados. Você pode escolher quantos caracteres serão exibidos antes de o campo ficar truncado e se o início ou o fim do campo será exibido.

     Dica :para mostrar o valor completo de um campo de resumo, mantenha o ponteiro sobre um campo de resumo truncado nos resultados da consulta.

   • Ocultar ou mostrar campos de resumo padrão:

     Para personalizar quais campos de resumo padrão serão exibidos nos resultados da consulta, expanda o menu Ocultar ou mostrar campos de resumo padrão.

3. Clique em Aplicar.

   Os campos de resumo agora estão atualizados nos resultados da consulta.

Pesquisar os resultados da consulta

Para pesquisar o conteúdo dos Resultados da consulta, clique em Encontrar nos resultados no painel Resultados da consulta e digite o termo de pesquisa. Com esse filtro, é possível encontrar informações nas entradas de registro sem criar uma nova consulta.

Os termos que correspondem aos critérios de pesquisa são destacados nas entradas de registro no painel Resultados da consulta:

Ver entradas de registro semelhantes

É possível visualizar entradas de registro semelhantes a uma entrada de registro selecionada, o que permite se concentrar nos registros de interesse.

Para mostrar entradas de registro semelhantes, faça o seguinte:

1. No painel Resultados da consulta, em uma entrada de registro, clique em Expandir.

2. Clique em Entradas semelhantes e selecione Mostrar entradas semelhantes.

   A consulta é atualizada com uma consulta semelhante à seguinte e recarrega os resultados:

   --Show similar entries
   protoPayload.methodName="io.k8s.core.v1.configmaps.update"
   --End of show similar entries
   

Para visualizar as entradas de registro semelhantes, faça o seguinte:

1. No painel Resultados da consulta, em uma entrada de registro, clique em Expandir.

2. Expanda o menu Entradas semelhantes e selecione Visualizar entradas semelhantes.

   Uma caixa de diálogo separada é aberta com as seguintes informações:

   • O padrão encontrado
   • A porcentagem de entradas de registro que contêm o padrão
   • Exemplos de entradas de registro que contêm o padrão

   Nessa caixa de diálogo, é possível ocultar ou mostrar as entradas de registro:

   

Ocultar entradas de registro semelhantes

É possível ocultar entradas de registro semelhantes, o que permite remover registros dos resultados da consulta.

Há duas maneiras de ocultar entradas de registro semelhantes:

• Oculte grandes quantidades de entradas de registro agrupadas automaticamente. Quando você executa uma consulta, os resultados dela são analisados em busca de padrões, e as entradas de registro são automaticamente agrupadas com base no conteúdo de campo de registro semelhante. Se um padrão significativo for detectado, um banner será exibido no painel Resultados da consulta mostrando a porcentagem de resultados que podem ser ocultados:

  

  Ocultar entradas semelhantes: esse botão adiciona uma cláusula à consulta e recarrega os resultados dela.

  Visualizar: uma janela separada é aberta descrevendo o padrão encontrado e mostra exemplos das entradas.

  Quando você oculta registros semelhantes, nenhuma informação é salva fora da sessão da Análise de registros, e cada consulta produz uma nova análise com base apenas nos registros mostrados. Cada consulta analisa partes distintas das entradas de registro, dependendo dos tipos de registros retornados.

• Oculte entradas de registro semelhantes a uma entrada de registro específica. Para ocultar entradas de registro semelhantes a uma entrada de registro, faça o seguinte:

  1. Na entrada de registro, clique em Expandir, clique no menu Entradas semelhantes e selecione Ocultar entradas semelhantes.

     A consulta é atualizada, e o painel Resultados da consulta é recarregado. As entradas de entrada de registro semelhantes à selecionada não são exibidas.

Exibir ou ocultar entradas de registro que correspondem a um campo

É possível exibir ou ocultar entradas de registro que correspondem a um campo em uma entrada de registro. Assim, você se concentra nas entradas que têm o mesmo conteúdo de campo.

Para exibir ou ocultar entradas de registro que correspondam a um campo específico em uma entrada de registro, faça o seguinte:

1. No painel Resultados da consulta, na entrada de registro, clique em Expandir.

2. Clique no valor de um campo na entrada de registro, como compute.googleapis.com, que é um serviceName.

   Você verá o seguinte menu:

   

3. Selecione Mostrar entradas correspondentes ou Ocultar entradas correspondentes.

   A consulta é atualizada com uma consulta que mostra ou oculta entradas semelhantes, e os resultados da consulta são atualizados com novos resultados.

Fixar entradas de registro

Depois de executar uma consulta, você pode fixar uma entrada de registro para destacá-la. A entrada de registro fixada permanece centralizada no painel Resultados da consulta. Se você executar uma nova consulta e a entrada de registro fixada não estiver incluída, será solicitado que você libere a entrada de registro.

Para fixar uma entrada de registro, faça o seguinte:

1. Mantenha o ponteiro do mouse sobre a entrada de registro que você quer fixar.
2. Clique em Marcar.

Depois de fixar uma entrada de registro, o plano de fundo dela fica escurecido, e um ícone Pin é exibido. Um ícone de fixação também aparece no painel Histograma com base no timestamp da entrada de registro fixada:

Para liberar uma entrada de registro, clique no ícone de fixação novamente.

Mostrar registros que correspondem ao recurso de uma entrada de registro fixada

Depois de fixar uma entrada de registro, é possível executar uma nova consulta que exibe entradas de registro que correspondem ao tipo de recurso ou aos rótulos de recurso do registro fixado.

Para fixar uma entrada de registro e exibir entradas que correspondam ao mesmo tipo ou rótulo de recurso, faça o seguinte:

1. Clique na seta para baixo ao lado do registro fixado para expandir o menu de fixação.

2. Escolha uma opção no menu "Fixar":

   • Para executar novamente a consulta com o mesmo resource.type do registro fixado, selecione Same resource.type.

     Por exemplo, suponha que você fixe uma entrada de registro com um resource.type de k8s_node. Se você selecionar Same resource.type, a consulta será executada novamente para exibir todas as entradas de registro com resource.type="k8s_node".

   • Para executar novamente a consulta com o mesmo resource.labels do registro fixado, selecione Same resource.labels.

   • Para executar novamente a consulta com o mesmo trace do registro fixado, selecione Mesmo trace.
   • Para limpar a consulta e mostrar todas as entradas de registro, selecione Mostrar tudo.

Visualizar uma entrada de registro fixada no painel Histograma

É possível usar o painel Histograma para destacar, rolar e examinar uma entrada de registro fixada.

No painel Histograma, clique em Fixar e escolha uma das seguintes opções de menu:

• Rolar até a entrada de registro: coloque a entrada de registro no painel atual Resultados da consulta e visualize a entrada de registro fixada no contexto de registros próximos.
• Aplicar zoom à entrada de registro: restrinja o intervalo de tempo exibido pelo painel Histograma e refine sua consulta para isolar os registros próximos ao registro fixado.

Visualizar dados de trace

Quando uma entrada de registro contém o campo relacionado a latência e trace, os ícones de latência e trace são exibidos.

Quando uma entrada de registro contém apenas o campo trace, somente o ícone de trace é exibido.

Para visualizar os dados de trace relacionados à entrada de registro, clique no ícone de trace. Você tem as seguintes opções:

• Visualizar detalhes do trace: mostra o período pai e os traces filhos, além de detalhes sobre o trace. Para ver mais detalhes sobre o trace, clique em Ver no Trace para navegar até ele. Para mais informações sobre o conteúdo no painel de detalhes, consulte Encontrar e explorar traces.

Observação: a opção Visualizar detalhes do trace só vai estar disponível se traceSampled for verdadeiro.

• Mostrar todos os registros deste trace: refina e executa a consulta adicionando o campo trace definido ao identificador do trace associado à entrada de registro.

• Mostrar apenas solicitações rastreadas: refina e executa a consulta adicionando o campo traceSampled definido como True. Para mais informações sobre amostragem, consulte Taxa de amostragem.

Copiar um link em uma entrada de registro

Para compartilhar um link em um registro, expanda uma entrada de registro e selecione Copiar link. O link será copiado para a área de transferência. É possível enviar o link aos usuários que têm acesso ao projeto do Google Cloud. Quando um usuário cola o link em um navegador ou o seleciona, o Logging fixa a entrada de registro no painel Resultados da consulta.

Download de registros

Observação :esse recurso não é compatível com o download em massa de entradas de registro. É possível fazer o download de até 10.000 entradas de registro, desde que o tempo para consultar os registros e realizar o download possa ser concluído dentro do tempo limite do comando. É possível copiar registros em massa para um bucket do Cloud Storage.

É possível fazer o download dos registros no formato CSV ou JSON. Você precisa de um dos seguintes papéis do Identity and Access Management para fazer o download de registros:

• Administrador do Logging (roles/logging.admin)
• Acessador de visualização de registros (roles/logging.viewAccessor)

Para fazer o download dos registros, siga estas etapas:

1. Clique em Fazer o download na barra de ferramentas do painel Resultados da consulta.

2. Na caixa de diálogo Fazer o download de registros, selecione o formato CSV ou JSON e clique em Fazer o download.

3. Selecione o que fazer com os dados do registro. Você tem as seguintes opções:

   • Fazer o download dos dados para o computador.
   • Fazer o download dos dados para o Google Drive.
   • Ver os dados em uma nova guia.

   Ao salvar um CSV e selecionar o Google Drive, você pode abrir o arquivo no Planilhas Google.

Para informações sobre solução de problemas, consulte Falha no download de registros.

Exemplo de consultas

Para consultas sugeridas, organizadas por produto e caso de uso do Google Cloud, consulte Exemplos de consultas usando a Análise de registros. Por exemplo, é possível executar consultas relacionadas ao Kubernetes para encontrar registros do Google Kubernetes Engine.

Ver registros do Compute Engine

Para determinados tipos de recursos do Compute Engine, como gce_instance e gce_network, você vê o nome do recurso com o ID do recurso como subtexto em vários locais na Análise de registros. Por exemplo, para o tipo de recurso gce_instance, o nome da VM é mostrado ao lado do ID da VM. Os nomes dos recursos ajudam a identificar o ID correto do recurso em que é possível criar consultas.

Você pode encontrar nomes de recursos do Compute Engine nos seguintes locais:

• Menus de filtro do painel Consulta: os tipos de recursos do Compute Engine mostram nomes de recursos, com os IDs de recursos correspondentes como subtexto.
• Campos de registro: os tipos de recursos do Compute Engine mostram o nome do recurso, em vez do ID, nas dimensões do campo.
• Resultados da consulta: para registros de instâncias de VM do Compute Engine, o campo resource.labels mostra metadados com o nome de recurso correspondente.
• Campos de resumo: para registros de instâncias de VMs do Compute Engine, o ícone mostra o nome do recurso em vez do ID.

Resolver problemas

Nesta seção, fornecemos instruções para solucionar problemas comuns ao usar o Explorador de registros.

Se você tiver problemas ao tentar visualizar registros em destinos de coletor, consulte Resolver problemas de roteamento e coletores.

Falha no download de registros

Você está usando a Análise de registros e clique em Fazer o download. O comando é iniciado, mas não é concluído ou informa um erro.

Para resolver esse problema, reduza o tempo de execução do comando tentando fazer o seguinte:

• Na caixa de diálogo Fazer o download de registros, reduza o valor do Máximo de entradas de registro.
• Reduza o período em que os registros são consultados.
• Na barra de ferramentas de resultados da consulta, clique em Ocultar entradas semelhantes antes de iniciar o download.
• Modifique sua consulta para usar campos indexados.

Observação: o recurso de download não se destina ao download em massa de registros. É possível copiar registros para um bucket do Cloud Storage.

Não foi possível encontrar os registros do console em uma instância de VM

Os registros gravados no console de uma instância do Compute Engine podem não estar disponíveis na Análise de registros. Para ver esses registros, faça o seguinte:

1. No Console do Google Cloud, acesse a página Instâncias de VM.

   Acessar Instâncias de VM

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

2. Selecione a instância e depois a Porta serial 1 (console) na seção Registros da página.

É possível configurar as instâncias de modo que a saída da porta serial seja enviada para o Cloud Logging. Para mais informações, consulte Como ativar e desativar a geração de registros de saída da porta serial.

Receber projeto do Google Cloud ou ID da organização

Para conseguir um projeto do Google Cloud ou um ID da organização em qualquer lugar no console do Google Cloud, expanda a lista de projetos do Google Cloud no seletor de projetos e organizações do Google Cloud e encontre o ID do projeto do Google Cloud na coluna ID.

Não é possível ver as entradas de registro

Se nenhuma entrada de registro for exibida, verifique o seguinte:

• O projeto correto do Google Cloud está selecionado? Caso contrário, escolha o projeto correto do Google Cloud no projeto do Google Cloud e no seletor de organização.

• Seu projeto do Google Cloud está usando recursos que geram registros e há atividade nesses recursos? Mesmo que o projeto do Google Cloud seja novo, ele precisa ter registros de auditoria que registrem o fato de ter sido criado. Verifique se você está usando um recurso que gera registros acessando a seção Como mapear serviços para tipos de recursos na página Lista de recursos monitorados.

• O intervalo de tempo é muito limitado? Verifique se o período em sua consulta está correto.

• Visualize suas consultas de exclusão atuais para garantir que os registros que você está procurando não sejam excluídos acidentalmente.

• O escopo correto está sendo usado para acessar os registros? Para instruções sobre como ajustar o escopo da sua pesquisa, consulte Refinar escopo.

Minha consulta está correta, mas ainda não vejo as entradas de registro

• Não é possível ver entradas de registro anteriores ao período de armazenamento do Logging. Para o período de armazenamento de registros ativo, veja esta página.

• Durante períodos de muita atividade, pode haver um tempo de espera no envio de registros para o Logging ou no recebimento e exibição dos registros.

• O Explorador de registros não mostra as entradas de registro que têm carimbo de data/hora no futuro até que esses momentos cheguem. Essa é uma situação incomum causada provavelmente por um desvio no tempo do aplicativo que envia os registros.

• O escopo da consulta foi amplo demais e não foi possível concluí-la em um tempo razoável. Talvez seja exibida a mensagem "O prazo expirou antes que a operação fosse concluída". Tente fazer uma consulta mais específica ou reduza o intervalo de tempo.

A consulta retorna um erro

Se você emitir uma consulta em um recurso sem especificar um bucket, o Cloud Logging usará o histórico dos coletores no projeto do Google Cloud para determinar onde as entradas podem ter sido gravadas para esse recurso. Se o Cloud Logging identificar mais de 200 buckets em que as entradas podem ter sido gravadas, a consulta falhará com a mensagem Error: Invalid query.

Para resolver esse problema, refine o escopo da consulta para um subconjunto do armazenamento. Para mais informações, consulte Refinar o escopo.

O período dos resultados da consulta não corresponde à consulta

Os dados de registros que você vê nos painéis Resultados da consulta e Campos de registro se ajustam de acordo com o intervalo de tempo capturado pela linha do tempo do histograma. Ajuste a linha do tempo do histograma usando os controles de tempo ou o seletor de intervalo de tempo. O ajuste desses controles de tempo não altera a expressão de consulta no painel Consulta.

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.

Receber suporte

Para mais informações sobre como receber suporte, consulte a página de suporte de observabilidade do Google Cloud.