Este documento apresenta uma visão geral do Explorador de registros no console do Google Cloud, que pode ser usado para recuperar, visualizar e analisar entradas de registro armazenadas em buckets de registro. A visualização e análise de entradas de registro individuais e uma sequência de entradas de registro podem ajudar a resolver problemas. Também é possível ler dados de registro usando a API Logging e a CLI do Google Cloud.
Antes de começar
Para receber as permissões necessárias para usar o Logs Explorer e conferir as entradas de registro, peça ao administrador para conceder a você os seguintes papéis do IAM:
-
Para conferir as entradas de registro no bucket
_Required
e as que estão na visualização_Default
no bucket_Default
ou para selecionar um escopo de registro: Leitor de registros (roles/logging.viewer
) no projeto, na pasta ou na organização. -
Para conferir todas as entradas de registro nos buckets
_Required
e_Default
: Leitor de registros particulares (roles/logging.privateLogViewer
) no seu projeto, pasta ou organização. -
Para conferir campos
LogEntry
restritos em um bucket de registro: Acessor de campo de registro (roles/logging.fieldAccessor
) no projeto, na pasta ou na organização que armazena o bucket de registro. Para informações sobre como restringir o acesso a camposLogEntry
, consulte Configurar o acesso no nível do campo. -
Para visualizar e fazer o download de entradas de registro armazenadas em uma visualização de registros em um bucket de registros:
Acessador de visualização de registros (
roles/logging.viewAccessor
) no projeto, na pasta ou na organização que contém o bucket de registros. Para saber como ter acesso apenas a uma visualização de registro específica, consulte Controlar o acesso a uma visualização de registro.
Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.
Também é possível conseguir as permissões necessárias por meio de papéis personalizados ou de outros papéis predefinidos.
Primeiros passos
Para começar a usar o Explorador de registros, faça o seguinte:
-
No console do Google Cloud, acesse a página Análise de registros:
Acessar a Análise de registros
Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Logging.
Selecione um projeto, uma pasta ou uma organização do Google Cloud.
As entradas de registro exibidas pela página Análise de registros dependem do seguinte:
- Os recursos pesquisados para entradas de registro.
- A configuração do período.
- Seus papéis de gerenciamento de identidade e acesso (IAM) nos recursos pesquisados.
- Sua consulta filtra os resultados da pesquisa.
Por exemplo, adicionar a consulta
severity>=ERROR
resulta em mostrar apenas as entradas de registro com um nível de gravidade de pelo menosERROR
.
Por padrão, a página Análise de registros pesquisa as entradas de registro dos recursos listados no escopo de registro padrão. Quando o escopo de registro padrão não está acessível, a página procura as entradas de registro que se originam do projeto, da pasta ou da organização selecionada. Para projetos, os resultados da pesquisa incluem as entradas de registro que são roteadas para o projeto por um coletor em outro projeto e armazenadas em um bucket de registro.
Depois que a página Análise de registros for aberta, você poderá selecionar quais recursos são pesquisados em entradas de registro pela Análise de registros. No entanto, sua seleção se aplica apenas à sessão atual.
Interface do Explorador de registros
A interface do Explorador de registros permite mostrar entradas de registro, analisá-las e especificar parâmetros de consulta. O Explorador de registros contém as seguintes seções, detalhadas nesta página:
- Barra de ferramentas principal
- Painel Query
- Painel Campos de registro
- Cronograma
- Barra de ferramentas Resultados da consulta
- Painel Resultados da consulta
Barra de ferramentas principal
Usando a barra de ferramentas principal, é possível fazer o seguinte:
- menu_book Biblioteca de consultas: confira consultas salvas, recentes e sugeridas. Para mais informações, consulte Salvar e compartilhar consultas.
- link Compartilhar link: crie um URL encurtado da consulta e
copie para a área de transferência, facilitando o compartilhamento de uma consulta.
O URL copiado tem o intervalo de tempo absoluto correspondente representado pelo
intervalo de tempo da consulta. Por exemplo,
7:49:37 PM - 8:49:37 PM
. - settings Preferências: ajuste a visualização da página do Explorador de registros e personalize o formato dos resultados da consulta. Para mais informações, consulte Definir preferências para visualizar dados de registro.
- Seletor de período: especifique um período para as entradas de registro que você quer visualizar. Para mais informações, consulte usar o seletor de período.
- Fazer streaming de registros: confira as entradas de registro conforme o Logging as armazena em buckets de registro. Para mais informações, consulte Fazer streaming de registros.
- school Aprender: confira links para a documentação e os tópicos relevantes.
Conferir consultas recentes, salvas e sugeridas
Para conferir as consultas que você executou recentemente, as que você salvou para uso futuro e as sugeridas, clique no botão menu_book Biblioteca de consultas.
Na guia Biblioteca de consultas, é possível conferir:
Consultas recentes: confira as consultas que você fez recentemente. Para mais informações, consulte Usar consultas recentes.
Consultas salvas: confira as consultas salvas e as que outros usuários do projeto do Google Cloud compartilharam com você. Para mais informações, consulte Salvar e compartilhar consultas.
Consultas sugeridas: confira as consultas sugeridas com base nos recursos do seu projeto do Google Cloud. Para mais informações, consulte Usar consultas sugeridas.
Consultas fornecidas por Google Cloud: confira as consultas fornecidas por Google Cloud com base em casos de uso comuns para vários serviços Google Cloud . Para mais informações, consulte Selecionar consultas da biblioteca.
Definir preferências para visualizar dados de registro
Para personalizar a apresentação dos dados de registro nos resultados da consulta, clique no botão settings Preferences e selecione View, Format ou Manage summary fields:
Para mostrar ou ocultar os painéis Linha do tempo e Campos de registro, ocultar os ícones de resumo nos resultados da consulta ou mudar a ordem de classificação dos registros, selecione Visualizar.
Para configurar a coluna Hora dos resultados da consulta, selecione Formato. Para mais informações, consulte Configurar a coluna Tempo.
Para mostrar até 10 linhas para cada entrada de registro, selecione Formato e clique em Unir linhas. Por padrão, o conteúdo de cada entrada de registro é truncado para caber em uma linha. Os espaços em branco são preservados em cada entrada de registro.
Para encontrar padrões nos seus registros usando campos de resumo, selecione Gerenciar campos de resumo. Para mais informações, consulte Encontrar padrões nos seus registros usando campos de resumo.
Configurar a coluna Data/hora
A coluna Time no painel Resultados da consulta mostra os carimbos de data/hora das suas entradas de registro. É possível personalizar a coluna Data/hora para que apenas partes específicas do carimbo de data/hora fiquem visíveis. Isso cria mais espaço horizontal para que você possa conferir mais informações na entrada de registro.
Para selecionar quais partes do carimbo de data/hora serão exibidas, clique no menu settings Preferências, selecione Formato e escolha uma das seguintes opções:
Data, hora e fuso horário
Data e hora (padrão)
Somente horário
Encontrar padrões nos seus 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 campo-valor. É possível adicionar campos de resumo aos resultados, que aparecem como ícones no início de cada linha de entrada de registro.
O Explorador de registros oferece campos de resumo padrão e personalizados.
Os campos de resumo padrão dependem dos resultados da consulta atual, e os campos de resumo personalizados permitem selecionar qualquer campo no LogEntry
.
Para mostrar ou ocultar todos os ícones de campo de resumo nos resultados da consulta, clique no botão settings Preferences, selecione View e Show summary chips. Quando essa opção está ativada, os resultados são mostrados no formato de texto bruto.
Para ocultar campos de resumo específicos, ative Campos de resumo e clique em Ocultar campo de resumo. Para modificar os campos de resumo, faça o seguinte:
Clique no botão settings Preferences e selecione Manage summary fields.
Na caixa de diálogo Gerenciar campos de resumo, é possível fazer o seguinte:
Adicione os nomes dos campos personalizados a Campos de resumo personalizados.
O campo de resumo oferece suporte ao preenchimento automático e à correção de campo para caracteres aceitos entre aspas. Por exemplo, se você digitar
jsonPayload.id-field
, ele será alterado parajsonPayload."id-field"
.Você também pode selecionar qualquer campo
LogEntry
, mesmo que ele seja sugerido pela função de preenchimento automático.Para remover um campo de resumo personalizado, clique no
X
no ícone dele.Ative ou desative a truncagem nos campos de resumo personalizados.
Para reduzir a exibição dos valores do campo de resumo, use a chave toggle_off ao lado de Truncar campos de resumo personalizados. Você pode escolher quantos caracteres exibir antes de o campo ficar truncado e se o início ou o término do campo é exibido.
Ocultar ou mostrar campos de resumo padrão:
Para personalizar quais campos de resumo padrão são mostrados nos resultados da consulta, abra o menu Ocultar ou mostrar campos de resumo padrão.
Clique em Aplicar.
Seus campos de resumo foram atualizados nos resultados da consulta.
Conferir os registros por período
Para especificar um período para as entradas de registro que você quer consultar, use o seletor de período.
Para forçar a atualização dos resultados da consulta e incluir o horário atual, clique em
Ir para agora.Fazer streaming de registros
É possível fazer streaming de registros, já que o Logging os armazena em buckets de registro, ou você 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 o botão Fazer streaming de registros na barra de ferramentas principal. Como o Logging armazena os dados de registros em buckets, 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 é armazenada.
Para interromper o streaming, clique em stop Parar transmissão ou role a tela manualmente para pausar.
Painel Consulta
Para criar uma consulta no Explorador de registros, use o painel de consulta. No painel de consulta, é possível criar e refinar consultas usando os seguintes recursos:
Selecione quais recursos são pesquisados para entradas de registro. As consultas que você escreve filtram as entradas de registro retornadas pela pesquisa.
Pesquisar todos os campos: encontre entradas de registro que correspondem aos termos ou frases de pesquisa. Todos os termos de pesquisa adicionados ao campo Pesquisar todos os campos são adicionados ao campo do editor de consultas e avaliados como parte da expressão de consulta. Para mais informações, consulte Pesquisar texto nos campos de registro.
Menus de filtro: crie consultas usando vários menus para selecionar recursos, nomes de registro, níveis de gravidade e correlação com outros registros. 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. Se você não encontrar o campo do editor de consultas, ative a opção Mostrar consulta. Para mais informações, consulte Escrever consultas avançadas usando a linguagem de consulta do Logging.
Depois de analisar a consulta, clique em Executar consulta. Os registros que correspondem à sua consulta são listados no painel Resultados da consulta. Os painéis Linha do tempo e Campos de registro também se ajustam de acordo com a expressão da consulta.
Selecionar quais recursos são pesquisados em entradas de registro
Esta seção descreve como visualizar ou alterar quais recursos são pesquisados para
entradas de registro. Se você inserir uma consulta, o Explorador de registros vai mostrar apenas as
entradas de registro recuperadas que também correspondem à consulta.
Por exemplo, adicionar a consulta severity>=ERROR
resulta em
mostrar apenas as entradas de registro com um nível de gravidade de pelo
menos ERROR
.
Para determinar quais entradas de registro serão exibidas, a página Análise de registros procura os recursos listados no escopo de registro padrão. Quando o escopo de registro padrão não está acessível, a página procura as entradas de registro que se originam do projeto, da pasta ou da organização selecionada. Quando os projetos são pesquisados, os resultados da pesquisa incluem as entradas de registro que são roteadas para o projeto por um coletor em outro projeto e armazenadas em um bucket de registro.
Para a sessão atual, é possível configurar quais recursos o Análise de registros pesquisa para entradas de registro. Por exemplo, ao solucionar problemas, examine apenas as entradas de registro incluídas em uma visualização de registro ou que se originam de um projeto específico do Google Cloud.
A barra de ferramentas no painel Consulta mostra os recursos pesquisados para entradas de registro:
Registros do projeto e
_Default: as entradas de registro que se originam no projeto, na pasta ou na organização selecionada são retornadas. Para projetos, essas entradas de registro incluem aquelas que são roteadas para o projeto por um coletor em outro projeto.
Visualização de registro N: as entradas de registro incluídas nas visualizações de registro N são retornadas. É possível expandir o menu para listar as visualizações de registro.
my-custom-scope, em que "my-custom-scope" é o nome de um escopo de registro personalizado: se um escopo de registro listar visualizações de registro, as entradas de registro nessas visualizações serão retornadas. Se um escopo de registro listar outros recursos, como projetos, as entradas de registro originadas nesses recursos serão retornadas. Para mais informações, consulte Criar e gerenciar escopos de registro.
Quando você quiser mudar quais recursos são pesquisados em entradas de registro, faça o seguinte:
Acesse a barra de ferramentas do painel Consulta. Essa barra de ferramentas exibe um menu com uma das seguintes identificações:
Registros do projeto
Visualização de registro N
my-custom-scope
Selecione o menu.
No menu suspenso Refine scope, selecione o local de armazenamento e conclua a caixa de diálogo.
As informações a seguir podem ajudar você a concluir a caixa de diálogo:
Quando você quiser conferir as entradas de registro roteadas por um coletor agregado, selecione
Visualização de registro como o local de armazenamento. Selecione todas as visualizações de registro que armazenam as entradas de registro que você quer visualizar.
Para pastas e organizações, o menu de visualização de registros lista todas as visualizações de registros que armazenam entradas de registro originadas nesses recursos.
Para projetos, o menu de visualização de registros lista as visualizações de registros nos buckets de registro armazenados pelo projeto selecionado.
Para modificar o menu de visualização de registros e incluir visualizações de registros em buckets de registro armazenados em um projeto específico, clique em add_circle Importar projeto e selecione o projeto.
Para configurar um escopo de registro, selecione
Escopo de registro e clique em Gerenciar escopos.
Os escopos de registro estão em Acesso antecipado.
Painel Campos de registro
O painel Campos de registro oferece um resumo de alto nível dos dados de registros e uma maneira eficiente de refinar uma consulta. O painel mostra entradas de registro detalhadas por diferentes dimensões, que correspondem aos campos nelas.
Depois que você executa a consulta no campo do editor de consultas, o painel Campos de registro é preenchido com base nos resultados da consulta. Esse painel mostra as contagens de entradas de registro para cada dimensão com suporte. Para cada dimensão, é possível fazer uma seleção. As seguintes dimensões estão sempre disponíveis:
Tipo de recurso
Se você usa o BindPlane para gravar registros de nuvem híbrida e no local, selecione o tipo de recurso Nó genérico.
Gravidade
Se você quiser que a consulta seja filtrada por vários níveis de gravidade, use o menu Severity.
Você pode encontrar 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 Service será preenchido. As entradas neste 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 mostrada como resultado da consulta, o menu de serviços 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 neste 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 a aquelas cujo tipo de recurso é Contêiner do Kubernetes ou quando você seleciona uma visualização de registro.
Refine a consulta
Para refinar a consulta, selecione um valor no painel Campos de registro. Por exemplo,
se você selecionar Erro no cabeçalho Gravidade, o
painel de consulta será atualizado para incluir severity=ERROR
.
Para remover uma seleção, clique no botão Limpar.
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 Campos de registro.
Para adicionar um campo ao painel Campo de registro, faça o seguinte:
No painel Resultados da consulta, clique em chevron_right Expandir esta entrada de registro para abrir uma entrada de registro.
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
eprotoPayload.startTime
. - Campos com alta cardinalidade, por exemplo,
insertId
eprotoPayload.latency
. - Campos com índices de matriz no caminho, por exemplo,
protoPayload.authorizationInfo[0].resource
.
Cronograma
Com o painel Timeline, é possível visualizar a distribuição de registros ao longo do tempo. A linha do tempo é gerada 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 Linha do tempo, clique em
Colapsar linha do tempo.Recursos da linha do tempo
Barras da linha do tempo: cada barra 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 na Linha do tempo apresenta um menu com opções para analisar seus registros.
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.
Período: mostra o período dos registros, representado por barras de histograma. 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 na linha do tempo para investigar e analisar os dados dos registros.
Ajustar controles de tempo
A linha do tempo oferece controles de tempo que permitem ajustar os dados 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. Clique em Executar.
Deslizar a linha do tempo para frente e para trás: clique na chevron_right seta para frente para deslizar a linha do tempo para um momento posterior. Clique na chevron_left seta para trás para deslizar a linha do tempo para um horário anterior.
Aumentar e diminuir o zoom: clique em zoom_out Diminuir zoom para ampliar os dados mostrados na linha do tempo. Clique em zoom_in Zoom in para restringir os dados mostrados na linha do tempo.
Ocultar a linha do tempo: clique em
Fechar linha do tempo para ocultar a 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, a linha do tempo oferece os recursos Explorar intervalo e Restringir à data/hora para oferecer mais controle sobre a linha do tempo e os dados que você vê em outros painéis no Explorador de registros. Talvez você tenha interesse em uma determinada barra na linha do tempo por causa do tamanho ou dos níveis de gravidade relacionados. Selecione essa barra para ajustar os dados de registros exibidos no Explorador de registros.
Use o recurso Explorar intervalo para procurar dados de registros sem alterar os valores nos painéis Cronologia 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 linha do tempo 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 linha do tempo selecionada.
O URL do console é atualizado para incluir o
timestamp
do registro mais recente capturado pelo intervalo de tempo da barra de linha do tempo selecionada.
Para selecionar o recurso Explorar intervalo, faça o seguinte:
Mantenha o ponteiro do mouse sobre uma barra na linha do tempo. Será exibido um painel com informações resumidas sobre os dados de registros do período especificado.
No painel, selecione Explorar intervalo.
Outra opção é clicar em uma barra da linha do tempo. 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 a restrição de período da barra de linha do tempo selecionada.
- O URL do console é atualizado para incluir o
timestamp
do registro mais recente capturado pelo intervalo de tempo da barra de linha do tempo selecionada. - A linha do tempo muda para mostrar apenas os registros que têm um valor
timestamp
que se enquadra no período da barra de linha do tempo selecionada. pela barra de linha do tempo selecionada. - Os dados no painel Campos de registro se ajustam de acordo com o intervalo de tempo capturado pela barra de linha do tempo selecionada.
Para selecionar o recurso Restringir à data/hora, faça o seguinte:
Mantenha o ponteiro do mouse sobre uma barra na linha do tempo. Será exibido um painel com informações resumidas sobre os dados de registros do período especificado.
No painel, selecione Restringir à data/hora.
Barra de ferramentas Resultados da consulta
Na barra de ferramentas Resultados da consulta, você tem as seguintes opções:
Ações: selecione entre várias opções para analisar melhor os dados dos registros:
- Destacar nos resultados: insira o texto que será destacado nos resultados da consulta.
- add_chart Criar métrica: configure uma métrica com base em registros.
- call_merge Criar coletor: crie um coletor de registros que preencha automaticamente o filtro de inclusão do coletor com a expressão de consulta atual.
- add_alert Criar alerta de registro: configure uma política de alertas com base em registros.
- edit Gerenciar alertas: confira e gerencie as políticas de alertas.
- download Download: faça o download dos seus registros em formato CSV ou JSON. Para mais informações, consulte Fazer o download de registros.
Pesquisar os resultados da consulta
Para pesquisar o conteúdo dos Resultados da consulta, clique em Destaque nos resultados no painel Resultados da consulta e digite seu termo de pesquisa. Esse filtro permite 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:
Download de registros
Para receber as permissões necessárias para fazer o download de registros, peça ao administrador para conceder a você o papel do IAM de
Acesso à visualização de registros (roles/logging.viewAccessor
) no projeto.
Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.
logging.logEntries.download
. Também é possível
conceder um papel que contenha a permissão logging.logEntries.list
, que permite
que um usuário principal visualize e faça o download de registros.
Essas permissões também podem ser concedidas com funções personalizadas ou outros papéis predefinidos.
Para fazer o download dos registros, siga estas etapas:
No menu Ações do painel Resultados da consulta, clique em Fazer o download.
Na caixa de diálogo Fazer o download dos registros, selecione o formato CSV ou JSON e clique em Download.
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 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.
Painel Resultados da consulta
Para conferir os resultados das consultas, use o painel Resultados da consulta. Para ajudar na solução de problemas dos seus aplicativos, é possível conferir os detalhes de entradas de registro individuais e agrupar e analisar entradas de registro para encontrar padrões nos registros.
Conferir entradas de registro semelhantes
É possível conferir entradas de registro semelhantes a uma entrada selecionada, o que permite se concentrar em registros de interesse.
Para mostrar entradas de registro semelhantes, faça o seguinte:
No painel Resultados da consulta, em uma entrada de registro, clique em chevron_right Expandir.
Clique em Entradas semelhantes e selecione Mostrar entradas semelhantes.
A consulta é atualizada com uma consulta semelhante a esta e recarrega os resultados da consulta:
--Show similar entries protoPayload.methodName="io.k8s.core.v1.configmaps.update" --End of show similar entries
Para conferir uma prévia das entradas de registro semelhantes, faça o seguinte:
No painel Resultados da consulta, em uma entrada de registro, clique em chevron_right Expandir.
Abra o menu Entradas semelhantes e selecione Visualizar entradas semelhantes.
Uma caixa de diálogo separada será 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, você pode ocultar ou mostrar 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:
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 de campo de registro semelhante.
Se um padrão significativo for detectado, um banner vai aparecer no painel Resultados da consulta mostrando a porcentagem de resultados que podem ser ocultos.
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.
Quando você oculta registros semelhantes, nenhuma informação é salva fora da sessão do Explorador de registros. Cada consulta produz uma nova análise, com base apenas nos registros mostrados. Consultas diferentes analisam partes diferentes das entradas de registro, dependendo dos tipos de registros retornados.
Ocultar entradas de registro semelhantes a uma entrada específica.
Para ocultar entradas de registro semelhantes a uma entrada de registro, clique em chevron_right Expandir, clique no menu Entradas semelhantes e selecione Ocultar entradas semelhantes.
A consulta é atualizada e o painel Resultados da consulta é recarregado. As entradas de registro semelhantes à entrada de registro selecionada não são exibidas.
Mostrar ou ocultar entradas de registro que correspondem a um campo
É possível mostrar 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 de campo.
Para mostrar ou ocultar entradas de registro que correspondem a um campo específico em uma entrada de registro, faça o seguinte:
No painel Resultados da consulta, na entrada de registro, clique em chevron_right Expandir.
Clique no valor de um campo na entrada de registro, como
compute.googleapis.com
, que é umserviceName
.No menu, 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 recarregados com novos resultados.
Fixar entradas de registro
Depois de executar uma consulta, você pode 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 for incluída, será necessário desafixar a entrada de registro.
Para fixar uma entrada de registro, faça o seguinte:
- Mantenha o ponteiro do mouse sobre a entrada de registro que você quer fixar.
- Clique em push_pin Marcar.
Depois que você fixa uma entrada de registro, o plano de fundo dela fica escuro e um ícone de Fixação push_pin é exibido. Um ícone de alfinete
também aparece no painel Linha do tempo com base na timestamp
da entrada de registro
fixada.
Para desafixar uma entrada de registro, clique no ícone de alfinete novamente.
Mostrar registros que correspondem ao recurso de uma entrada de registro fixada
Depois de fixar uma entrada de registro, você pode executar uma nova consulta que mostra entradas de registro que correspondem ao tipo ou rótulos de recurso do registro fixado.
Para fixar uma entrada de registro e mostrar entradas de registro que correspondem ao mesmo tipo de recurso ou identificador de recurso, faça o seguinte:
Clique em arrow_drop_down seta para baixo ao lado do registro fixado para abrir o menu de fixação.
Faça uma seleção no menu de fixação:
Para executar a consulta novamente com o mesmo
resource.type
do registro fixado, selecione Mesmo resource.type.Por exemplo, suponha que você fixe uma entrada de registro com um
resource.type
dek8s_node
. Se você selecionar Mesmo resource.type, a consulta será realizada novamente para mostrar todas as entradas de registro comresource.type="k8s_node"
.Para executar a consulta novamente com o mesmo
resource.labels
do registro fixado, selecione Mesmo resource.labels.
- Para executar a consulta novamente com o mesmo
trace
que o registro fixado, selecione Mesmo rastro.
- Para limpar a consulta e mostrar todas as entradas de registro, selecione Mostrar tudo.
Visualizar uma entrada de registro fixada na Linha do tempo
É possível usar a Linha do tempo para destacar, rolar e examinar uma entrada de registro fixada.
Na Linha do tempo, clique em push_pin Fixar 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 confira a entrada de registro fixada no contexto dos registros próximos.
- Aplicar zoom até a entrada de registro: restringe o intervalo de tempo que o painel Linha do tempo exibe e refina a consulta para isolar os registros próximos ao registro fixado.
- Liberar: libera uma entrada de registro.
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 do painel de detalhes, consulte Encontrar e analisar 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 comoTrue
. 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 selecionar o 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.
Copiar um link em uma entrada de registro
Para compartilhar um link em um registro, abra uma entrada de registro e selecione content_copy Copiar. Você pode copiar um registro em JSON ou um link para o registro. O link será copiado para a área de transferência. É possível enviar o link para os 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.
Exemplo de consultas
Para consultas sugeridas, organizadas por Google Cloud produto e caso de uso, consulte Exemplos de consultas usando o Explorador de registros. Por exemplo, é possível executar consultas relacionadas ao Kubernetes para encontrar registros do Google Kubernetes Engine.
Conferir os 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 aparece como subtexto em
vários lugares no Logs Explorer. Por exemplo, para o tipo de recurso gce_instance
, o nome da VM aparece ao lado do ID. Os nomes de recursos ajudam
a identificar o ID de recurso correto, em que você pode criar consultas.
Os nomes dos recursos do Compute Engine podem aparecer nos seguintes locais:
- Menus de filtro do painel Query: os tipos de recurso do Compute Engine mostram os nomes dos recursos, com os IDs correspondentes como subtexto.
- Campos de registro: os tipos de recurso do Compute Engine mostram o nome do recurso, em vez do ID, nas dimensões do campo.
- Resultados da consulta: para logs de instâncias de VM do Compute Engine, o campo
resource.labels
mostra metadados com o nome do recurso correspondente. - Campos de resumo: para logs 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 para conferir registros em destinos de coletor, consulte Resolver problemas de roteamento e coletores.
Falha no download dos registros
Você está usando o Logs Explorer e clica em download Download. O comando é iniciado, mas não é concluído ou informa um erro.
Para resolver esse problema, reduza o tempo necessário para a execução do comando fazendo o seguinte:
- Na caixa de diálogo Fazer o download de registros, reduza o valor de Entradas de registro máximas.
- 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.
Não é possível encontrar os registros do console de uma instância de VM
Os registros gravados no console de uma instância do Compute Engine podem não estar disponíveis no Logs Explorer. Para conferir esses registros, faça o seguinte:
-
No Console do Google Cloud, acesse a página 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.
Selecione a instância e, em seguida, 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 seja enviada ao Cloud Logging. Para mais informações, consulte Como ativar e desativar o registro de saída da porta serial.
Conseguir o ID do projeto ou da organização do Google Cloud
Para receber um ID do projeto ou da organização do Google Cloud de qualquer lugar no Console do Google Cloud, abra 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:
Verifique se o projeto correto do Google Cloud está selecionado.
Verifique se o projeto do Google Cloud está usando recursos que geram registros e se há atividade nesses recursos. Mesmo que o projeto do Google Cloud seja novo, ele precisa ter registros de auditoria que comprovem a criação dele. Para informações sobre como verificar se você está usando um recurso que gera registros, consulte Como mapear serviços para tipos de recursos.
Verifique se o intervalo de tempo não é muito limitado.
Visualize suas consultas de exclusão atuais para garantir que os registros que você está procurando não sejam excluídos acidentalmente.
Verifique se você tem permissão para acessar as entradas de registro nos projetos e visualizações de registro referenciadas pela configuração do menu Refinar escopo. Para saber como ajustar o escopo da pesquisa, consulte Refinar o 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 sobre um recurso sem especificar um bucket, o Cloud Logging vai usar o histórico dos coletores no projeto do Google Cloud para determinar onde as entradas referentes a esse recurso podem ter sido gravadas. Se
o Cloud Logging identificar mais de 200 buckets em que as entradas
possam ter sido gravadas, a consulta falhará e aparecerá 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 no painel Consulta.
Quando você tem uma consulta com um carimbo de data/hora, o seletor de intervalo de tempo é desativado. A consulta usa a expressão de carimbo de data/hora como 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 informações sobre como receber suporte, consulte a página de suporte do Google Cloud Observability.