Como usar o Buscador de registros

Neste documento, apresentamos uma visão geral do Explorador de registros no Console do Google Cloud, que pode ser usado para recuperar, ver e analisar dados de registro.

Também é possível ler os registros usando a API Logging e a CLI do Google Cloud.

Introdução

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

  • Verifique se você tem o papel correto do Identity and Access Management para ver os registros. Para informações sobre papéis e permissões do IAM, consulte Controle de acesso com o IAM.

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

  • Se você ingerir registros de nuvem híbrida e no local por meio do BindPlane, poderá encontrá-los no tipo de recurso generic_node.

  • Acesse o Explorador de registros:

    Acesse o Explorador de registros

    Selecione o projeto do Cloud apropriado.

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

O Explorador de registros contém as seguintes seções, detalhadas nesta página:

  1. Barra de ferramentas Ação
  2. Painel Consulta
  3. Barra de ferramentas Results
  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:

  • Opções: acesse o visualizador de registros legado, envie feedback e veja um resumo dos novos recursos do Explorador de registros.
  • Refinar o escopo: defina o escopo da pesquisa por registros apenas no projeto atual do Cloud ou por uma ou mais visualizações de armazenamento. Para mais informações sobre o escopo, consulte Refinar escopo.
  • Saiba mais: visualize links para a documentação e os tópicos relevantes.
  • Compartilhar link: crie um URL encurtado da consulta atual e o copie para a área de transferência. Isso facilita o compartilhamento de uma consulta. O URL copiado tem o período absoluto correspondente representado pelo período atual da sua consulta, por exemplo, 7:49:37 PM - 8:49:37 PM.

Refinar escopo

É possível refinar o escopo dos registros exibidos no Explorador de registros pela opção Refinar escopo. É possível pesquisar apenas os registros do projeto atual do Cloud ou os registros de pesquisa em uma ou mais visualizações de armazenamento. Para refinar o escopo do Explorador de registros, faça o seguinte:

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

  2. No painel Refinar escopo, selecione uma opção Escopo por.

    Caixa de diálogo "Refinar o escopo"

    • Escopo por projeto: serve para pesquisar registros gerados pelo projeto atual do Cloud.

    • Escopo por armazenamento permite pesquisar registros com base em uma ou mais visualizações de armazenamento. Para mais informações sobre visualizações de registros, consulte Gerenciar visualizações de registros em buckets de registros.

  3. Se você selecionar Escopo por armazenamento, selecione um ou mais buckets que quer ver.

    O console lista as visualizações de armazenamento que atendem às seguintes condições:

    • O usuário tem acesso à visualização de armazenamento.
    • Os buckets de registro pertencem ao projeto do Cloud selecionado, ou o projeto do Cloud selecionado já roteou registros para os buckets de armazenamento.
  4. Clique em Aplicar.

Painel Consulta

Use os recursos do painel Consulta para fazer o seguinte:

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

    • Seletor de período: restringe os resultados da consulta por período. Para mais informações, consulte Usar o seletor de período.

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

    • Filtrar menus: 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 Escrever consultas avançadas.

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

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

  • Guia Suggested: veja consultas sugeridas com base nos recursos no projeto do Cloud. Para mais informações, consulte Usar consultas sugeridas.

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

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

  • Limpar consulta: limpe e redefina as seleções que você fez ao criar uma consulta no painel Consulta.

  • Fazer streaming de registros: veja as entradas de registro à medida que o Logging as ingere. Para saber mais, consulte Fazer streaming de registros.

  • Executar consulta: execute suas consultas após criá-las no painel Consulta.

Se você não vir o campo "query-editor", ative Mostrar consulta. Se você adicionar termos de pesquisa à caixa de texto de pesquisa, esses termos também aparecerão no campo de consulta-editor e serão avaliados como parte da expressão de consulta.

Depois de revisar a consulta, clique em Executar consulta. Os registros que correspondem à consulta estã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

É possível fazer streaming dos registros conforme o Logging os ingere ou adicionar uma consulta para fazer streaming somente dos registros que correspondem à consulta.

Para transmitir registros com base em uma consulta, adicione uma consulta no painel Consulta e selecione Registros de stream. À medida que o Logging processa os dados de registros, apenas os registros que correspondem à consulta são exibidos no painel Resultados da consulta. Se uma consulta não for fornecida, o Logging mostrará cada registro durante o processamento.

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

Barra de ferramentas Resultados

Na barra de ferramentas Resultados, você pode fazer o seguinte:

  • Mostrar o painel Campo de registros: mostra ou oculta rapidamente esse painel no layout de página do Explorador de registros.
  • Mostrar o painel Histograma: mostra ou oculta rapidamente esse painel no layout da página do Explorador de registros.
  • Criar métrica: configure uma métrica com base em registros com base na sua expressão de consulta atual.
  • Criar alerta: configure um alerta baseado em registro com base na sua expressão de consulta atual.
  • 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 intervalos 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 de início ou a duração atual e executará a consulta. A expressão de consulta não é alterada quando você usa esse recurso.
  • Mais ações: use estas outras opções para gerenciar alertas baseados em registros ou criar um coletor.

Painel Campos de registro

O painel Campos de registro oferece um resumo de alto nível dos dados dos registros e fornece uma maneira mais eficiente de refinar consultas. Ele mostra entradas de registro detalhadas por diferentes dimensões, que correspondem aos campos nelas. Para cada campo, o painel Campos de registro mostra valores e a incidência deles em ordem de frequência decrescente. As contagens do campo de registro correspondem ao período no seletor do intervalo de tempo.

Para mostrar ou ocultar o painel Campos de registro, clique no botão Campos de registros na barra de ferramentas Resultados.

O painel Campos de registro é preenchido e atualizado com base em uma consulta executada no campo "query-editor".

Se a consulta estiver vazia, o painel Campos de registro exibirá as contagens de entradas de registro pelos campos Tipo de recurso e Gravidade.

painel de campos de registro.

Se você selecionou Escopo por armazenamento, também verá o ID do projeto e as contagens correspondentes das entradas de registro.

Se você selecionar um tipo de recurso no painel Campos de registro, um conjunto de campos relevantes baseado nos rótulos de recursos será usado para preencher o painel. de dados. Assim, você conseguirá investigar dados de registro para esse tipo de recurso específico. Para removê-los, clique em Limpar ao lado do campo Tipo de recurso.

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. Para adicionar um campo ao painel Campo de registro, faça o seguinte:

  1. No painel Resultados da consulta, clique no botão de expansão para expandir uma entrada de registro.

  2. Clique com o botão esquerdo do mouse 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. Também é possível remover um campo personalizado da lista clicando com o botão esquerdo do mouse no painel Resultados da consulta e selecionando Remover dos campos de registro.

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.

Analisar registros usando o painel Campos de registro

Para restringir e refinar uma consulta, adicione pares de valor-campo do painel Campos de registro à expressão no painel Consulta. Para fazer isso, no painel Campos de registro, clique no valor de um campo. Isso adiciona o par de campo-valor à expressão usando o operador AND. Em seguida, a consulta é executada.

É possível adicionar pares de campo/valor aninhados e pares de campo/valor de nível superior ao painel Campos de registro. Por exemplo, suponha que você tenha adicionado jsonPayload.message ao painel Campos de registro. Se você selecionar um valor jsonPayload.message específico, ele preencherá o campo query-editor.

Os painéis Histograma e Resultados da consulta também mudam para refletir a consulta atual.

Quando uma consulta estiver em execução, as entradas de registro são verificadas e as contagens de campos de registro são alteradas. Quando a consulta é concluída, é exibido o total de contagens de todos os campos de registro.

Histograma

O painel Histograma mostra 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.

Recursos do 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, representados por barras de histograma, que são exibidas 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.

Dica: quando você ajusta os controles de tempo do histograma, os dados dos registros nos painéis Resultados da consulta e Campos de registro se ajustam de acordo com o intervalo de tempo capturado pelo 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.

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.

  • 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 na seta para trás para deslizar a linha do tempo para um horário anterior.

  • Aumentar e diminuir o zoom: clique no ícone de zoom para ampliar os dados exibidos na linha do tempo. Clique no ícone de zoom para restringir os dados exibidos 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.

Você pode usar o recurso Rolar para a data para procurar seus 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

No painel Resultados da consulta, é possível explorar as entradas de registro que correspondem às expressões de consulta e o período selecionado usando os controles de tempo do histograma ou o seletor de período:

Painel Resultados da consulta

Use os recursos do painel Resultados da consulta para fazer o seguinte:

  • Resultados da consulta: veja as entradas de registro recuperadas da consulta no formato JSON estruturado. Para expandir os resultados da consulta, clique em Enter wide query results .
  • Fuso horário: altere o fuso horário em que os registros são exibidos.
  • Fazer o download dos registros: faça o download dos registros dos resultados da consulta.
  • Ocultar registros semelhantes: oculte grandes quantidades de registros semelhantes nos resultados da consulta.
  • Dados de trace: veja os detalhes do trace e refine sua consulta com base no trace. Para saber mais, consulte Visualizar dados de trace.
  • Ocultar resumo do registro: oculte a linha de resumo do registro dos resultados da consulta.
  • Expandir ou recolher campos de registro aninhados: expanda ou recolha os campos aninhados.
  • Copiar para a área de transferência: copie a entrada de registro no formato JSON.
  • Copiar link para uma entrada de registro: compartilhe um link para uma entrada de registro. Para mais informações, consulte Copiar um link para uma entrada de registro.
  • Botão Editar no cabeçalho da coluna Resumo: adicione o valor de um campo de registro às linhas de resumo das entradas de registro. Também é possível ocultar completamente os campos de resumo padrão para exibir uma exibição de texto bruto das suas entradas. Para mais informações, consulte Adicionar e gerenciar campos de resumo.
  • Fixar a entrada de registro: fixe uma entrada de registro nos painéis Resultados da consulta e Histograma. Veja mais informações em Fixar registros.
  • Rolar o cursor: role os registros nos Resultados da consulta. O URL se ajusta para incluir o cursorTimestamp, que indica a timestamp do registro mais recente mostrado no painel Resultados da consulta.

No painel de resultados da consulta, clique nos valores de um campo para fazer o seguinte:

  • Mostrar entradas correspondentes: consulta as entradas de registro correspondentes.
  • Ocultar entradas correspondentes: consulta entradas de registro que não correspondam à expressão selecionada.
  • Adicionar campo à linha de resumo: adicione o campo como uma linha de resumo às entradas de registro.

Adicionar e gerenciar campos de resumo

Use os campos de resumo para perceber padrões nos seus registros mais rapidamente.

Vamos supor que você esteja analisando as entradas de registro nos resultados da consulta e queira passar rapidamente pelos resultados por um determinado campo LogEntry. Ou talvez você queira agrupar suas entradas de registro por um determinado par de campo e 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 de consulta com o campo de resumo resource.type adicionado a cada linha de entrada de registro:

O Explorador de registros está mostrando registros precedidos por um texto verde que exibe
os tipos de recursos.

O Explorador de registros oferece campos de resumo padrão, que dependem dos resultados da consulta atuais, e campos de resumo personalizados, que permitem segmentar qualquer campo no LogEntry.

É possível gerenciar os campos de resumo personalizado e padrão em um menu de edição nos resultados da consulta. Também é possível adicionar campos de resumo personalizados diretamente de uma entrada de registro expandida.

Adicionar um campo de resumo personalizado de uma entrada de registro

Para adicionar um campo de resumo personalizado diretamente de uma entrada de registro, faça o seguinte:

  1. Clique no botão de expansão para expandir uma entrada de registro.

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

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

Para remover um campo de resumo personalizado, clique no ícone dele na linha de entrada de registro e selecione Remover campo da linha de resumo. Para gerenciar ainda mais seus campos de resumo personalizados, consulte as instruções na próxima seção.

Gerenciar campos de resumo usando o menu de edição

Para gerenciar os campos de resumo personalizado e padrão usando o menu de edição, faça o seguinte:

  1. Clique em Editar para abrir o menu de edição:

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

  2. Na caixa de diálogo Gerenciar campos de resumo, faça o seguinte:

    1. Ative ou desative os Campos de resumo padrão usando o botão .

      Se você desativar os campos de resumo padrão e não adicionar nenhum campo de resumo personalizado, as entradas de registro serão exibidas em formato de texto bruto.

    2. Adicione nomes de campo personalizados a Campos de resumo personalizados.

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

      • Preenchimento automático usando os registros atualmente exibidos nos resultados de 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 segmentar qualquer campo LogEntry, independentemente de ele ser sugerido ou não com a função de preenchimento automático.

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

    3. Ative ou desative o truncamento dos seus campos de resumo personalizados. Use a chave de alternância por Truncar campos de resumo para encurtar a exibição dos valores dos campos de resumo. Em seguida, escolha quantos caracteres serão exibidos antes do truncamento e se o início ou o fim do campo será exibido.

      Dica: nos resultados da consulta, passe o cursor sobre um campo de resumo truncado para exibir o valor total.

  3. Clique em Aplicar.

    Os campos de resumo foram atualizados nos resultados da consulta.

Ocultar entradas de registro semelhantes

É possível ocultar registros para remover rapidamente grandes quantidades de entradas de registro semelhantes dos resultados da consulta.

Quando você executa uma consulta, os resultados são analisados em relação aos padrões à medida que são enviados para exibição no painel Resultados da consulta. As entradas de registro são agrupados automaticamente com base no conteúdo de um campo de registro semelhante. Se um padrão significativo for detectado, um banner aparecerá no painel Resultados da consulta mostrando a porcentagem de resultados semelhantes que podem ser ocultos:

Ocultar banner de registros semelhantes

Para ocultar registros semelhantes, clique em Ocultar entradas semelhantes. Isso adiciona uma cláusula à consulta e recarrega os resultados dela.

Para visualizar quais entradas de registro estão ocultas, clique em Visualizar. Será aberta uma janela separada, que descreve o padrão encontrado e mostrará exemplos das entradas que serão ocultas.

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

Fixar entradas de registro

Você pode fixar uma entrada de registro para destacar uma entrada de interesse.

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 no ícone de fixação .

Depois de fixar uma entrada de registro, o plano de fundo será escurecido, e um ícone de alfinete será exibido.

Se você fixar uma entrada de registro e executar a consulta novamente, ela aparecerá na parte superior ou inferior do painel Resultados da consulta, dependendo de como você configurou os dados de registro. Um ícone de alfinete também aparece no painel Histograma com base na entrada de registro fixada timestamp:

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

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

Ver uma entrada de registro fixada em contextos de recursos

Se você fixar uma entrada de registro e visualizá-la em diferentes contextos de recursos, a consulta será executada novamente com as mesmas informações de recursos que a entrada de registro fixada.

Para ver a entrada de registro fixada em diferentes contextos 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. No menu do alfinete, você pode ver a entrada de registro nos seguintes contextos de recurso:

    • Mesmo resource.type: executa novamente a consulta com o mesmo resource.type do registro fixado.

    • Mesmo resource.labels: executa novamente a consulta com o mesmo resource.labels do registro fixado.

    • Mesmo trace: executa novamente a consulta com o mesmo trace do registro fixado.

    • Show all: limpa e executa a consulta novamente.

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.

Usando o painel Histograma, clique no ícone de fixação e escolha uma das seguintes opções de menu:

  • Rolar para 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.
  • Aplicar zoom à entrada de registro: restrinja o período 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.

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 mais informações sobre o conteúdo do painel de detalhes, consulte Visualizar detalhes do trace.
  • 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 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.
    • Fazer o download dos dados para o Drive.
    • Ver os dados em uma nova guia.

    Ao salvar um CSV e selecionar o Drive, será possível abrir o arquivo no Planilhas.

Consultas de exemplo

Para consultas sugeridas, organizadas pelo produto e pelo caso de uso do Google Cloud, consulte Amostra de consultas usando o Explorador de registros. Por exemplo, é possível executar consultas relacionadas ao Kubernetes para encontrar os 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 lugares no Explorador de registros. Por exemplo, para o tipo de recurso gce_instance, você vê o nome da VM com o ID da VM. Os nomes dos recursos ajudam a identificar o código correto do recurso, em que as consultas podem ser criadas.

É possível ver os nomes de recursos do Compute Engine nos seguintes locais:

  • Menus de filtro do painel Consulta: os tipos de recursos do Compute Engine mostram os nomes dos 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 do recurso, nas dimensões do campo.
  • Resultados da consulta: para registros da instância de VM do Compute Engine, o campo resource.labels mostra metadados com o nome do recurso correspondente.
  • Campos de resumo: nos registros da instância de VM do Compute Engine, o ícone mostra o nome do recurso em vez do ID do recurso.

Solução de 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 coletores, consulte Resolver problemas de roteamento e coletores.

Encontrar o ID do projeto ou da organização do Cloud

Para receber um ID do projeto ou da organização de qualquer lugar no Console do Google Cloud, expanda a lista de projetos do Cloud no seletor de organização e projeto do Cloud e encontre o ID do projeto do 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:

  • Foi selecionado o projeto correto do Google Cloud? Caso contrário, selecione o projeto correto no projeto do Cloud e no seletor de organizações.

  • Seu projeto do Cloud está usando recursos que geram registros e há atividade nesses recursos? Mesmo que o projeto do Cloud 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.

  • 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 visualizar 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 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. Você ajusta a linha do tempo do histograma usando 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.