Ver registros usando o Explorador de registros

Este documento oferece uma visão geral da Análise de registros no consoleGoogle Cloud , que pode ser usada para recuperar, visualizar e analisar entradas de registro armazenadas em buckets de registro. Visualizar e analisar entradas de registro individuais e uma sequência delas pode ajudar você a resolver problemas. Também é possível ler dados de registro usando a API Logging e a Google Cloud CLI.

Para realizar operações de agregação nas entradas de registro, como contar o número de entradas que contêm um padrão específico, faça upgrade do bucket de registros 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 usando o Explorador de registros para ver os registros em buckets que foram atualizados para usar a Análise de registros. Para mais informações, consulte Visão geral do Log Analytics.

O restante deste documento descreve como usar o Explorador de registros.

Antes de começar

Para receber as permissões necessárias para usar o Explorador de registros e ver entradas de registro, peça ao administrador para conceder a você os seguintes papéis do IAM:

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 usando papéis personalizados ou outros papéis predefinidos.

Primeiros passos

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

  1. No console 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 Google Cloud projeto, pasta ou organização. Para configurações do App Hub, selecione o projeto host do App Hub ou o projeto de gerenciamento da pasta com app ativado.

    As entradas de registro mostradas na página do Explorador de registros dependem do seguinte:

    • Os recursos pesquisados para entradas de registro.
    • A configuração de período.
    • 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 na exibição de 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. Quando o escopo de registros padrão não está acessível, a página pesquisa as entradas de registro originadas no projeto, pasta ou organização selecionada. Para projetos, os resultados da pesquisa incluem as entradas de registro roteadas para o projeto por um coletor em outro projeto e armazenadas em um bucket de registros.

    Depois que a página Análise de registros for aberta, você poderá selecionar quais recursos serã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, analisar e especificar parâmetros de consulta. O Explorador de registros contém as seguintes seções, detalhadas nesta página:

  1. Barra de ferramentas principal
  2. Painel Consulta
  3. Painel Campos
  4. Linha do tempo
  5. Barra de ferramentas "Resultados da consulta"
  6. Painel Resultados da consulta

Barra de ferramentas principal

Com a barra de ferramentas principal, é possível fazer o seguinte:

  • Biblioteca de consultas: veja consultas salvas, recentes e sugeridas. Para mais informações, consulte Salvar e compartilhar consultas.
  • Compartilhar link: crie um URL encurtado da consulta e copie para a área de transferência, facilitando o compartilhamento. O URL copiado tem o intervalo de tempo absoluto correspondente representado pelo período da sua consulta, por exemplo, 7:49:37 PM - 8:49:37 PM.
  • 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 registros.
  • 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: veja as entradas de registro conforme o Logging as armazena em buckets de registro. Para mais informações, consulte Fazer streaming de registros.
  • Aprender: veja links para documentação e tópicos relevantes.

Ver consultas recentes, salvas e sugeridas

Para ver as consultas executadas recentemente, as consultas salvas para uso futuro e as consultas sugeridas, clique no botão Biblioteca de consultas.

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

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

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

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

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

Definir preferências para visualizar dados de registros

Para personalizar a apresentação dos dados de registros nos resultados da consulta, clique no botão Preferências e selecione Visualizar, Formatar ou Gerenciar campos de resumo:

  • Para mostrar ou ocultar os painéis Linha do tempo e Campos, ocultar chips 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 Formatar. Para mais informações, consulte Configurar a coluna Tempo.

  • Para mostrar até 10 linhas em cada entrada de registro, selecione Formatar e clique em Quebrar 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 registros usando campos de resumo.

Configurar a coluna Data/hora

A coluna Hora no painel Resultados da consulta mostra os carimbos de data/hora das entradas de registro. É possível personalizar a coluna Data/hora para que apenas determinadas partes do carimbo de data/hora fiquem visíveis. Isso cria mais espaço horizontal para que você possa ver mais informações na entrada de registro.

Para selecionar quais partes do carimbo de data/hora serão mostradas, clique no menu Preferências , selecione Formatar 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

Suponha que você esteja analisando as entradas de registro nos resultados da consulta e queira ler rapidamente os resultados por um determinado campo LogEntry. Ou talvez você queira agrupar as entradas de registro por um determinado par campo-valor. É possível adicionar campos de resumo aos resultados, que aparecem como chips no início de cada linha de entrada de registro.

A Análise 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 Preferências, selecione Visualizar e Mostrar ícones de resumo. Quando essa opção está ativada, os resultados são mostrados em 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 Preferências e selecione Gerenciar campos de resumo.

  2. Na caixa de diálogo Gerenciar campos de resumo, você pode fazer o seguinte:

    • Adicione nomes de campos personalizados a Campos de resumo personalizados.

      O campo de resumo é compatível com preenchimento automático e correção de campo para caracteres aceitos entre aspas. Por exemplo, se você digitar jsonPayload.id-field, ele será alterado para jsonPayload."id-field".

      Você também pode selecionar qualquer campo LogEntry, mesmo que ele não seja sugerido com a função de preenchimento automático.

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

    • Ative e desative a truncagem para seus campos de resumo personalizados.

      Para reduzir a exibição dos valores do campo de resumo, use a chave 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 é mostrado.

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

  3. Clique em Aplicar.

    Os campos de resumo agora estão atualizados nos resultados da consulta.

Ver registros por período

Para especificar um período para as entradas de registro que você quer ver, use o seletor de período.

Para fazer uma atualização forçada 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 à medida que o Logging os armazena em buckets de registros ou adicionar uma consulta para transmitir apenas os registros que correspondem a ela.

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. À medida que o Logging armazena os dados de registros em buckets de registros, somente aqueles 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 streaming ou role a tela manualmente para pausar.

Painel Consulta

Para criar uma consulta no Explorador de registros, use o painel de consultas. 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 em todos os campos: encontre entradas de registro que correspondam aos seus termos ou frases de pesquisa. Todos os termos de pesquisa adicionados ao campo Pesquisar em 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 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 o campo do editor de consultas não aparecer, ative 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 à consulta são listados no painel Resultados da consulta. Os painéis Linha do tempo e Campos também se ajustam de acordo com a expressão de consulta.

Selecione quais recursos são pesquisados para entradas de registro

Nesta seção, descrevemos como ver ou mudar quais recursos são pesquisados em entradas de registro. Se você inserir uma consulta, o Explorador de registros vai mostrar apenas as entradas de registro buscadas que também correspondem à consulta. Por exemplo, adicionar a consulta severity>=ERROR resulta na exibição de apenas as entradas de registro com um nível de gravidade de pelo menos ERROR.

Para determinar quais entradas de registro mostrar, a página Análise de registros pesquisa os recursos listados no escopo de registro padrão. Quando o escopo de registros padrão não está acessível, a página pesquisa as entradas de registro originadas no projeto, pasta ou organização selecionada. Quando os projetos são pesquisados, os resultados incluem as entradas de registro roteadas para o projeto por um coletor em outro projeto e armazenadas em um bucket de registros.

Na sessão atual, é possível configurar quais recursos a Análise de registros pesquisa para entradas de registro. Por exemplo, ao solucionar problemas, talvez você queira examinar apenas as entradas de registro incluídas em uma visualização de registros ou originadas em umGoogle Cloud projeto específico.

A barra de ferramentas no painel Consulta mostra os recursos pesquisados entradas de registro:

  • Registros do projeto e _Default: são retornadas entradas de registro originadas no projeto, na pasta ou na organização selecionada. Para projetos, essas entradas de registro incluem aquelas que são encaminhadas ao projeto por um gravador em outro projeto.

  • N visualização de registro: as entradas de registro incluídas nas N visualizações de registro são retornadas. É possível expandir o menu para listar as visualizações de registros.

  • my-custom-scope, em que "my-custom-scope" é o nome de um escopo de registros personalizado: se um escopo de registros listar visualizações de registros, 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 registros.

Para mudar quais recursos são pesquisados em entradas de registro, faça o seguinte:

  1. Acesse a barra de ferramentas do painel Consulta. Essa barra de ferramentas mostra um menu com um rótulo como um dos seguintes:

    • Registros do projeto
    • Visualização de registro N
    • my-custom-scope

    Selecione o menu.

  2. No menu suspenso Refinar escopo, selecione o local de armazenamento e conclua a caixa de diálogo.

    As informações a seguir podem ajudar você a preencher a caixa de diálogo:

    • Quando quiser ver as entradas de registro roteadas por um coletor agregado, selecione Visualização de registros como o local de armazenamento. Em seguida, selecione todas as visualizações de registros que armazenam as entradas que você quer ver.

    • Para pastas e organizações, o menu de visualização de registros lista todas as visualizações que armazenam entradas de registro originadas nesses recursos.

    • Para projetos, o menu de visualização de registros lista as visualizações em buckets de registros armazenados pelo projeto selecionado.

    • Para modificar o menu de visualização de registros e incluir visualizações de registros em buckets de registros armazenados em um projeto específico, clique em  Importar projeto e selecione o projeto.

    • Para configurar um escopo de registros, selecione Escopo de registros e clique em Gerenciar escopos.

Painel Campos

O painel Campos oferece um resumo de alto nível dos dados de registros e uma maneira eficiente de refinar uma consulta. As entradas neste painel também listam o número aproximado de entradas de registro que correspondem ao filtro. Para ter uma contagem exata do número de entradas de registro recebidas em um intervalo de tempo, use a Análise de registros ou copie os registros para um bucket do Cloud Storage.

Depois de executar uma consulta no campo do editor de consultas, o painel Campos é preenchido com base nos resultados da consulta. O painel é dividido nas seguintes seções:

  • Fixados: mostra os campos que você fixou para acesso rápido. Se essa seção não aparecer, isso significa que você não fixou nenhum campo.

  • Metadados do sistema: mostra entradas de registro detalhadas por diferentes dimensões, correspondentes aos campos nas entradas de registro.

  • Payload JSON (mais frequente): mostra os campos json_payload mais frequentes nos resultados da consulta atual.

Na seção Metadados do sistema, 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 sua consulta filtre por vários níveis de gravidade, use o menu Gravidade.

Algumas dimensões são preenchidas dinamicamente com base nos rótulos dos dados de registro. Por exemplo, você pode ver uma dimensão Serviço ou Aplicativo:

  • A dimensão Serviço é mostrada nos seguintes cenários:

    • Você tem dados de registro cujo tipo de recurso é Contêiner do Kubernetes e não filtrou os registros por tipo de recurso. Os valores no rótulo labels.k8s-pod/app contribuem para as entradas na dimensão Serviço.

      Por exemplo, se uma entrada de registro semelhante à seguinte for exibida como resultado da sua 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"
 }
 ...
}

    • Você tem dados de registro com rótulos para um serviço ou uma carga de trabalho do App Hub. Esses rótulos estão no formato apphub.workload.id ou apphub.service.id. Na entrada de registro, eles são mostrados na entrada apphub. Por exemplo, uma entrada de registro pode conter algo como o seguinte:

      apphub: {
 application: {3}
 workload: {
    criticalityType: "MEDIUM"
    environmentType: "STAGING"
    id: "my-workload-id"
 }
}

    • Filtre os dados de registro pelo tipo de recurso Recurso auditado. Os valores no rótulo resource.labels.service contribuem para as entradas na dimensão Serviço.

    • Você tem dados de registro que contêm o rótulo resource.labels.namespace_name ou labels.service.name.

  • A dimensão Aplicativo é mostrada quando os dados de registro contêm um rótulo de ID do aplicativo do App Hub, que tem o formato apphub.application.id. Na entrada de registro, esse rótulo aparece na entrada apphub:

    apphub: {
  application: {
     container: "projects/my-project"
     id: "my-app"
     location: "my-app-location"
  }
  workload: {3}
}

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 àquelas cujo tipo de recurso é Contêiner do Kubernetes ou quando você selecionou uma visualização de registros.

Refine a consulta

Para refinar sua consulta, selecione um valor no painel Campos. 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 ao painel Campos

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

Para adicionar um campo ao painel Campos, faça o seguinte:

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

  2. Selecione o valor de um campo. No menu, selecione Fixar no painel "Campos".

    O campo personalizado aparece no painel Campos como uma lista de pares de chave-valor.

Para remover um campo personalizado do painel Campos, clique em Remover ao lado do campo.

Os seguintes tipos de campo não podem ser adicionados ao painel Campos:

  • 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

Com o painel Linha do tempo, é 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 Fechar linha do tempo.

Recursos da linha do tempo

  1. 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 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. Período: 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.

Ajustar controles de tempo

A linha do tempo fornece controles de tempo que permitem ajustar os dados que aparecem 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 seta para frente para deslizar a linha do tempo para um momento posterior. Clique na seta para trás para deslizar a linha do tempo para um horário anterior.

  • Aumentar e diminuir o zoom: clique em Diminuir zoom para ampliar os dados mostrados na linha do tempo. Clique em Aumentar zoom para restringir os dados mostrados na linha do tempo.

  • Ocultar 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 até 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. É possível que você tenha interesse em ver 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 mudar os valores nos painéis Linha do tempo e Campos. 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 Restringir à data/hora é semelhante à função Explorar intervalo, mas executa uma consulta nos dados de registros com base no período capturado por uma barra de linha do tempo selecionada. 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 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 somente 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 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:

  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 gráficos dos resultados da consulta usando a Análise de dados de registros. Esse botão só fica visível quando o bucket de registros que contém a visualização de registros que você está consultando foi atualizado para usar a Análise 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 de registros:

    • Destacar nos resultados: insira o texto que será destacado nos resultados da consulta.
    • Criar coletor: crie um coletor de registros que preenche automaticamente o filtro de inclusão dele com a expressão de consulta atual.

Analisar resultados

É possível agregar, 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 da Análise de registros no Explorador de registros, clique em Analisar resultados na barra de ferramentas Resultados.

O botão Analisar resultados de só fica visível quando o bucket de registros que contém a visualização de registros consultada é atualizado para usar a Análise de dados de registros. Por exemplo, se a barra de ferramentas mostrar N visualização de registros, o botão Analisar resultados vai aparecer quando o bucket de registros de pelo menos uma das visualizações de registros selecionadas for atualizado para usar a Análise de dados de registros. Para mais informações, consulte Fazer upgrade de um bucket de registros para usar a Análise de dados de registros.

Ao clicar em Analisar resultados, acontece o seguinte:

  • O período na Análise de registros 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 a consulta atual da linguagem de consulta do Logging para uma consulta SQL.

  • O recurso selecionado pelo seletor de projetos Google Cloud e uma configuração da barra de ferramentas determinam como a cláusulaFROMna consulta SQL é construída. O recurso selecionado pode ser um projeto, uma pasta ou uma organização:

    • Se a barra de ferramentas mostrar Registros do projeto ou _Default, os buckets _Required e _Default do recurso serão consultados.

    • Se a barra de ferramentas mostrar N visualização de registros, as visualizações de registros em buckets de registros no projeto atual serão consultadas. As visualizações de registros em buckets de registros armazenados por recursos diferentes são ignoradas.

    • Se a barra de ferramentas mostrar myscope, em que "myscope" é o nome de um escopo de registro personalizado, as regras anteriores serão aplicadas aos recursos listados no escopo de registro selecionado. Por exemplo, se o escopo de registro contiver visualizações de registros, apenas essas visualizações em buckets de registros armazenados pelo recurso serão consultadas.

Na página da Análise de dados de registros, você pode conferir os resultados em formato de tabela ou gráfico. Na guia Gráfico, é possível selecionar os dados que serão representados, personalizar a configuração do gráfico ou salvar um gráfico em um painel personalizado. Para informações sobre como criar gráficos com base nos resultados da consulta e salvar gráficos em um painel personalizado, consulte Representar resultados de consultas com gráficos na Análise de Dados de Registros.

Para informações sobre como usar SQL para escrever consultas, consulte Consultar e visualizar registros na Análise de dados de registros.

Pesquisar nos resultados da consulta

Para pesquisar o conteúdo dos Resultados da consulta, clique em Destacar nos resultados no painel Resultados da consulta e digite o termo de pesquisa. Com ele, você encontra 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:

As entradas de registro com termos de pesquisa correspondentes são destacadas.

Download de registros

Para receber as permissões necessárias para baixar registros, peça ao administrador para conceder a você o papel do IAM de Acessador de visualização de registros (roles/logging.viewAccessor) no seu projeto. Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Esse papel contém a permissão logging.logEntries.download. Você também pode conceder um papel que contenha a permissão logging.logEntries.list, permitindo que um principal veja 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:

  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.
    • 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, será possível abrir o arquivo nas Planilhas Google.

Para informações sobre solução de problemas, consulte O download de registros falha.

Painel Resultados da consulta

Para ver 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 das entradas de registro individuais, além de agrupar e analisar essas entradas para encontrar padrões nos registros.

Ver entradas de registro semelhantes

É possível ver entradas de registro semelhantes a uma entrada de registro selecionada, o que permite concentrar-se nos registros de interesse.

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

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

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

    A consulta é atualizada com uma consulta semelhante à seguinte e recarrega os resultados:

    --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, clique em Expandir em uma entrada de registro.

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

    A caixa de diálogo "Visualizar entradas de registro" permite ocultar ou mostrar entradas semelhantes.

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 semelhante do campo de registro.

    Se um padrão significativo for detectado, um banner vai aparecer no painel Resultados da consulta mostrando a porcentagem de resultados que podem ser ocultados.

    Ocultar entradas semelhantes: esse botão adiciona uma cláusula à consulta e recarrega os resultados dela.

    Visualização: uma janela separada é aberta com a descrição do padrão encontrado e exemplos das entradas.

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

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

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

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:

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

  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, é possível 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 estiver incluída, será solicitado que você desfixe a entrada.

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 fica escuro e um ícone Fixar é exibido. Um ícone de alfinete também aparece no painel Linha do tempo com base no 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, é possível executar uma nova consulta que mostre as entradas de registro que correspondem ao tipo ou aos rótulos de recurso do registro fixado.

Para fixar uma entrada de registro e mostrar as entradas que correspondem ao mesmo tipo de recurso ou rótulos de recursos, faça o seguinte:

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

  2. 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 de k8s_node. Se você selecionar Mesmo resource.type, a consulta será executada novamente para mostrar todas as entradas de registro com resource.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 do registro fixado, selecione Mesmo rastreamento.
    • 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 Fixar e escolha entre as seguintes opções de menu:

  • Rolar para ver a entrada de registro: coloque a entrada de registro no painel Resultados da consulta atual e veja 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.

Exibição da entrada de registro que contém dados de trace.

Quando uma entrada de registro contém apenas o campo trace, somente o ícone de trace é exibido.

Exibição de entrada de registro que contém apenas o ícone de trace.

Para visualizar os dados de trace relacionados à entrada de registro, clique no ícone de trace. Você tem as seguintes opções:

  • Visualizar detalhes do trace: mostra o período pai e os traces filhos, além de detalhes sobre o trace. Para ver mais detalhes sobre o trace, clique em Ver no Trace para navegar até ele. Para mais informações sobre o conteúdo do painel de detalhes, consulte 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 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.

Menu do Explorador de registros para recursos do GKE.

Para compartilhar um link em um registro, expanda uma entrada de registro e selecione Copiar. É possível copiar um registro em JSON ou um link 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 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 ver 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.

Ver registros do Compute Engine

Para determinados tipos de recursos do Compute Engine, como gce_instance e gce_network, o nome do recurso aparece com o ID como um subtítulo em vários lugares do Explorador de registros. Por exemplo, para o tipo de recurso gce_instance, o nome e o ID da VM aparecem. Os nomes de recursos ajudam a identificar o ID de recurso correto, em que é possível criar consultas.

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

  • Menus de filtro do painel Consulta: os tipos de recursos do Compute Engine mostram nomes de recursos, com os IDs correspondentes como subtexto.
  • Campos: os tipos de recursos do Compute Engine mostram o nome do recurso, em vez do ID, nas dimensões do campo.
  • Resultados da consulta: para registros de instâncias de VM do Compute Engine, o campo resource.labels mostra metadados com o nome do recurso correspondente.
  • Campos de resumo: para registros 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 nos destinos de coletores, consulte Resolver problemas de roteamento e coletores.

Falha no download de registros

Você está usando a Análise de registros 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 tentando o seguinte:

  • Na caixa de diálogo Fazer o download dos registros, reduza o valor de Entradas máximas 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 iniciar o download.

Não é possível encontrar 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 Explorador de registros. Para ver esses registros, faça o seguinte:

  1. No Google Cloud console, 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, 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.

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

Para receber um ID do projeto ou da organização do Google Cloud de qualquer lugar no console doGoogle Cloud , expanda a lista de projetos do Google Cloud no seletor de projetos e organizações doGoogle Cloud e encontre o ID do projeto doGoogle 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 Google Cloud projeto correto está selecionado.

  • Verifique se o projeto Google Cloud está usando recursos que geram registros e se há atividade nesses recursos. Mesmo que o projeto Google Cloud seja novo, ele precisa ter registros de auditoria que gravam o fato de ter sido criado. 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 está 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 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 usará o histórico dos coletores no projeto 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 podem ter sido gravadas, a consulta vai 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 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 da 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 a restrição de intervalo de tempo. Se uma consulta não usar uma expressão de carimbo de data/hora, a consulta usará o seletor de intervalo de tempo como a restrição de intervalo de tempo.

Receber suporte

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