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 dados de registros. Com a Análise de registros, é possível encontrar e visualizar seus registros para solucionar problemas. Também é possível ler registros usando a API Logging e a Google Cloud CLI.

Cada elemento do histograma exibe o número aproximado de entradas de registro recebidas no intervalo de tempo associado ao elemento. Para ver 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 registros para um bucket do Cloud Storage.

Para executar operações de agregação nas entradas de registro, como contar o 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, em seguida, execute consultas na página Análise de registros. É possível continuar usando a Análise de registros para visualizar registros em buckets que receberam upgrade para usar a Análise de registros. Para mais informações, consulte Visão geral da análise de registros.

Começar

Para ter as permissões necessárias para visualizar os registros na Análise de registros, peça ao administrador para conceder a você os seguintes papéis do IAM:

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

Também é possível conseguir as permissões necessárias por meio de papéis personalizados ou de outros papéis predefinidos.

Para começar a usar o Explorador de registros, faça o seguinte:

  1. No painel de navegação do console do Google Cloud, selecione Logging e clique em Análise de registros:

    Acessar a Análise de registros

  2. Selecione o projeto do Google Cloud apropriado.

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

Interface do Explorador de registros

A interface do Explorador de registros permite recuperar registros, analisar dados de registros e refinar os parâmetros de consulta.

Interface do usuário do Explorador de registros

A Análise de registros contém as seguintes seções, que são detalhadas nesta página:

  1. Barra de ferramentas Ação
  2. Painel Consulta
  3. Barra de ferramentas 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: defina o escopo da sua pesquisa por registros apenas no projeto atual do Google Cloud ou por uma ou mais visualizações de armazenamento. Para mais informações sobre o escopo, consulte Refinar escopo.
  • Saiba mais: confira links para documentos e tópicos relevantes.
  • Compartilhar link: crie um URL encurtado da consulta atual e copie-o para a área de transferência, facilitando o compartilhamento da consulta. O URL copiado tem o intervalo de tempo absoluto correspondente representado pelo período atual da sua consulta. Por exemplo, 7:49:37 PM - 8:49:37 PM.

Refinar escopo

Se os registros estiverem armazenados em buckets, é possível visualizá-los na Análise de registros. Dependendo do projeto selecionado, talvez seja necessário ajustar o escopo da Análise de registros para visualizar os registros armazenados em determinados buckets de registros.

Por padrão, a Análise de registros exibe todos os registros gerados por recursos no projeto atual ou roteados diretamente para o projeto atual e armazenados em qualquer bucket de registros. Por padrão, a Análise de registros não exibe registros gerados por recursos em outro projeto e roteados para um bucket de registros no projeto atual.

Para personalizar quais registros são exibidos na Análise de registros, use o botão Refinar escopo na barra de ferramentas Ação:

  • Para ver todos os registros gerados ou roteados diretamente para o projeto atual, selecione Escopo pelo projeto atual.

    Um coletor de registros pode rotear os registros para um bucket de registros no projeto atual, para um bucket de registros em um projeto diferente ou para um projeto diferente. Para mais informações, consulte Rotear registros para destinos compatíveis.

  • Para exibir determinados registros armazenados em buckets de registros no projeto atual, selecione Escopo por armazenamento e escolha uma ou mais visualizações de registro. Use essa opção quando você quiser um controle mais granular sobre quem tem acesso a quais registros nos buckets de registro no projeto atual.

    Para mais informações sobre como criar e gerenciar visualizações de registros, consulte Configurar acesso no nível do bucket.

  • Para conferir determinados registros armazenados em buckets de registros que estão em projetos diferentes, selecione Escopo por armazenamento, clique em Importar projeto no seletor de visualização do projeto e de registro e selecione uma ou mais visualizações de registro. Use essa opção se a organização tiver vários projetos, cada um gerando os próprios registros exclusivos, e você quiser visualizá-los juntos na Análise de registros.

    Por exemplo, para exibir todos os registros armazenados em um bucket de registros, selecione a visualização _AllLogs:

    Caixa de diálogo "Refinar escopo" mostrando o seletor de visualização do projeto e do registro.

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 os registros que você quer visualizar. Para mais informações, consulte Usar o seletor de período.

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

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

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

  • Guia Recentes: confira as consultas executadas recentemente. Para mais informações, consulte Usar consultas recentes.

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

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

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

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

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

  • Fazer streaming de registros: visualize as entradas de registro conforme 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 o campo "Editor de consultas" não aparecer, 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 consultas e serão avaliados como parte da sua 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 são ajustados de acordo com a expressão de consulta.

Fazer streaming de registros

É possível fazer streaming de registros à medida que o Logging os armazena em buckets de registros, ou é possível adicionar uma consulta para transmitir somente os registros que correspondem à consulta.

Para transmitir registros com base em uma consulta, adicione uma consulta no painel Consulta e selecione Fazer streaming de registros. Enquanto o Logging armazena os dados de registros em buckets de registros, somente os registros que correspondem à consulta são mostrados no painel Resultados da consulta. Se uma consulta não for fornecida, o Logging mostrará cada registro conforme eles estiverem armazenados.

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

Barra de ferramentas 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 de 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 gere gráficos dos resultados da consulta usando a Análise de dados de registros. Esse botão só ficará visível se o escopo selecionado contiver um bucket de registros com upgrade 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 um alerta 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 de tempo 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 de consulta não é alterada quando você usa esse recurso.
  • Mais ações: use essas outras opções para gerenciar alertas com base em registros ou criar um coletor.

Analise os resultados

É possível agregar, analisar e criar gráficos com dados de registro usando consultas SQL na página Análise de registros quando seu projeto tiver buckets de registros atualizados para usar a Análise de dados de registros. Para acessar a página Análise de registros da Análise de registros, na barra de ferramentas Resultados, clique em Analisar resultados.

O botão Analisar resultados ficará visível apenas quando o escopo selecionado tiver um bucket de registros atualizado para usar a Análise de dados de registros. Por exemplo, se você selecionar 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 registros. Para informações sobre como fazer upgrade de um bucket de registros para usar a análise de registros, consulte Fazer upgrade de um bucket de registros para usar a análise de registros.

Veja a seguir o que acontece quando você clica no botão Analyze results:

  • 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 atual da linguagem de consulta 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ê selecionou Escopo por projeto atual, os buckets _Required e _Default serão consultados.

    • Se você selecionou Escopo por armazenamento com uma ou mais visualizações de registro selecionadas, apenas os buckets de registro no 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.

Na página Análise de dados de registros, é possível ver os resultados em formato de tabela ou gráfico. Na guia Gráfico, selecione os dados do gráfico, personalize a configuração do gráfico ou salve um gráfico em um painel personalizado. Para saber como criar gráficos com base nos resultados da consulta e salvar gráficos em um painel personalizado, confira Resultados da consulta em gráficos com a Análise de dados de registros.

Para informações sobre como usar o SQL para gravar consultas na Análise de registros, 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, que correspondem aos campos delas.

Depois de executar a consulta no campo do editor de consultas, o painel Campos de registro é preenchido com base nos resultados da consulta. 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ê usar o BindPlane para gravar registros de nuvem local e híbrida, selecione o tipo de recurso Nó genérico.

  • Gravidade

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

Você poderá ver uma dimensão Serviço:

  • Se você tiver registros com o tipo de recurso Contêiner do Kubernetes e 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 de 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 o ID do projeto, são listadas com base nas seleções. Por exemplo, a dimensão ID do projeto é listada quando a consulta restringe as entradas de registro àquelas cujo tipo de recurso é Contêiner do Kubernetes ou quando você seleciona Escopo por armazenamento.

Refine a consulta

Para refinar sua consulta, selecione um valor no painel Campos de registro. Por exemplo, se você selecionar Error no cabeçalho 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:

Exemplo do painel Campos de registro com duas seleções.

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ê filtra com frequência 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. Clique no 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

No painel Histograma, é possível conferir 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 no botão Histograma na barra de ferramentas Resultados.

Atributos de histograma

Painel 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 período dos registros, representado por barras de histograma, que são exibidos no momento no painel Resultados da consulta. A linha do tempo ajuda a orientar nos registros que você estiver visualizando no momento no intervalo de tempo maior da sua consulta.

Analisar registros usando controles de tempo

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

Ajustar o horário rapidamente

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

A linha do tempo do painel Histograma mostrando os controles rápidos de tempo.

  • 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.

  • Deslize 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 na seta para trás para deslizar a linha do tempo para uma data anterior.

  • Aumentar e diminuir o zoom: clique em Diminuir 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 acima, o histograma inclui os recursos Explorar intervalo e Restringir à data/hora para oferecer mais controle sobre o histograma e os dados que você vê em outros painéis no Explorador de registros.

A linha do tempo do painel Histograma mostrando os controles Explorar intervalo e Restringir à data/hora.

É 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 registros 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. Passe o cursor 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.

    Outra opção é clicar em uma barra do histograma em vez de passar o cursor sobre ela. Isso equivale a selecionar Explorar intervalo.

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. Passe o cursor 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 acessar os resultados das suas consultas, use o painel Resultados da consulta. Para ajudar na solução de problemas dos aplicativos, veja os detalhes de entradas de registro individuais e agrupe e analise essas entradas para encontrar padrões nos registros. Se a Duet AI estiver ativada no projeto em que você está visualizando os registros, também será possível usá-la para resumir uma entrada de registro.

Configure a coluna Time

A coluna Hora no painel Resultados da consulta exibe os carimbos de data/hora das entradas de registro. Personalize a coluna Time para que apenas determinadas partes do carimbo de data/hora fiquem visíveis. Isso cria mais espaço horizontal para que você possa ver 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 analisar rapidamente os resultados por um determinado campo LogEntry. Ou talvez você queira agrupar as entradas de registro por um determinado par de valor de campo. É 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 está mostrando registros precedidos por um texto verde mostrando
tipos de recursos.

A Análise de registros oferece campos de resumo padrão e campos de resumo personalizados. Os campos de resumo padrão dependem dos resultados da consulta atual, e os campos de resumo personalizados permitem selecionar qualquer campo em 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 exibidos em formato de texto bruto. Por padrão, o conteúdo de cada entrada de registro é truncado para caber em uma linha. Para exibir até 10 linhas para cada entrada de registro, use a opção Unir linhas. Os espaços em branco são preservados em cada entrada de registro.

Para ocultar campos de resumo específicos, clique no campo 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.

    O painel de resultados da consulta mostra o botão para editar campos de resumo.

  2. Na caixa de diálogo Gerenciar campos de resumo, você pode fazer o seguinte:

    • Adicione nomes de campos personalizados a Campos de resumo personalizados.

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

      • Faça o preenchimento automático usando os registros atualmente 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, independentemente de ele ser sugerido para você 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 vão aparecer antes que o campo seja truncado e se o início ou o fim do campo é exibido.

    • 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 Localizar nos resultados no painel Resultados da consulta e digite o termo de pesquisa. Esse filtro permite que você encontre 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:

As entradas de registro com termos de pesquisa correspondentes estão destacadas.

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 outra semelhante à seguinte e recarrega os resultados:

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

Para visualizar 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 entradas de registro:

    A caixa de diálogo "Visualizar entradas de registro" permite ocultar ou mostrar entradas de registro semelhantes.

Ocultar entradas de registro semelhantes

Você pode ocultar entradas de registro semelhantes para remover registros dos resultados da consulta.

Há duas maneiras de ocultar entradas de registro semelhantes:

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

    Ocultar banner de registros semelhantes.

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

    Visualização: uma janela separada é aberta descrevendo o padrão encontrado e mostrando exemplos das entradas.

    Ao ocultar 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. Diferentes consultas analisam diferentes partes das entradas de registro, dependendo dos tipos de registros retornados.

  • Ocultar entradas de registro semelhantes a uma entrada de registro específica. Para ocultar entradas de registro semelhante 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 as 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, o que permite se concentrar em entradas que contêm o mesmo conteúdo do campo.

Para exibir ou ocultar entradas de registro que correspondem 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:

    Menu com opções para ocultar e mostrar entradas de registro com base em um campo específico.

  3. Selecione Mostrar entradas correspondentes ou Ocultar entradas correspondentes.

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

Fixar entradas de registro

Depois de executar uma consulta, é possível destacar uma entrada de registro fixando-a. 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á necessário liberar a entrada de registro.

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

  1. Passe o cursor sobre a entrada de registro que você quer fixar.
  2. Clique em Marcar.

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

O Explorador de registros mostra uma entrada de registro fixada nos painéis "Resultados da consulta" e "Histograma".

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 exiba entradas de registro correspondentes ao tipo de recurso ou aos rótulos do recurso do registro fixado.

Para fixar e exibir entradas de registro que correspondem ao mesmo tipo de recurso ou rótulos de recursos, faça o seguinte:

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

  2. Selecione uma opção no menu de fixação:

    • 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 o 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 a mesma resource.labels do registro fixado, selecione Mesmo resource.labels.

    • Para executar a consulta novamente com a mesma 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 Resultados da consulta atual e veja a entrada de registro fixada no contexto de registros próximos.
  • Zoom para entrada de registro: restrinja o período exibido no painel Histograma e refine a 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.

Exibição da entrada de registro que contém dados de trace.

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

Exibição de entrada de registro que contém apenas o ícone de trace.

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 saber mais sobre o conteúdo no painel de detalhes, consulte Encontrar e explorar traces.
  • 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.

Visualizar dados do Monitoring

Para determinados registros, como os do GKE e do Compute Engine, é possível clicar no tipo de recurso na linha de resumo do registro para exibir um menu com as seguintes opções:

  • Ver detalhes do monitoramento: abre um painel de detalhes sobre um recurso do GKE. Para informações sobre o painel de detalhes, consulte Visualizar detalhes do recurso.
  • Ver no Monitoring: abre uma página do Monitoring para o recurso.
  • Visualizar no GKE ou Visualizar no Compute Engine: abre a página Detalhes do recurso na interface do usuário do GKE ou do Compute Engine.

Menu do Explorador de registros para recursos do GKE.

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 para usuários que tenham 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.

Copie o link para compartilhar a entrada de registro com outras pessoas.

Download de registros

É 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 no painel Resultados da consulta.

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

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

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

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

Exemplo de consultas

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

Conferir registros do Compute Engine

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

É possível 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 com os IDs de recurso 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 VMs do Compute Engine, o campo resource.labels mostra metadados com o nome do recurso correspondente.
  • Campos de resumo: para os registros de instâncias de VM 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 ver registros nos destinos do coletor, consulte Resolver problemas de roteamento e coletores.

Não foi possível encontrar registros do console para 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 visualizar esses registros, faça o seguinte:

  1. No painel de navegação do console do Google Cloud, selecione Compute Engine e, depois, Instâncias de VM:

    Acessar Instâncias de VM

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

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

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

Para conseguir um ID de projeto ou organização do Google Cloud de 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:

O ID do projeto é mostrado

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, selecione o projeto correto do Google Cloud no seletor de projetos e organizações do Google Cloud.

  • 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 que ele foi 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 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 possam 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. Para ajustar a linha do tempo do histograma, use os controles de tempo do histograma ou o seletor de período. Ajustar esses 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.

Receba ajuda

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