Mostrar registros e erros em um painel personalizado

Este documento descreve os widgets que podem ser adicionados aos painéis personalizados para que você possa conferir os dados de registro e de erro no mesmo contexto dos dados de métrica. O widget do painel de registros exibe as entradas de registro. O widget do painel de relatórios de erros mostra os grupos de erros mais recentes. Esses dois widgets fornecem informações que podem ser úteis na solução de problemas. O widget de gráfico da Análise de dados de registros, que exibe os resultados de uma consulta SQL, permite identificar tendências nos dados de registro.

Logs Explorer e o widget do painel de registros

O Explorador de registros é a maneira padrão de investigar registros. Adicionar um widget de painel de registros a um painel não muda a forma como você usa a Análise de registros. Como os widgets do painel de registros podem ser adicionados a painéis personalizados, eles oferecem uma maneira de visualizar as entradas de registro no mesmo contexto das métricas.

O Explorador de registros e o widget do painel de registros são compatíveis com a mesma linguagem de consulta e mostram apenas as entradas de registro que você tem permissão para visualizar. Seus papéis de gerenciamento de identidade e acesso (IAM) nos recursos que armazenam as entradas de registro determinam se você pode visualizar as entradas de registro armazenadas.

O Explorador de registros e o widget do painel de registros são pré-configurados para pesquisar as entradas de registro nos recursos listados no escopo de registro padrão. Se esse escopo não for acessível, ele pesquisa para as entradas de registro originadas no projeto selecionado. 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. É possível configurar quais recursos são pesquisados em entradas de registro. Por exemplo, é possível pesquisar entradas de registro pela visualização de registro.

Os widgets do painel de registros mostram uma entrada por linha, com colunas para gravidade, carimbo de data/hora e um resumo da entrada. Para exibir a representação formatada em JSON de um registro entrada, clique no botão Visualizar detalhes do registro. A estrutura do resumo de cada entrada varia de acordo com o tipo de registro. Por exemplo: a imagem a seguir mostra duas entradas de registro:

Imagem de duas entradas de registro no widget do painel de registros.

Na imagem anterior, a primeira entrada de registro mostra informações sobre uma solicitação de serviço. O resumo mostra informações o serviço, um endereço de e-mail e uma versão formatada em string do Estrutura JSON para a entrada. A segunda entrada mostra os resultados de uma solicitação e exibe apenas uma frase que resume a ação que ocorreu.

Para informações gerais sobre o Cloud Logging, consulte os seguintes recursos:

Antes de começar

Para receber as permissões necessárias para adicionar um widget do painel de registros a um painel de controle personalizado usando o console do Google Cloud e para configurá-lo para mostrar entradas de registro em projetos ou em visualizações 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 por meio de papéis personalizados ou de outros papéis predefinidos.

Exibir entradas de registro em um painel

Esta seção descreve como adicionar e configurar um widget de painel de registros usando o console do Google Cloud. Para mais informações sobre como usar a API Cloud Monitoring, consulte Painel com um widget LogsPanel.

É possível incluir até 40 widgets no painel.

Para adicionar um widget de painel de registros ao painel usando o console, faça o seguinte:

  1. No console do Google Cloud, acesse a página  Painéis:

    Ir para Painéis

    Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoramento.

  2. Selecione um painel ou clique em Criar painel.
  3. Na barra de ferramentas, clique em  Adicionar widget.
  4. Na caixa de diálogo Adicionar widget, selecione  Registros.
  5. Opcional: para atualizar o título, digite o novo título no campo Título do widget.

  6. Configure quais recursos são pesquisados em entradas de registro:

    • Para pesquisar por projeto, defina a entrada Escopo por como Projeto, expanda a entrada Projetos e conclua a caixa de diálogo.

      O menu Projects lista todos os projetos do Google Cloud no escopo de métricas atual. Se uma entrada do menu incluir o texto "Você não tem permissão para acessar os registros neste projeto no nível do projeto", você não tem as permissões necessárias para visualizar o disponíveis nesse projeto do Google Cloud.

      As entradas de registro exibidas incluem aquelas que se originam no seu projeto do Google Cloud e aquelas que são roteadas para seu projeto do Google Cloud por um coletor em outro projeto.

    • Para pesquisar entradas de registro por visualizações de registro em buckets de registro, defina a entrada Escopo por como Armazenamento, expanda a entrada Visualizações de armazenamento e conclua a caixa de diálogo.

      O menu Visualizações de armazenamento lista as visualizações de registro nos buckets de registros o projeto selecionado do Google Cloud.

      Para selecionar visualizações de registro em buckets de registro em outros projetos do Google Cloud, no menu, clique em Import project, selecione um projeto e escolha uma ou mais visualizações de registro. Só é possível importar projetos que estão incluídas no escopo de métricas atual.

    • Para pesquisar os recursos incluídos em um escopo de registro, que pode incluir projetos e visualizações de registro, defina a entrada Escopo por como Escopo de registros, expanda a entrada Escopos de registro e selecione um escopo de registro.

      Os escopos de registro estão em Acesso antecipado.

  7. Opcional: para restringir os registros que o widget do painel de registros exibe, insira uma consulta no campo Editor de consultas. Se você desativou a execução automática de consultas, clique em Executar consulta. Para uma breve introdução às consultas, veja Exemplos de consulta.

  8. Opcional: aplique as variáveis de modelo ao widget do painel de registros. Para mais informações, consulte Aplicar um filtro permanente a um widget.

  9. Para aplicar as mudanças ao painel, clique em Aplicar na barra de ferramentas. Para descartar as mudanças, clique em Cancelar.

  10. Para salvar o painel modificado, clique em Salvar na barra de ferramentas.

    O widget do painel de registros exibe uma tabela de entradas de registro. Você também pode usar a barra de filtro do widget para mudar temporariamente as entradas de registro que o widget exibe. Para mais informações, consulte a seção Filtrar as entradas de registro.

Exemplos de consultas

Para preencher o campo Editor de consultas, insira o texto nele ou faça seleções nos menus. O campo Editor de consultas usa a mesma linguagem de consulta que o Explorador de registros. Para informações sobre solução de problemas, consulte Problemas de sintaxe.

Os menus Gravidade e Nome do registro permitem que você selecione várias opções. Veja a seguir um exemplo de instrução de consulta que corresponde a vários níveis de gravidade:

severity=(WARNING OR ERROR OR CRITICAL OR ALERT OR EMERGENCY)

O menu Recurso permite filtrar por recurso. Você pode selecionar um tipo de recurso, como Recurso auditado, ou navegar pelas janelas para selecionar um método específico.

Por exemplo, para adicionar uma consulta para Recurso auditado, faça o seguinte:

  1. Abra o menu Recurso.
  2. Pesquise e selecione Recurso auditado.

  3. Clique em Aplicar.

    Estas etapas adicionam a seguinte cláusula ao campo Editor de consultas:

    resource.type="audited_resource"

Da mesma forma, para adicionar uma consulta aos registros de auditoria de funções do Cloud Run, faça o seguintes:

  1. Expanda o menu Recurso.
  2. Pesquise e selecione Recurso auditado.
  3. No menu de serviços, selecione Cloud Functions.

  4. Clique em Aplicar.

    Essas etapas adicionam a seguinte cláusula ao Editor de consultas campo:

    resource.type="audited_resource" resource.labels.service="cloudfunctions.googleapis.com"

Filtrar as entradas de registro

É possível modificar quais entradas de registro um widget de painel de registros exibe. Para isso, basta modificar os valores dos seguintes campos ou menus:

  • Seletor de tempo do painel: o widget do painel de registros recupera apenas que são entradas de registro escrito no intervalo especificado por este campo.

  • Campo Filtro no widget do painel de registros: o filtro especificado é aplicado depois que a consulta é concluída. O valor desse campo é retido apenas para a sessão atual.

  • Menu Severity no widget do painel de registros: o filtro por nível de gravidade é aplicado após a conclusão da consulta. O valor desse campo é mantido apenas para a sessão atual.

  • Consultar no widget do painel de registros: o widget do painel de registros é exibido apenas as entradas de registro que correspondem à consulta. Se você não especificar uma consulta, todos os registros no intervalo de tempo selecionado serão exibidos. Se você especificar uma consulta, o widget do painel de registros exibe uma opção Mostrar consulta que mostra a consulta atual como uma dica.

    Para modificar a consulta, edite o widget do painel de registros.

  • Projeto do Google Cloud no widget do painel de registros: para modificar essa configuração, edite o widget do painel de registros.

  • Filtros do painel: quando eles existem, a configuração de filtro é aplicada à consulta do widget do painel de registros. Por exemplo, se você adicionar o filtro cluster_name: mycluster no painel, a consulta será atualizado para incluir resource.labels."cluster_name"="mycluster". Para mais informações sobre os filtros do painel, consulte Adicionar filtros temporários e Adicionar filtros permanentes.

O restante desta seção oferece mais informações sobre como filtrar as entradas de registro.

Exemplo: filtrar entradas de registro por data

Para mostrar os registros mais recentes em um widget de painel de registros, use os campos de tempo na barra de ferramentas do painel. Por exemplo, selecione 1H. Desde que você não selecione um período personalizado, o widget sempre exibirá os registros mais recentes, mesmo quando anterior à janela de tempo selecionada.

Ao investigar um incidente, é possível restringir as entradas de registro às entradas que estão em um intervalo de tempo específico. Para configurar as entradas de registro para mostrar os registros que estão em um intervalo de tempo fixo, siga um ou ambos os procedimentos a seguir:

  • Selecione um período usando o seletor de intervalo de tempo.
  • Insira uma cláusula timestamp no campo Editor de consultas do painel de configuração e selecione Aplicar filtro.

Quando você especifica um intervalo de tempo, o widget do painel de registros não é atualizado automaticamente.

Exemplo: filtrar entradas de registro por gravidade

Quando você está monitorando a depuração de uma situação de falha, convém ver apenas mensagens de erro e ocultar da exibição todas as outras entradas de registro. Para configurar um widget de painel de registros para mostrar apenas as entradas que atendem a níveis de gravidade específicos, siga um destes procedimentos ou ambos:

  • Para aplicar um filtro temporário, selecione um valor para o menu Gravidade em no widget do painel de registros. Esse menu especifica um nível de gravidade mínimo. Por exemplo, um valor de "Aviso" resulta na recuperação de entradas de registro com uma gravidade "Erro", mas aquelas com uma gravidade de "Aviso" não são recuperadas. Por padrão, o valor desse campo é definido como Default, o que inclui todas as entradas de registro.

    A configuração do menu Gravidade é descartada quando você sai do painel.

  • Para aplicar um filtro permanente, insira uma cláusula severity no campo Editor de consultas no painel de configuração e selecione Aplicar filtro.

Exemplo: filtrar entradas de registro por uma string ou frase

Filtrar entradas de registro por string ou frase específica permite eliminar a visualização de entradas de registro que não são de interesse. Por exemplo, para visualizar entradas de registro que incluem um endereço de e-mail específico, filtre por esse endereço.

  • Para aplicar um filtro temporário para visualizar apenas as entradas de registros que contêm uma palavra ou frase específica, use o campo Filtro. O contém-test é indiferente a maiúsculas.

    Se você adicionar vários filtros, somente os registros que corresponderem a todos os filtros serão mostrados porque um AND implícito é inserido entre filtros adjacentes. No entanto, é possível inserir explicitamente um operador OR:

    • Por exemplo, quando você adicionar os filtros Get e Compute, serão exibidas entradas de registro que contêm as duas palavras.

    • Por exemplo, quando você adiciona os filtros Get, OR e Compute, as entradas de registro que contêm Get ou Compute são exibidas.

    O valor do campo Filtro não é persistente.

  • Para aplicar um filtro permanente, modifique a consulta armazenada no campo Editor de consultas e selecione Aplicar filtro. Para informações sobre a sintaxe da consulta, veja a Linguagem de consulta do Logging.

    Por exemplo, para exibir somente essas entradas de registro com um campo MESSAGE cujo valor contém a string "lamp", adicione a cláusula jsonPayload.MESSAGE:"lamp" ao Editor de consultas.

Ver entradas de registro no Explorador de registros

Os widgets do painel de registros exibem os principais campos das entradas de registro, mas não exibem as para completar a entrada de registro. Para examinar todos os campos de uma entrada de registro, faça o seguinte:

  1. No widget do painel de registros, selecione Ver no Explorador de registros.

  2. Na caixa de diálogo, selecione o projeto do Google Cloud em que o Explorador de registros será aberto.

    O Explorador de registros é aberto em uma nova guia do navegador, e os filtros que você selecionou no widget do painel de registros são aplicados automaticamente.

  3. Selecione a entrada de registro que você quer ver.

Mostrar gráficos gerados de uma consulta da Análise de dados de registros

Esta seção descreve como configurar e salvar um gráfico gerado a partir de uma consulta do Log Analytics em um painel personalizado. Com a Análise de registros, é possível pesquisar e agregar registros para gerar insights úteis usando consultas SQL.

Além de usar a página Análise de dados de registros para configurar e salvar gráficos no um painel, salve um gráfico da Análise de dados de registros diretamente no Monitoring fazendo o seguinte:

  1. No console do Google Cloud, acesse a página  Painéis:

    Ir para Painéis

    Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoramento.

  2. Selecione um painel ou clique em Criar painel.
  3. Na barra de ferramentas, clique em  Adicionar widget.
  4. Na caixa de diálogo Adicionar widget, acesse a seção Dados e selecione Log Analytics.
  5. No painel Configure widget, configure os dados a serem mostrados no gráfico criando uma consulta usando SQL e clicando em Run query.

  6. Opcional: na guia Resultados, personalize a configuração do gráfico usando o painel Exibição.

    No painel Exibição, é possível mudar o tipo de gráfico e personalizar quais linhas e colunas são representadas mudando a dimensão, a medida e o detalhe:

    • Dimensão: A dimensão precisa ser uma coluna de carimbo de data/hora, numérica ou de string. Por padrão, a dimensão é definida como à primeira coluna com base em carimbo de data/hora no esquema. Se não houver um carimbo de data/hora na consulta, a primeira coluna de string será selecionada como a dimensão. Também é possível personalizar a dimensão no painel Exibição do gráfico. Quando uma coluna de carimbo de data/hora é selecionada como dimensão, o gráfico mostra como os dados mudam ao longo do tempo.

    • Medida: é possível selecionar várias medidas no painel Exibição do gráfico. Ao selecionar uma medida, você também precisa selecionar a função de agregação a ser realizada nos valores agrupados, como count, sum, average e percentile-99. Por exemplo, count-distinct retorna o número de valores exclusivos em uma determinada coluna.

    • Detalhamento: Para dividir uma única série de dados em várias com base em outra coluna, adicione um detalhamento.

    Para mais informações sobre como personalizar a configuração do gráfico, consulte Personalize a configuração do gráfico.

  7. Para salvar seu painel modificado, clique em Salvar na barra de ferramentas.

Os gráficos do Log Analytics também podem ser editados depois de salvos em um painel. Para mais informações, consulte Modifique a configuração de um widget.

Exibir erros em um painel

Esta seção descreve como adicionar e configurar um painel de relatório de erros usando no console do Google Cloud. Para informações sobre como adicionar um painel de relatório de erros para um painel usando a API Cloud Monitoring, consulte Painel com um widget ErrorReportingPanel.

Para adicionar um painel do Error Reporting ao painel usando o console, faça o seguinte:

  1. No console do Google Cloud, acesse a página  Painéis:

    Ir para Painéis

    Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoramento.

  2. Selecione um painel ou clique em Criar painel.
  3. Na barra de ferramentas, clique em  Adicionar widget.
  4. Na caixa de diálogo Adicionar widget, vá para a seção Visualização e, em seguida, e selecione painel Error Reporting.
  5. Selecione o projeto com os grupos de erros mostrados. abra Projetos e faça uma seleção.
  6. Opcional: atualize o título.

  7. Opcional: para restringir os recursos em que os erros são exibidos, faça o seguinte:

    1. abra Todos os recursos e selecione um deles.

    2. Depois de escolher um recurso, clique em Aplicar ou use os menus adicionais para refinar os critérios de filtro:

      • Para mostrar erros em recursos do App Engine, selecione GAE Services e clique em Aplicar.

      • Para mostrar erros de um serviço específico do App Engine, selecione GAE Services, selecione o serviço e clique em Aplicar.

  8. Para aplicar as alterações ao painel, na barra de ferramentas, Clique em Aplicar. Para descartar as mudanças, clique em Cancelar.

    O exemplo a seguir mostra um painel do Error Reporting:

    Exemplo de um painel de configuração do painel de relatórios de erros.

  9. Para salvar seu painel modificado, clique em Salvar na barra de ferramentas.

Resolver problemas

A seguir