Interface do Visualizador de registros (visualização)

Antes de começar

Você não precisa de um espaço de trabalho para usar o Logging, a menos que esteja enviando registros do Amazon Web Services (AWS) para o Logging.

Se você estiver usando um espaço de trabalho, o Logging não combinará os registros dos projetos monitorados do Google Cloud. Você precisa selecionar um projeto específico do Cloud para ver os registros dele.

Se você estiver usando um espaço de trabalho e a AWS, selecione o projeto de conector da AWS para ver os registros da AWS.

Primeiros passos

Para navegar até o visualizador de registros (visualização), faça o seguinte:

  1. Vá para o menu de navegação do Google Cloud e selecione Logging > Visualizador de registros:
    Vá até o visualizador de registros
  2. Selecione um projeto do Google Cloud.
  3. No menu do seletor de versões, alterne a versão do visualizador de registros de Clássica para Visualizar o novo visualizador de registros.

Agora você está no visualizador de registros (visualização).

Interface do visualizador de registros

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

Interface do usuário para o Visualizador de registros

  1. Página "Visualizador de registros": permite criar, analisar e refinar consultas.
  2. Seletor de organização e projeto: permite que você visualize registros em nível de organização ou para envolvidos no projeto.
  3. Criador de consultas: permite criar consultas usando os menus suspensos ou a linguagem do criador de consultas. Ele também apresenta uma guia para visualizar suas consultas salvas.
  4. Explorador de campo de registros (Beta): permite que você veja resultados baseados em agregação para resource.type, resource.labels, logName e severity e fornece uma maneira mais eficiente de refinar uma consulta.
  5. Histograma: permite visualizar a frequência dos seus dados de registros.
  6. Resultados da consulta: permite que você visualize os registros recuperados da sua consulta.
  7. Entradas de registro: permite que você visualize entradas de registro no formato JSON estruturado.
  8. Fuso horário: permite alterar o fuso horário em que os registros são exibidos.
  9. Layout da página: permite ativar e desativar os painéis Histograma e Explorador de campo de registros.
  10. Seletor de período: permite restringir os resultados por intervalo de tempo. O intervalo de tempo padrão é uma hora.
  11. Executar consulta: permite que você execute suas consultas depois de criá-las no painel do criador de consultas.
  12. Ir para agora: permite que você faça uma atualização forçada 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 período padrão de uma hora. Caso contrário, ele será atualizado com a data ou a duração de início atual e executará a consulta.
  13. Ações: permite executar determinadas ações nos seus registros, como a criação de uma métrica com base em registros ou um destino de coletor.
  14. Configurar: permite adicionar o valor de um campo de registro à linha de resumo no início ou no final da entrada de registro.
  15. Ocultar resumo do registro: permite ocultar a linha de resumo de registro dos resultados da consulta.
  16. Expandir ou recolher campos de registro aninhados: permite expandir ou recolher campos aninhados.
  17. Copiar para área de transferência: permite copiar a entrada de registro no formato JSON.

No painel de resultados da consulta, é possível clicar nos valores de um campo para escolher fazer o seguinte:

  1. Mostrar entradas correspondentes: permite consultar entradas de registro correspondentes.
  2. Ocultar entradas correspondentes: permite consultar entradas de registro que não correspondem à expressão selecionada.
  3. Adicionar campo à linha de resumo: permite adicionar o campo como uma linha de resumo às entradas de registro.

Opções depois de selecionar o valor do campo

Adicionar campos de resumo

Os campos de resumo ajudam a detectar padrões nos seus registros com mais rapidez. Por exemplo, a imagem a seguir mostra o valor do campo de resumo resource.labels.pod_name adicionado antes dos registros que contêm esse valor.

O Visualizador de registros mostra os registros precedidos por um texto verde que exibe
os nomes dos pods.

Adicionar um campo de resumo de uma entrada de registro

Para adicionar um campo de resumo a uma entrada de registro, siga estas etapas:

  1. Expanda uma entrada de registro clicando no botão de expansão .

  2. Clique no valor de um campo e selecione Adicionar campo à linha de resumo.

    O campo de resumo agora aparece antes das entradas de registro que contêm esse campo.

Adicionar um campo de resumo usando o botão Configurar

Para adicionar um campo de resumo usando o botão Configurar, siga estas etapas:

  1. Clique em Configurar e selecione Gerenciar campos de resumo.

  2. Adicionar campos.

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

    • Preenchimento automático usando os registros exibidos no momento.
    • Correção de campo para caracteres aceitos entre aspas.

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

  3. Clique em Truncar campos de resumo para reduzir a exibição dos valores do campo de resumo. Em seguida, escolha quantos caracteres exibir antes de o campo ficar truncado e se o início ou o término do campo é exibido.

  4. Clique em Aplicar.

    O campo de resumo agora aparece antes das entradas de registro que contêm esse campo.

Painel do explorador de campo de registros

O painel Explorador de campo de registros oferece um resumo de alto nível dos dados de registros e uma maneira mais eficiente de refinar uma consulta. Ele mostra a contagem de entradas de registro, classificadas por contagem decrescente, para o campo de registro especificado. As contagens do campo de registro correspondem ao período usado pelo painel Histograma.

O Explorador de campo de registros é preenchido e atualizado com base em uma consulta executada. Quando há uma consulta vazia, o painel Explorador de campo de registros exibe contagens de entradas de registro por tipo de recurso e campos de gravidade de registros.

Como usar o painel do explorador de campo de "Registros"

É possível adicionar campos do painel Explorador de campo de registros ao Criador de consultas para restringir e refinar uma consulta. Para fazer isso, clique em um valor de campo no painel Explorador de campo de registros. Isso adiciona o campo de registro ao Criador de consultas e executa automaticamente a consulta adicionando-a como uma expressão à consulta original usando o operador AND.

Quando uma consulta é executada, as contagens do campo de registro são carregadas gradualmente à medida que as entradas de registro são verificadas progressivamente. Quando a consulta é concluída, o que é indicado pelo encerramento da barra de progresso azul, você vê as contagens totais de todos os campos de registro.

Painel do histograma

O painel do histograma permite visualizar a distribuição de registros ao longo do tempo. Isso facilita a visualização das tendências nos dados dos registros e a solução de problemas.

Como ativar o painel de histograma

Para ativar o painel de histograma, selecione Layout de página e marque a caixa de seleção Histograma. O painel Histograma é exibido.

O layout da página está aberto e os histogramas estão selecionados

Para desativar o painel de histograma, desmarque a caixa de seleção Histograma.

Como usar o painel de histograma

Um histograma é gerado quando você executa uma consulta. Ela exibe a frequência de entradas de registro correspondentes para o período selecionado.

Como analisar registros

Para analisar seus dados de registro, passe o cursor sobre uma barra no painel Histograma e selecione Ir para este momento para detalhar um intervalo de tempo. Isso gera uma nova consulta com essa restrição de intervalo de tempo.

Histogramas de registros mostrando a caixa de diálogo pop-up para pular para o momento especificado

Solução de problemas

Esta seção fornece instruções para solucionar problemas comuns ao usar o Visualizador de registros (visualização).

Como selecionar um projeto ou uma organização do Cloud

Para selecionar um projeto do Cloud em qualquer lugar no Console do Google Cloud, inclusive no Visualizador de registros (visualização), use o seletor de projeto e organização:

Um projeto é selecionado no menu suspenso

Como conseguir o ID do projeto ou da organização do Cloud

Para receber um ID do projeto ou da organização do Cloud de qualquer lugar no Console do Google Cloud, expanda a lista de projetos do seletor de projeto e organização e encontre o ID 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 está selecionado? Caso contrário, selecione o projeto correto no seletor de projeto e organização.

  • Seu projeto está usando recursos que geram registros e há atividade nesses recursos? Mesmo que o projeto seja novo, ele precisa ter registros de auditoria que gravam 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.

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

Como receber suporte

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