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 a análise de dados entradas de registro e uma sequência de entradas de registro a resolver problemas. Você também pode ler os dados de registro usando o API Logging e a Google Cloud CLI.
Para executar operações agregadas nas entradas de registro, como a contagem do número de que contenham um padrão específico, faça upgrade do bucket de registros na Análise de dados de registros e, em seguida, executar consultas na Análise de dados de registros do console do Google Cloud. Você pode continuar a usar Análise de registros para acessar registros em buckets que foram atualizados para usar a Análise de dados de registros. Para mais informações, consulte a Visão geral do Log Analytics.
No restante deste documento, descrevemos como usar a Análise de registros.
Antes de começar
Para ter as permissões necessárias para usar a Análise de registros e acessar 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 da visualização_Default
no bucket_Default
ou para selecionar um escopo de registro: Visualizador de registros (roles/logging.viewer
) no seu projeto, pasta ou organização. -
Para visualizar todas as entradas de registro nos buckets
_Required
e_Default
: Visualizador de registros particulares (roles/logging.privateLogViewer
) no seu projeto, pasta ou organização. -
Para visualizar campos
LogEntry
restritos em um bucket de registros: Logs Field Accessor (roles/logging.fieldAccessor
) no projeto, na pasta ou na organização que armazena o bucket de registros. Para saber como restringir o acesso aos camposLogEntry
, consulte Configurar o acesso no nível do campo. -
Para ver as entradas de registro armazenadas em uma visualização de registros em um bucket de registros:
Acessor de visualização de registros (
roles/logging.viewAccessor
) no projeto, na pasta ou na organização que contém o bucket de registros. Para informações sobre como ter acesso somente 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 seguintes:
- Os recursos que pesquisaram entradas de registro.
- A configuração do intervalo de tempo.
- seus papéis do Identity and Access Management (IAM) nos recursos pesquisados;
- Sua consulta filtra os resultados da pesquisa.
Por exemplo, adicionar a consulta
severity>=ERROR
resulta a tela listando apenas as entradas de registro com nível de gravidade de pelo no mínimoERROR
.
Por padrão, a página Análise de registros pesquisa os recursos listados no escopo de registro padrão para entradas de registro. Se esse escopo não for acessível, a página pesquisa para as entradas de registro originadas no projeto, pasta ou organização. Quando um projeto é selecionado, os resultados da pesquisa incluem o entradas de registro roteadas para o projeto por um coletor em outro projeto, e armazenados em um bucket de registros.
Depois que a página Análise de registros for aberta use o botão Refinar escopo para selecionar os recursos que serão pesquisados. As mudanças feitas usando o botão Refinar escopo se aplica somente à sua sessão atual.
Interface do Explorador de registros
Na interface da Análise de registros, é possível exibir entradas de registros, e especificar parâmetros de consulta.
A Análise de registros contém as seções a seguir, detalhadas sobre nesta página:
- Barra de ferramentas Ação
- Painel Query
- Barra de ferramentas de resultados
- Painel Campos de registro
- Histograma
- Painel Resultados da consulta
Barra de ferramentas Ação
Com os recursos da barra de ferramentas Ação, você pode fazer o seguinte:
- Refinar escopo: configure quais recursos serão pesquisados para entradas de registro. A consulta filtra os resultados da pesquisa. Para mais informações, consulte Refinar escopo.
- Saiba mais: veja links para documentação e tópicos relevantes.
- Compartilhar link: crie um URL encurtado da consulta e
copiá-la para a área de transferência, facilitando o compartilhamento de uma consulta.
O URL copiado tem o intervalo de tempo absoluto correspondente representado pelo campo
período da consulta. por exemplo,
7:49:37 PM - 8:49:37 PM
.
Refinar escopo
Quando você abre a página Análise de registros, ela busca as entradas de registro
originadas no recurso que você selecionou e
que você tem permissão para visualizar.
Para projetos do Google Cloud, a busca
as entradas de registro também incluem aquelas roteadas para o projeto por um coletor
em outro projeto.
Se você inserir uma consulta, a Análise de registros exibirá apenas o
buscadas entradas de registro
que também correspondem à consulta.
Por exemplo, adicionar a consulta severity>=ERROR
resulta
a tela listando apenas as entradas de registro com nível de gravidade de pelo
no mínimo ERROR
.
Para a sessão atual, é possível configurar quais recursos o Explorador de registros pesquisa para entradas de registro usando o menu Refine scope. Por exemplo, ao resolver problemas, é possível examinar apenas as entradas de registro incluídas em um visualização de registros ou de um projeto específico do Google Cloud.
O menu Refinar escopo permite pesquisar pelo projeto, por visualização de registro ou por escopo de registro:
Para pesquisar pelo projeto, pasta ou organização selecionada com no seletor de projeto, expanda o menu Refinar escopo e Selecione Projeto atual.
Para todos os recursos, os resultados da pesquisa incluem as entradas de registro que se originam no recurso. Para projetos do Google Cloud, a pesquisa resultados também incluem as entradas de registro roteadas para o por um coletor em outro projeto.
Para pesquisar visualizações de registros, expanda o menu Refinar escopo, selecione Visualização de registros. e selecione uma ou mais visualizações de registros no menu.
Quando um projeto é selecionado com o seletor, o menu lista visualizações de registros em buckets de registros armazenados pelo projeto selecionado. No entanto, quando uma pasta ou organização estiver selecionada, o menu listará todos visualizações de registros que armazenam entradas originadas nesses recursos.
Para modificar o menu de visualização de registros e incluir visualizações de registros em buckets de registro armazenados em um projeto, clique em add_circle Importar projeto e selecione o projeto.
Para pesquisar os recursos incluídos em um escopo de registro, que pode incluir projetos e visualizações de registro, expanda o menu Refine scope, selecione Log scope e escolha um escopo de registro.
Para configurar os escopos de registro, clique em Gerenciar escopos. Para mais informações, consulte Criar e gerenciar escopos de registro.
Os escopos do registro estão no Acesso antecipado.
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 intervalo de tempo para as entradas de registro que você quer acessar. Para mais informações, consulte Usar o seletor de intervalo de tempo.
Caixa de texto de pesquisa: encontre entradas de registro que correspondam aos seus termos ou frases de pesquisa. Para mais detalhes, consulte Pesquisar texto nos campos de registro.
Menus de filtro: crie consultas com base em Recurso, Nome do registro e Gravidade. Para mais informações, consulte Use os menus de filtro.
Campo do editor de consultas: crie consultas avançadas usando a linguagem de consulta do Logging. Para mais detalhes, consulte Criar consultas avançadas.
Guia Recentes: confira as consultas que você executou recentemente. Para mais informações, consulte Use consultas recentes.
Guia Salvas: visualize suas consultas salvas e consultas que outros usuários do projeto do Google Cloud compartilharam com você. Para mais informações, consulte Salvar consultas e Compartilhar consultas.
Guia Suggested: confira as consultas sugeridas com base nos recursos do seu projeto do Google Cloud. Para mais informações, consulte Use as consultas sugeridas.
Guia Biblioteca: confira e execute consultas fornecidas pelo Google com base nos seus casos de uso. Para mais informações, consulte Selecionar consultas da biblioteca.
Salvar: salva as consultas que podem ser visualizadas e executadas na guia Salvos. .
Limpar consulta: limpe e redefina as seleções feitas ao criar uma no painel Consulta.
Fazer streaming de registros: confira as entradas de registro conforme o Logging as armazena em buckets de registro. Para saber mais, consulte Fazer streaming de registros.
Executar consulta: execute as consultas depois de criá-las no Painel Consulta.
Se você não encontrar o campo do editor de consultas, ative a opção Mostrar consulta. Se você adicionar termos de pesquisa na caixa de texto da pesquisa, esses termos também aparecerão na query-editor e são avaliadas como parte da expressão da consulta.
Depois de revisar sua consulta, clique em Executar consulta. Registros correspondentes sua consulta são listadas no painel Resultados da consulta. O Painéis Histograma e Campos de registro também se ajustam de acordo com a expressão da consulta.
Fazer streaming de registros
É possível fazer streaming de registros, já que o Logging os armazena em buckets de registro, ou adicionar uma consulta para transmitir apenas os registros que correspondem à consulta.
Para fazer streaming de registros com base em uma consulta, adicione uma consulta ao painel Consulta e selecione Fazer streaming de registros. Como o Logging armazena os dados de registros em buckets de registros, apenas os registros que correspondem à consulta são 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 Parar streaming ou role dentro do Painel Resultados da consulta.
Barra de ferramentas Resultados
Na barra de ferramentas Resultados, você tem as seguintes opções:
- toggle_off Campo de registros: mostra ou oculta o painel Campo de registros do layout da página do Explorador de registros. Para mais informações, consulte a seção Campo de registros deste documento.
- toggle_off Histograma: mostrar ou ocultar o painel Histograma no layout da página da Análise de registros. Para mais informações, consulte a Histograma deste documento.
- manage_search Analisar resultados: agregue e crie um gráfico com seus resultados da consulta usando a Análise de dados de registros. Isso só ficará visível se o escopo selecionado contiver um bucket de registros que foi atualizado para usar a Análise de dados de registros. Para mais informações, consulte a seção Analisar resultados deste documento.
- add_chart Criar métrica: configure uma métrica com base em registros.
- add_alert Criar alerta: configure um política de alertas com base em registros.
- Ir para agora: 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 horário de uma hora. Caso contrário, ele será atualizado com a data ou a duração de início atual e vai 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 políticas de alertas com base em registros ou criar um coletor.
Analisar resultados
É possível agregar, analisar e criar gráficos com dados de registros usando consultas SQL. na página Análise de dados de registros quando seu projeto tiver buckets de registros que para usar a Análise de dados de registros. Para acessar a página "Análise de registros" no Explorador de registros, clique em manage_search Analisar resultados na barra de ferramentas Resultados.
O botão manage_search Analisar resultados fica visível somente quando o escopo selecionado contém um bucket de registros que foi atualizado para usar a Análise de dados de registros. Por exemplo, se você selecionou Visualização de registros usando o botão Refinar escopo e o manage_search O botão Analisar resultados aparece quando há pelo menos um bucket no armazenamento é atualizado para usar a Análise de dados de registros. Para mais informações, consulte Faça upgrade de um bucket de registros para usar a Análise de dados de registros.
O seguinte ocorre quando você clica em manage_search Analisar resultados:
O período na Análise de registros pode ser ajustado automaticamente se há dados de registro significativos na página Análise de dados de registros.
A página Análise de dados de registros é aberta em uma nova guia e traduz automaticamente consulta da linguagem de consulta atual do Logging em uma consulta SQL.
O recurso escolhido pelo seletor de projetos do Google Cloud e o valor do A configuração Refinar escopo determina como a cláusula
FROM
na consulta SQL é construída. O recurso selecionado pode ser um projeto, pasta ou organização:Quando o menu Refinar escopo lista Projeto, os buckets
_Required
e_Default
do recurso são consultados.Quando o menu Refinar escopo lista Visualizar, o registro exibe buckets de registro do projeto atual são consultados. As visualizações de registros em buckets de registros armazenados por recursos diferentes são ignoradas.
- Quando a configuração Refinar escopo lista o nome de um escopo de registro, o item anterior sejam aplicadas aos recursos listados na configuração escopo de registros. Por exemplo, se o escopo tiver visualizações de registros, apenas os visualizações de registros em buckets de registros armazenados pelo recurso são consultadas. Os escopos do registro estão no Acesso antecipado.
Na página Análise de dados de registros, é possível conferir os resultados ou como um gráfico. Na guia Gráfico, é possível selecionar os dados exibidos no gráfico, personalizar a configuração ou salvar um gráfico em um painel personalizado. Para informações sobre como criar gráficos a partir dos resultados da sua consulta e salvar gráficos no um painel personalizado, consulte Gráfico com os resultados da consulta com a Análise de dados de registros.
Para mais informações sobre como usar o SQL para escrever consultas, veja 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 entradas de registro corrompidas de acordo com dimensões diferentes, que correspondem aos campos dessas entradas.
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 exibe a contagem de entradas de registro para cada dimensão compatível. 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 locais e de nuvem híbrida, e selecione o tipo de recurso Nó genérico.
Severity
Se você quiser que sua consulta filtre por vários níveis de gravidade, use o menu Gravidade.
Você pode encontrar uma dimensão Serviço:
Se você tem registros com o tipo de recurso Contêiner do Kubernetes, Se você não filtrou seus registros por tipo de recurso, o menu Serviço 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 exibida como resultado da consulta, o menu de serviços vai 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 do Recurso auditado, o menu Serviço será preenchido. As entradas deste menu são determinados dinamicamente pelos valores do rótulo
service
do recurso.
Outras dimensões, como ID do projeto, são listadas com base no seleções Por exemplo, a dimensão ID do projeto aparece restringe as entradas de registro àquelas cujo tipo de recurso é Kubernetes Container, ou quando você selecionou 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 título Gravidade, o
no painel de consulta foi atualizado para incluir severity=ERROR
.
A captura de tela a seguir ilustra o campo do editor de consultas após um erro e o tipo de recurso foram selecionados no painel Campos de registro:
Para remover uma seleção, clique em Limpar X.
Adicionar campos no painel Campos de registro
É possível adicionar determinados pares de chave-valor LogEntry
ao painel Campo de registro
nas entradas de registro preenchidas no painel Resultados da consulta. Por exemplo:
se você costuma filtrar pelo valor do campo jsonPayload.message
, então:
adicione-o ao painel Campo "Registros".
Para adicionar um campo ao painel Campo de registro, faça o seguinte:
No painel Resultados da consulta, expanda uma entrada de registro clicando em chevron_right Expandir.
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
:
Histograma
No painel Histograma, é possível visualizar a distribuição de registros tempo de resposta. O histograma é gerado novamente quando você executa uma consulta, o que facilita a visualização de tendências nos dados de registros e a solução de problemas.
Para mostrar ou ocultar o painel Histograma, clique em Histograma na barra de ferramentas Resultados.
Recursos de Histograma
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.
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.
Linha do tempo: mostra o período dos registros, representado por barras de histograma, que são exibidas nos Resultados da consulta . A linha do tempo ajuda a se orientar para os registros visualizados. no intervalo de tempo maior da 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.
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 em chevron_right Seta para frente deslizar a linha do tempo para um momento posterior. Clique em chevron_left Seta para trás para deslizar a linha do tempo para um momento anterior.
Aumentar e diminuir o zoom: clique 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.
As modificações na linha do tempo são restritas pelo horário atual ("agora") e 30 dias atrás.
Explorar intervalo ou Restringir à data/hora
Além dos controles de tempo listados anteriormente, o histograma 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.
É 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:
Mantenha o ponteiro do mouse sobre uma barra na linha do tempo do histograma. Será exibido um painel com informações resumidas sobre os dados de registros do período especificado.
No painel, selecione Explorar intervalo.
Alternativamente, clicar em uma barra de histograma é equivalente a selecionar Rolar para o momento.
O recurso Restringir à data/hora é semelhante à função Explorar intervalo, mas executa uma consulta nos dados de registros com base no período capturado por um histograma selecionado. Quando você seleciona o recurso Restringir à data/hora, acontece o seguinte:
- Os dados de registros que você vê no painel Resultados da consulta são recarregados e restritos de acordo com o intervalo de tempo capturado pela barra de histograma selecionada.
- O URL do console é atualizado para incluir o
timestamp
do registro mais recente capturado pelo intervalo de tempo da barra de histograma selecionada. - O histograma muda para mostrar somente os registros que têm um
timestamp
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:
Mantenha o ponteiro do mouse sobre uma barra na linha do tempo do Histograma. Será exibido um painel com informações resumidas sobre os dados de registros do período especificado.
No painel, selecione Restringir à data/hora.
Resultados da consulta
Para conferir os resultados das consultas, use o painel Resultados da consulta. Para ajudar a resolver problemas dos seus aplicativos, confira os detalhes entradas de registro individuais e agrupar e analisar entradas de registro seus registros.
Configure a coluna Data/hora.
A coluna Hora no painel Resultados da consulta exibe os carimbos de data/hora de as entradas de registro. É possível personalizar a coluna Data/hora para que apenas algumas partes do carimbo de data/hora são 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 arrow_drop_down Opções de tempo adicionais na coluna Tempo 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
Imagine que você está analisando as entradas de registro nos resultados da consulta e quer
procurar rapidamente os resultados por um determinado campo LogEntry
. Ou talvez
você quer agrupar suas entradas de registro por determinado par de campo/valor. Você pode adicionar
campos de resumo aos resultados, que aparecem como ícones no início de cada
linha de entrada de registro. Por exemplo, a imagem a seguir mostra os resultados da consulta com o
campo de resumo resource.type
adicionado a cada linha de entrada de registro:
A Análise de registros tem campos de resumo padrão e personalizados.
Os campos de resumo padrão dependem dos resultados atuais da consulta.
permite selecionar qualquer campo na LogEntry
.
Para ocultar os campos de resumo nos resultados da consulta, use o método toggle_off Botão de ativação dos 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 é truncada para caber em uma linha. Para mostrar até 10 linhas para cada entrada de registro, use o botão de alternância toggle_off Unir linhas. Espaços em branco são preservados em cada entrada de registro.
Para ocultar campos de resumo específicos, ative os Campos de resumo e clique em Ocultar campo de resumo.
Para modificar os campos de resumo, faça o seguinte:
Clique no botão edit Editar na coluna Resumo para abra o menu de edição.
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.
A seleção do campo de resumo tem os seguintes recursos:
- Preencha automaticamente usando os registros exibidos nos resultados da consulta.
- Correção de campo para caracteres aceitos entre aspas.
Por exemplo, se você digitar
jsonPayload.id-field
, ele será alterado parajsonPayload."id-field"
.Você também pode selecionar qualquer campo
LogEntry
, independentemente do se ela é sugerida a você com a 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 encurtar a exibição dos valores do campo de resumo, use o método Botão toggle_off ao lado de Truncar campos de resumo personalizados. Você pode escolher quantos caracteres exibir antes que o campo seja truncado e se o início ou o fim do campo está exibidos.
Ocultar ou mostrar campos de resumo padrão:
Para personalizar quais campos de resumo padrão são mostrados nos resultados da consulta, expanda o menu Ocultar ou mostrar campos de resumo padrão.
Clique em Aplicar.
Seus campos de resumo foram atualizados nos resultados da consulta.
Pesquisar os resultados da consulta
Para pesquisar o conteúdo dos Resultados da consulta, clique em Encontrar nos resultados. no painel Resultados da consulta e digite o termo de pesquisa. 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:
Ver entradas de registro semelhantes
Você pode 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 à seguinte e recarrega a resultados da consulta:
--Show similar entries protoPayload.methodName="io.k8s.core.v1.configmaps.update" --End of show similar entries
Para visualizar as entradas de registro semelhantes, faça o seguinte:
No painel Resultados da consulta, em uma entrada de registro, clique em chevron_right Expandir.
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, 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:
Oculte grandes quantidades de entradas de registro agrupadas automaticamente. Quando você executar uma consulta, os resultados dela serão analisados e as entradas de registro são automaticamente agrupadas com base em tipos do campo de conteúdo.
Se um padrão significativo for detectado, um banner aparecerá na Painel Resultados da consulta mostrando a porcentagem de resultados que pode ser escondidos:
Ocultar entradas semelhantes: esse botão adiciona uma cláusula à consulta e atualiza os resultados da consulta.
Visualizar: outra janela é aberta descrevendo o padrão encontrado. mostra exemplos das entradas.
Quando você oculta registros semelhantes, nenhuma informação é salva fora da Sessão da Análise de registros. Cada consulta produz uma nova análise, baseada apenas nos registros mostrados. Diferentes consultas analisam partes diferentes da entradas de registro, dependendo dos tipos de registros retornados.
Oculte entradas de registro semelhantes a uma entrada de registro específica. Para ocultar entradas de registro semelhantes a uma entrada de registro, faça o seguinte:
Na 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. Entradas de registro semelhantes à entrada de registro selecionada não serão exibidos.
Exibir 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
.O menu a seguir será exibido:
Selecione Mostrar entradas correspondentes ou Ocultar entradas correspondentes.
A consulta é atualizada com uma consulta que mostra ou oculta entradas semelhantes, e o Os resultados da consulta são atualizados com novos resultados.
Fixar entradas de registro
Depois de executar uma consulta, você pode destacar uma entrada de registro fixando-a. A imagem fixada entrada de registro permanece centralizada no painel Resultados da consulta. Se você executar uma nova consulta e a entrada de registro fixada não for incluída, você vai precisar liberar o registro entrada.
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 é escurecido, e uma
push_pin O ícone Fixar está sendo exibido. Um ícone de alfinete
também aparece no painel Histograma com base na timestamp
da entrada de registro fixada:
Para liberar uma entrada de registro, clique no ícone de fixação novamente.
Mostrar registros que correspondem ao recurso de uma entrada de registro fixada
Depois de fixar uma entrada de registro, você pode executar uma nova consulta que exibe as entradas de registro que correspondem ao tipo ou aos rótulos de recurso do registro fixado.
Para fixar uma entrada de registro e exibir entradas que correspondam ao mesmo tipo de recurso ou rótulos de recursos, faça o seguinte:
Clique na arrow_drop_down seta para baixo ao lado do registro fixado para expandir o menu de fixação.
Escolha uma opção no menu "Fixar":
Para executar novamente a consulta com o mesmo
resource.type
como com um registro fixado, selecione Same resource.type.Por exemplo, suponha que você fixe uma entrada de registro com um
resource.type
dek8s_node
. Se você selecionar Same resource.type, a consulta será executar novamente para exibir todas as entradas de registro comresource.type="k8s_node"
.Para executar novamente a consulta com o mesmo
resource.labels
como fixado, selecione Same resource.labels.
- Para executar novamente a consulta com o mesmo
trace
fixada. 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.
Usando o painel Histograma, 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 à entrada de registro: restrinja o período em que o O painel Histograma exibe e refine sua consulta para isolar as próximos ao registro fixado.
Visualizar dados de trace
Quando uma entrada de registro contém o campo relacionado a latência e trace
, os
ícones de latência e trace são exibidos.
Quando uma entrada de registro contém apenas o campo trace
, somente o ícone de trace é exibido.
Para visualizar os dados de trace relacionados à entrada de registro, clique no ícone de trace. Você tem as seguintes opções:
- Visualizar detalhes do trace: mostra o período pai e os traces filhos, além de detalhes sobre o trace. Para ver mais detalhes sobre o trace, clique em Ver no Trace para navegar até ele. Para mais informações sobre o conteúdo no painel de detalhes, consulte Encontrar e explorar traces.
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.
Copiar um link em uma entrada de registro
Para compartilhar um link em um registro, expanda uma entrada de registro e selecione Copiar link. O link será copiado para a área de transferência. Você pode 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.
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:
Clique em save_alt Download na barra de ferramentas para Painel Resultados da consulta.
Na caixa de diálogo Fazer o download de registros, selecione o formato CSV ou JSON e Clique em Fazer o download.
Selecione o que fazer com os dados do registro. Você tem as seguintes opções:
- Fazer o download dos dados para o computador.
- Fazer o download dos dados para o Google Drive.
- Ver os dados em uma nova guia.
Ao salvar um CSV e selecionar o Google Drive, você pode abrir o arquivo no Planilhas Google.
Para informações sobre solução de problemas, consulte Falha no download dos registros.
Exemplo de consultas
Para consultas sugeridas, organizadas por produto e caso de uso do Google Cloud, consulte Exemplos de consultas usando a Análise de registros. Por exemplo, é possível executar pipelines de consultas 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
, vai aparecer o nome do recurso com o ID dele como subtexto
vários locais na Análise de registros. Por exemplo, para gce_instance
tipo de recurso, verá o nome da VM ao lado do ID da VM. Os nomes dos recursos ajudam
você identifica o ID correto do recurso para criar consultas.
Você pode encontrar nomes de recursos do Compute Engine nos seguintes locais:
- Menus de filtro do painel Consulta: Compute Engine os tipos de recursos mostram nomes de recursos, com seus IDs de recursos correspondentes, como subtexto.
- Campos de registro: tipos de recursos do Compute Engine Mostrar 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, os
O campo
resource.labels
mostra metadados com o nome de recurso correspondente. - Campos de resumo: para instâncias de VM do Compute Engine registros, o ícone mostrará o nome do recurso em vez do ID.
Resolver problemas
Nesta seção, fornecemos instruções para solucionar problemas comuns ao usar o Explorador de registros.
Se você tiver problemas ao tentar visualizar registros nos destinos dos coletores, faça o seguinte: consulte Resolver problemas de roteamento e coletores.
Falha no download de registros
Você está usando a Análise de registros e clica save_alt Fazer o download. O comando é iniciado, mas não é concluído ou informa um erro.
Para resolver esse problema, reduza o tempo de execução do comando. Tente o seguinte:
- Na caixa de diálogo Fazer o download de registros, reduza o valor do Máximo de entradas de registro.
- Reduza o período em que os registros são consultados.
- Na barra de ferramentas de resultados da consulta, clique em Ocultar entradas semelhantes antes de inicie o download.
- Modifique sua consulta para usar campos indexados.
Não foi possível encontrar os registros do console em uma instância de VM
Os registros gravados no console de uma instância do Compute Engine podem não estar disponíveis na Análise de registros. Para ver esses registros, faça o seguinte:
-
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.
Você pode configurar suas instâncias de modo que a saída da porta serial seja enviados ao Cloud Logging. Para mais informações, consulte Como ativar e desativar a geração de registros de saída da porta serial.
Receber projeto do Google Cloud ou ID da organização
Para receber um projeto do Google Cloud ou um ID da organização de qualquer lugar do no console do Google Cloud, abra a lista de projetos do Google Cloud Seletor de projeto e organização do Google Cloud e encontre a 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 que haja é a atividade nesses recursos. Mesmo que o projeto do Google Cloud novo, ele precisa ter registros de auditoria que registrem a criação dele. Para mais informações sobre como verificar se um recurso gera registros, consulte Como mapear serviços para tipos de recursos.
O período não pode ser muito curto.
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 visualizar as entradas de registro nos projetos e visualizações de registros 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 definido muito grande e não pôde ser concluído dentro de um prazo razoável período. 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ê fizer uma consulta em um recurso sem especificar um bucket,
O Cloud Logging usa 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 identifica mais de 200 buckets
pode ter sido gravado, 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 linha do tempo do histograma usando os controles de tempo ou as seletor de intervalo de tempo. Ajustar esses controles de hora não altera a expressão de consulta 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 de observabilidade do Google Cloud.