Como revisar registros com o Explorador de registros do Cloud Logging

Beta

Esse recurso está sujeito aos "Termos de ofertas pré-GA" na seção "Termos de Serviço gerais" dos Termos específicos de serviço. Os recursos pré-GA estão disponíveis "no estado em que se encontram" e podem ter suporte limitado. Para mais informações, consulte as descrições da fase de lançamento.

Neste documento, fornecemos informações sobre como usar o Visualizador de registros do Cloud Logging para revisar registros.

Antes de começar

• Configure seu aplicativo para usar a API Cloud Logging.

• Faça login na sua conta para acessar os recursos do Google Cloud.

  • Selecione Ferramentas, Ferramentas do Google Cloud, Gerenciar contas... para selecionar sua conta.

Como acessar a Análise de registros

Para acessar a Análise de registros do Cloud Logging, selecione Ferramentas -> Google Cloud Tools -> Mostrar Explorador de registros do Stackdriver.

A guia Google Stackdriver Logging é aberta.

Você também pode abrir a Análise de registros para um projeto específico do Google Cloud Explorer selecionando Ferramentas -> Google Cloud Tools -> Google Cloud Explorer. Clique com o botão direito do mouse no projeto e selecione Procurar registros do Stackdriver.

Como chegar na interface

Estes são os principais componentes da interface da Análise de registros:

• Uma barra de pesquisa para filtrar entradas de registro por rótulo ou pesquisa de texto.

• Menus suspensos para filtrar a lista por recursos, registros e níveis de gravidade.

• Menu suspenso Ir para este ponto no tempo para ver uma data e hora específicas nos registros.

• Um botão Atualizar para recuperar os registros mais recentes em ordem decrescente.

• O stream de registro de carga automática controla se as novas entradas de registro serão exibidas ou não quando chegarem.

  • Clicar em Reproduzir inicia o stream dos registros mais recentes. O stream será interrompido se você rolar a exibição de registros.

  • Clicar em Pausar interrompe o stream de registros.

• A tabela de resumos de registros que é possível clicar para ver os detalhes completos das entradas de registro individuais.

• Uma seta para baixo Expandir tudo no canto superior direito do painel de entradas de registro para mostrar os detalhes de todas essas entradas. Essa ação poderá levar algum tempo, se o painel tiver muitas entradas de registro.

• Se disponível, um link de origem para localizar o código-fonte que gera a entrada de registro.

Como navegar para o código-fonte

A Análise de registros permite navegar até o código-fonte que gera uma entrada de registro. Para ativar esse recurso, crie seu projeto de um repositório git local. Adicione informações do local de origem às entradas de registro.

Como adicionar o local de origem ao registro

Configure seu aplicativo para fornecer informações de local do código-fonte nos registros:

1. Grave informações de local das entradas de registro usando o exemplo do GitHub a seguir.

2. Implante um arquivo source_context.json na raiz do aplicativo.

   Se você publicar a solução por meio do Cloud Tools for Visual Studio, a extensão gera e implanta o arquivo automaticamente.

Depois que você concluir essas etapas, as entradas de registro incluirão um campo sourceLocation com informações de Arquivo e Linha. A linha opcional Função pode conter o nome da montagem, a versão ou o nome da função.

Ao clicar no link de origem, você navegará para o código-fonte, se o arquivo de origem estiver acessível.

Como visualizar os registros

Na interface do Buscador de registros, é possível filtrar as entradas de registro ou pesquisar registros específicos a serem exibidos.

Como filtrar os registros

É possível filtrar as entradas de registro para ver apenas os registros que forem de seu interesse.

• No menu suspenso de tipo de recurso e instância, selecione todas as instâncias de um determinado tipo de recurso ou instância específica que queira ver. Para ver uma lista de tipos de recursos, consulte Recursos e serviços monitorados.

• No menu suspenso de tipo de registro, selecione os registros nomeados que você quer ver ou selecione Todos os registros. O menu mostra apenas os registros que o recurso selecionado gera.

• No menu suspenso de gravidade de registro, selecione o nível de gravidade que você quer ver. A seleção de Todos os níveis de registros inclui entradas de registro sem um nível de gravidade.

• No menu suspenso Ir para este ponto no tempo, selecione uma data e hora. Escolha se você quer ver os registros antes ou depois do carimbo de data/hora selecionado.

Também é possível clicar em Para filtro avançado para acessar a barra de filtro avançado, onde é possível filtrar as entradas de registro por meio de consultas. Clique no link Ajuda do filtro avançado para mais informações.

Como pesquisar os registros

Na barra de pesquisa, procure palavras-chave que aparecem nas entradas de registro.

Como mostrar registros semelhantes

Clique no valor de um campo individual na exibição expandida de entradas para mostrar ou ocultar todas as entradas de registro com o mesmo valor.

Quando as entradas de registro semelhantes forem exibidas, a barra de filtro avançado será exibida. Nela, é possível editar o filtro e clicar em Enviar filtros. Clique no link Ajuda do filtro avançado para mais informações.