Ver registros usando o Explorador de registros

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. Também é possível ler dados de registro usando a API Logging e a CLI do Google Cloud.

Para realizar operações agregadas nas entradas de registro, como contar o número de entradas de registro que contêm um padrão específico, faça upgrade do bucket de registro para usar a Análise de Registros e execute consultas na página Análise 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 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 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 registro: Logs Field Accessor (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 campos LogEntry, 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 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:

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

2. 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 pesquisados para entradas de registro.
   • A configuração do intervalo de tempo.
   • seus papéis do Identity and Access Management (IAM) nos recursos pesquisados;
   • A 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 menos ERROR.

   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 vai pesquisar as entradas de registro que se originam do projeto, da pasta ou da organização selecionada. 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, você poderá selecionar quais recursos são pesquisados em entradas de registro pela Análise de registros. As mudanças feitas usando o menu Refine scope se aplicam apenas à 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 os seguintes , que são detalhadas nesta página:

1. Barra de ferramentas principal
2. Painel Query
3. Painel Campos de registro
4. Cronograma
5. Barra de ferramentas de resultados da consulta
6. Painel Resultados da consulta

Barra de ferramentas principal

Com a barra de ferramentas principal, você pode fazer o seguinte:

• Biblioteca de consultas: ver as opções salvas, recentes e sugeridas consultas. Para mais informações, consulte Salvar consultas e Compartilhar consultas.
• 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.
• Preferências: ajuste a visualização da página "Análise 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 intervalo de tempo: especifique um intervalo de tempo para as entradas de registro que você que você quer visualizar. Para mais informações, consulte usar o seletor de período.
• Fazer streaming de registros: visualizar as entradas de registro conforme o Logging as armazena buckets de registros. Para mais informações, consulte Fazer streaming de registros.
• Aprender: confira links para documentos e tópicos relevantes.

Observação: caso seus dados sejam gerenciados por meio de uma Ambiente Assured Workloads, esse recurso pode ser afetado ou restrito. Para mais informações, consulte Restrições e limitações no Assured Workloads.

Visualizar consultas recentes, salvas e sugeridas

Para visualizar as consultas que você executou recentemente e as que salvou uso futuro e consultas sugeridas, clique no botão Botão Biblioteca de consultas.

Na guia Biblioteca de consultas, é possível ver:

• Consultas recentes: confira as consultas que você fez recentemente. Para mais informações, consulte Usar consultas recentes.

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

• Consultas sugeridas: confira as consultas sugeridas com base nos recursos do seu projeto do Google Cloud. Para mais informações, consulte Use as consultas sugeridas.

• Consultas fornecidas pelo Google Cloud: visualizar consultas fornecidas pelo Google Cloud com base em casos de uso comuns de vários serviços do Google Cloud. Para mais mais informações, consulte Selecionar consultas da biblioteca.

Definir preferências para visualizar dados de registro

Para personalizar como seus dados de registro são apresentados nos resultados da consulta, clique no Preferências e selecione Visualizar, Formatar ou Gerenciar campos de resumo:

• Para mostrar ou ocultar os painéis Linha do tempo e Campos de registro, ocultar os ícones de resumo nos resultados da consulta ou alterar 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 Data/hora.

• 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 em uma única 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 Encontre padrões nos seus registros usando os 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 algumas partes do carimbo de data/hora são visíveis. Isso cria mais espaço horizontal para que confira mais informações na entrada de registro.

Para selecionar quais partes do carimbo de data/hora serão exibidas, clique no menu 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 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.

A Análise de registros tem campos de resumo padrão e personalizados. Os campos de resumo padrão dependem dos resultados da consulta atual e das opções permite selecionar qualquer campo na LogEntry.

Para mostrar ou ocultar todos os ícones de campo de resumo nos resultados da consulta, clique no botão 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:

1. Clique no botão Preferences e selecione Manage summary fields.

2. Na caixa de diálogo Gerenciar campos de resumo, é possível fazer o seguinte:

   • Adicione qualquer nome de campo personalizado aos 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 é alterado para jsonPayload."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 alternância 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.

     Dica: para mostrar o valor completo de um campo de resumo, mantenha o ponteiro do mouse sobre um campo de resumo truncado nos resultados da consulta.

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

3. Clique em Aplicar.

   Seus campos de resumo foram atualizados nos resultados da consulta.

Exibir registros por intervalo de tempo

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 keyboard_tab Ir para agora.

Fazer streaming de registros

É possível fazer streaming dos registros O Logging as armazena em buckets de registro, ou é possível adicionar uma consulta transmite apenas os registros que correspondem à consulta.

Para transmitir registros com base em uma consulta, adicione uma consulta no painel Consulta e 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 Parar transmissão ou role a tela manualmente para pausar.

Painel Consulta

Para criar uma consulta na Análise de registros, use o painel de consultas. No painel de consulta, é possível criar e refinar consultas usando os seguintes recursos:

• Pesquisar todos os campos: encontre entradas de registro que correspondam a termos ou frases de pesquisa. Todos os termos de pesquisa adicionados ao campo Pesquisar todos os campos são adicionados a campo do editor de consulta e são avaliadas como parte da expressão de consulta. Para mais informações, consulte Pesquisar texto em campos de registro.

• Menus de filtro: crie consultas usando vários menus para selecionar recursos. nomes de registros, 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 vir o campo do editor de consultas, ative Mostrar consulta. Para mais informações, consulte Escrever consultas avançadas usando a linguagem de consulta do Logging.

  Observação :a Análise de registros adiciona implicitamente o restrição conjuntiva, AND, entre as instruções mostradas no painel de consulta. Por exemplo, se a linha um for resource.type = "gce_instance" e a linha dois for severity >= "ERROR", a consulta será resource.type = "gce_instance" AND severity >= "ERROR" Se você quiser usar uma consulta mostrada pela Análise de registros em outro contexto, por exemplo, para o filtro de inclusão ou exclusão de um coletor, será preciso modificar a consulta e adicionar as restrições conjuntivas. Para mais informações, consulte a documentação da linguagem de consulta do Logging.

Depois de analisar a consulta, clique em Executar consulta. Registros correspondentes sua consulta são listadas 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 os recursos pesquisados para entradas de registro

Quando você abre a página Logs Explorer, ela busca as entradas de registro originadas no recurso selecionado e que você tem permissão para visualizar. Para projetos do Google Cloud, as entradas de registro recuperadas também incluem aquelas que são roteadas para o projeto por um sink 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.

Observação: para configurar quais recursos são pesquisados quando a página Análise de registros é aberta, defina o escopo de registro padrão. Para mais informações, consulte Criar e gerenciar escopos de registro.

Na sessão atual, você pode configurar quais recursos o A Análise de registros procura entradas de registro usando o comando Refinar escopo . 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, os resultados da pesquisa também incluem as entradas de registro que são roteadas para o projeto por um sink 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.

  Observação: use essa configuração quando quiser conferir as entradas de registro roteadas por um coletor agregado.

  Quando um projeto é selecionado com o seletor de projetos, o menu lista as visualizações de registro nos buckets de registro armazenados pelo projeto selecionado. No entanto, quando uma pasta ou organização é selecionada, o menu lista todas as exibições de registro que armazenam entradas de registro 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 Importar projeto e selecione o projeto.

• Para pesquisar os recursos incluídos em um escopo de registros, que podem incluir projetos e visualizações de registros, expanda o menu Refinar escopo. Selecione Escopo do registro e escolha um escopo.

  Para configurar os escopos de registro, clique em Gerenciar escopos. Para mais informações, consulte Criar e gerenciar escopos de registro.

  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 de executar a consulta no campo do editor de consultas, o painel Campos de registro é preenchido com base nos resultados. 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.

Talvez você veja uma dimensão Serviço:

• Se você tiver registros com o tipo de recurso Contêiner do Kubernetes e não tiver filtrado os registros por tipo de recurso, o menu Serviço será preenchido. As entradas deste menu são são determinadas dinamicamente pelos valores Marcador k8s-pod/app.

  Por exemplo, se uma entrada de registro semelhante à seguinte for mostrada 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 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 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.

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:

1. No painel Resultados da consulta, clique em Expandir esta entrada de registro para abrir uma entrada de registro.

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

Cronograma

Observação: cada elemento da linha do tempo exibe o número aproximado de entradas de registro recebidas no intervalo de tempo associado ao elemento. Para ter uma contagem exata do número de entradas de registro recebidas em um intervalo de tempo, usar a Análise de dados de registros ou copiar os registros para um bucket do Cloud Storage.

No painel Cronograma, você visualiza a distribuição de registros tempo de resposta. A linha do tempo é gerada novamente quando você executa uma consulta, facilitando a visualização de tendências nos dados de registros e resolver problemas.

Para mostrar ou ocultar o painel Linha do tempo, clique em keyboard_capslock Fechar linha do tempo.

Recursos de linha do tempo

1. Barras de linha do tempo: cada barra de linha do tempo representa um período. 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 Timeline tem um menu com opções para analisar seus 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. Intervalo de tempo: mostra o intervalo de tempo 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.

Dica :quando você ajusta os controles de tempo da linha do tempo, os dados de registros no Os painéis Resultados da consulta e Campos de registro são ajustados de acordo com o período capturadas pela linha do tempo. Ajustar os controles de tempo da linha do tempo não altera a expressão da consulta no painel Consulta.

Ajustar controles de hora

A linha do tempo fornece controles de tempo que permitem ajustar os dados que que aparecem na Análise 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 em Seta para frente 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 Diminuir zoom para ampliar os dados mostrados na linha do tempo. Clique em Zoom in para restringir os dados mostrados na linha do tempo.

• Ocultar linha do tempo: clique em keyboard_capslock Fechar linha do tempo para ocultar a linha do tempo.

As modificações na linha do tempo são restritas entre o horário atual ("agora") e até 30 dias no passado.

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 barra específica 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 Rolar até o momento para navegar pelos dados de registros sem alterar os valores nos painéis Linha do tempo 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:

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

2. No painel, selecione Explorar intervalo.

   Outra opção é clicar em uma barra da linha do tempo. Isso equivale a selecionar Explorar intervalo.

O recurso Aplicar zoom até o momento é semelhante a Rolar para o tempo, mas executa uma consulta nos dados de registros com base no intervalo de tempo capturado por uma linha do tempo selecionada barra. 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 atualizados e é reduzido de acordo com a restrição de intervalo de tempo da linha do tempo selecionada barra.
• 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 são ajustados de acordo com o período capturadas pela barra de linha do tempo selecionada.

Para selecionar o recurso Restringir à data/hora, faça o seguinte:

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

2. 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:

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

• Ações: selecione entre várias opções para analisar melhor os dados dos registros:

  • ink_highlighter Destacar nos resultados: insira o texto que será destacado nos resultados da consulta.
  • Criar métrica: configure uma métrica com base em registros.
  • Criar coletor: crie um coletor de registros que preenche automaticamente o filtro de inclusão do coletor com a consulta atual expressão.
  • Criar alerta de registro: configure um política de alertas com base em registros.
  • Gerenciar alertas: confira e gerencie as políticas de alertas.
  • Download: faça o download dos seus registros em formato CSV ou JSON. Para mais informações, consulte Fazer o download de registros.

Analisar resultados

É possível agrupar, analisar e criar gráficos com os dados de registros usando consultas SQL na página Análise de dados de registros quando o projeto contém buckets de registros que foram atualizados para usar a Análise de dados de registros. Para acessar a página "Análise de dados de registros" em "Análise de registros", na barra de ferramentas Resultados, clique em Analise os resultados.

O botão 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 registro usando o menu Refinar escopo, o botão Analisar resultados é mostrado quando pelo menos um bucket no escopo de armazenamento é atualizado para usar a Análise 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 Analisar resultados:

• O intervalo de tempo no Logs Explorer pode ser ajustado automaticamente para que haja 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 registro em buckets 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 do registro tiver visualizações de registro, 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.

  Observação: o Log Analytics não oferece suporte a consultas entre projetos ou regiões. Quando a configuração Refinar escopo inclui entradas de registro armazenadas em vários projetos ou regiões, a Análise de dados de registros poderá mostrar entradas de registro diferentes da página Análise de registros.

Na página da Análise de dados de registros, você pode conferir os resultados em formato tabular 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.

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. Este filtro permite que você encontre informações nas entradas de registro sem criar uma nova consulta.

Os termos que correspondem aos critérios de pesquisa são destacados nas entradas de registro no painel Resultados da consulta:

Download de registros

Observação: esse recurso não oferece suporte para o download em massa de entradas de registro. Você pode pode fazer o download de até 10.000 entradas de registro, consultar os registros e fazer com que o download possa ser concluído dentro do tempo limite do kubectl. É possível copiar registros em massa para um do Cloud Storage.

É 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. No menu Ações do painel Resultados da consulta, clique em Fazer o download.

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

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

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

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

Para informações sobre solução de problemas, consulte Falha no download dos registros.

Painel Resultados da consulta

Para ver os resultados das suas 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.

Ver entradas de registro semelhantes

Você pode exibir entradas de registro semelhantes a uma entrada de registro selecionada, você se concentra nos registros de interesse.

Para mostrar entradas de registro semelhantes, faça o seguinte:

1. No painel Resultados da consulta, em uma entrada de registro, clique em Expandir.

2. Clique em Entradas semelhantes e selecione Mostrar entradas semelhantes.

   A consulta é atualizada com 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:

1. No painel Resultados da consulta, em uma entrada de registro, clique em Expandir.

2. Abra o menu Entradas semelhantes e selecione Visualizar entradas semelhantes.

   Uma caixa de diálogo separada é aberta com as seguintes informações:

   • O padrão encontrado
   • A porcentagem de entradas de registro que contêm o padrão
   • Exemplos de entradas de registro que contêm o padrão

   Nessa caixa de diálogo, é possível ocultar ou mostrar as 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ê 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 campos de registro semelhantes.

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

• Ocultar entradas de registro semelhantes a uma entrada específica.

  Para ocultar entradas de registro semelhantes a uma entrada, clique em 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.

Mostrar ou ocultar entradas de registro que correspondem a um campo

É possível exibir ou ocultar entradas de registro que correspondam a um campo em uma entrada de registro, o que permite concentre-se em entradas que tenham o mesmo conteúdo de campo.

Para exibir ou ocultar entradas de registro que correspondam a um campo específico em uma entrada de registro, execute seguintes:

1. No painel Resultados da consulta, na entrada de registro, clique em Expandir.

2. Clique no valor de um campo na entrada de registro, como compute.googleapis.com. que é um serviceName.

3. 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 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, será necessário desafixar a entrada de registro.

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

1. Mantenha o ponteiro do mouse sobre a entrada de registro que você quer fixar.
2. Clique em Marcar.

Depois que você fixa uma entrada de registro, o plano de fundo dela é escurecido, e uma O ícone Fixar está sendo exibido. Um ícone de fixação também aparece no painel Linha do tempo com base no código do item timestamp

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 mostra entradas de registro que correspondem ao tipo de recurso 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:

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

2. Escolha uma opção no menu "Fixar":

   • 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 de k8s_node. Se você selecionar Same resource.type, a consulta será executar novamente para exibir todas as entradas de registro com resource.type="k8s_node".

   • Para executar a consulta novamente com o mesmo resource.labels do registro fixado, selecione Mesmos 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 na Linha do tempo

Use a Linha do tempo para destacar, rolar e examinar melhor uma entrada de registro fixada.

Na Linha do tempo, clique em Fixar. e escolha entre as seguintes opções de menu:

• Rolar até a entrada de registro: coloque a entrada de registro no Resultados da consulta e confira a entrada de registro fixada na de 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 no painel de detalhes, consulte Encontrar e explorar traces.

Observação: o botão Ver detalhes do trace só fica disponível quando traceSampled é verdadeiro.

• 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 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 o link de um registro, expanda uma entrada de registro e selecione Copiar. Você pode optar por copiar um registro em JSON para o registro. O link será copiado para a área de transferência. Você pode enviar o link para 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 produto e caso de uso do Google Cloud, 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, 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.

Os nomes dos recursos do Compute Engine podem aparecer nos seguintes lugares:

• 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: 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ê estiver com problemas para conferir registros em destinos de coletor, consulte Resolver problemas de roteamento e coletores.

Falha no download de registros

Você está usando o Logs Explorer e clica em 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 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 a consulta para usar campos indexados.

Observação: o recurso de download não é destinado ao download em massa de registros. Você É possível copiar registros para um bucket do Cloud Storage.

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 na Análise de registros. Para ver esses registros, faça o seguinte:

1. No Console do Google Cloud, acesse a página Instâncias de VM.

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

2. Selecione a instância e 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.

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

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 se há 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 você usa 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 visualizar as entradas de registro nos projetos e visualizações de registros referenciadas pela configuração do menu Refinar escopo. Para mais informações sobre como ajustar o escopo da sua 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 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 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 do Google Cloud Observability.