Ver registros

Neste guia, você aprende a como pesquisar e ver entradas de registro com o Visualizador de registros.

Antes de começar

Não é preciso um espaço de trabalho para usar o Stackdriver Logging. Ele só será necessário se você estiver enviando registros do Amazon Web Services (AWS) para o Logging.

O Stackdriver Logging exibe registros para um único projeto do Google Cloud Platform. Se você estiver usando um espaço de trabalho, o Stackdriver Logging não combinará os registros dos projetos monitorados. Selecione um projeto específico para visualizar seus registros.

Se você estiver usando um espaço de trabalho e o AWS, selecione o projeto de conector do AWS para ver os registros do AWS.

Primeiros passos

  1. Acesse a página Stackdriver Logging > Registros (Visualizador de registros) no Console do GCP:

    Acessar a página "Visualizador de registros"

  2. Selecione um projeto do GCP na parte superior da página ou crie um novo.

  3. Use os menus suspensos para selecionar o recurso com os registros que você quer ver.

Se você não vir nenhum registro, consulte a seção Como solucionar problemas abaixo.

Interfaces de filtro do Visualizador de registros

Há duas interfaces de filtros no Visualizador de registros:

  • A interface de filtro básico padrão permite que você selecione registros dos menus e conta com um recurso simples de pesquisa.
  • A interface de filtro avançado permite exibir entradas de registro de vários registros e conta com um recurso de pesquisa mais sofisticado.

É possível alternar entre essas interfaces usando a seta suspensa (▾) na extrema direita da caixa de filtro de pesquisa em qualquer interface.

A captura de tela a seguir mostra o layout do Visualizador de registros com a interface de filtro básico. A captura de tela exibe as entradas de registro de um aplicativo do App Engine:

Visualizador de registros

Estes são os principais componentes da interface de filtros básica, indicados por números vermelhos na captura de tela acima. Alguns deles estão incluídos na interface de filtro avançado:

  1. As guias da janela permitem permanecer em Registros (a página Visualizador de registros) ou escolher entre outros recursos do Stackdriver Logging: Métricas (consulte Métricas com base em registros), Exportações (consulte Como exportar com o Visualizador de registros) e Processamento de registros (consulte Exclusões de registros).
  2. A caixa de filtro de pesquisa na interface de filtro básico permite filtrar as entradas de registro por rótulo ou pesquisa de texto. O filtro básico é exibido, e a seta suspensa (▾) na extrema direita permite alternar para a interface de filtro avançado ou receber um link para o filtro.
  3. Os menus básicos do seletor permitem selecionar recursos, registros e níveis de gravidade a serem exibidos.
  4. Os menus suspensos do seletor de períodos permitem filtrar por datas e horários específicos nos registros.
  5. O seletor de streaming, na parte superior da página, controla se as novas entradas de registro são exibidas à medida que chegam.
  6. A tabela de entradas de registro contém as entradas de registro disponíveis de acordo com os filtros atuais e os campos personalizados.
  7. A seta de expansão (▸) na frente de cada entrada de registro permite ver todo o conteúdo da entrada. Para mais informações, consulte Expandir entradas de registro.
  8. O menu Ver opções à extrema direita conta com mais opções de exibição.
  9. O menu Fazer o download de registros à extrema direita permite fazer o download de um conjunto de entradas de registro. Para mais detalhes, consulte Fazer o download de entradas de registro.
  10. A opção Mais (⋮) exibida com cada entrada de registro permite colocar um alfinete na entrada de registro, mostrar a entrada de registro no contexto do recurso dele e copiar um URL da entrada de registro para a área de transferência.

Por fim, o Visualizador de registros usa a posição do cursor para destacar a entrada de registro associada e colocar um símbolo de alfinete (📌) próximo de Mais (⋮).

Rolar e transmitir registros

Ao abrir o Visualizador de registros pela primeira vez, você vê entradas de registro recentes suficientes para preencher a tela. Quando você rola pelas entradas, o visualizador busca mais delas. Com a barra amarela acima e abaixo dos registros, você confere se há mais entradas disponíveis.

Os ícones na parte superior da tela controlam quando os registros são atualizados:

  • Clique no ícone "atualizar" (refresh) para recuperar os registros mais recentes e ajustar a rolagem da tela até exibi-los.
  • Clique no ícone "reproduzir" (play_arrow) para transmitir os registros mais recentes. A transmissão é interrompida quando você seleciona uma entrada de registro ou rola a tela com os registros.
  • Clique no ícone "pausar" (pause) para interromper a transmissão.

Rolar até um horário

É possível filtrar suas entradas de registro por hora e data usando os menus do seletor do intervalo de tempo abaixo da caixa do filtro de pesquisa.

Seletor de intervalo

A seleção padrão é Última hora. É possível usar o menu suspenso para selecionar outros intervalos de tempo ou definir um intervalo:

  • Selecione Ir para este ponto no tempo para filtrar os registros de uma determinada data e hora.
  • Selecione Personalizado para especificar um intervalo ou um fuso horário personalizado.

Para mostrar as entradas de registro atuais, clique em Ir para o momento atual.

Em todos os casos, uma seleção faz com que o Visualizador de registros atualize a tela. Em seguida, será possível percorrer e inspecionar as entradas de log exibidas.

Para redefinir a data e a hora a fim de que elas correspondam à entrada de registro recém-recebida, clique no ícone Atualizar ou Reproduzir.

Alterar o fuso horário

É possível selecionar um fuso horário para suas entradas de registro:

  1. No menu suspenso Última hora, selecione Personalizar.
  2. Clique na seta de expansão (▾) em qualquer um dos novos menus para abrir um calendário suspenso.
  3. No painel Fuso horário, selecione um país e fuso horário.

Sua seleção faz com que o Visualizador de registros atualize a tela e o fuso horário de cada entrada de registro:

Personalizar o fuso horário

Expandir entradas de registro

A tabela de entrada de registro exibe uma linha de resumo para cada entrada por padrão.

Linha de resumo da entrada de registro

A linha de resumo da entrada de registro pode conter campos destacados. Por exemplo, os campos personalizados são destacados.

Os campos incluídos na linha de resumo são selecionados como subconjuntos dos campos de entrada de registro. Por padrão, alguns campos são exibidos se atenderem a um ou mais destes critérios:

  • A entrada de registro precisa ter um tipo conhecido, como um registro de solicitação do App Engine.
  • A entrada de registro contém o campo httpRequest.
  • A entrada de registro tem um payload com um campo chamado message.

Para ver os detalhes completos de uma entrada do registro, clique na seta de expansão (▸) na frente da linha de resumo. Para ver os detalhes completos em uma visualização estruturada de todas as entradas de registro disponíveis com o filtro atual, clique no menu Opções de visualização na extrema direita e selecione Expandir tudo:

Menu de opções de visualização

É possível selecionar Recolher tudo para recolher todos os detalhes da entrada do registro expandido.

Quando você expande uma linha de resumo de uma entrada de registro, o Visualizador de logs exibe uma representação estruturada (JSON):

Entrada de registro de solicitação estruturada

Para ver uma descrição dos campos em uma entrada de registro, consulte o tipo LogEntry.

Adicionar campos personalizados

Campos personalizados são campos dentro de entradas de registro que você especifica para serem incluídos na linha de resumo. Sempre que estiverem disponíveis nas entradas de registro, esses campos serão preenchidos e destacados em azul.

Campos personalizados na linha de resumo

Há duas maneiras de adicionar campos personalizados às linhas de resumo da tabela de entrada de registro:

  • Em uma entrada de registro expandida, clique em um campo dentro da representação JSON. No painel resultante, selecione Adicionar campo à linha de resumo:

Adicionar campo à linha de resumo

  • No menu Opções de visualização, no canto superior direito do Visualizador de registros, selecione Adicionar campos personalizados. Se você já tiver campos personalizados no projeto, essa opção será Modificar campos personalizados. No painel resultante, adicione a chave JSON desejada e clique em Salvar. É possível adicionar várias chaves separando-as por vírgulas. Para reorganizar a aparência dos campos personalizados nas linhas de resumo, reordene o texto nesse painel e clique em Salvar.

Adicionar campo JSON à linha de resumo

Há duas maneiras de remover campos personalizados das linhas de resumo da tabela de entrada de registro:

  • Para remover um campo personalizado de uma linha de resumo, clique no campo e selecione Remover campo da linha de resumo.
  • No menu Opções de visualização, na parte superior direita do Visualizador de registros, selecione Modificar campos personalizados. No painel resultante, exclua as chaves JSON que você quer remover e clique em Salvar.

Os campos personalizados são adicionados ao URL atual e permanecerão enquanto você continuar usando esse URL ou estiver na mesma sessão do navegador. Não é possível defini-los em um nível global nem salvá-los por usuário ou projeto do GCP.

Não é possível remover os campos padrão da tabela de entrada de registro.

Fixar uma entrada de registro

Se você identificou uma entrada de registro interessante e quer investigar entradas próximas, coloque um alfinete na entrada de registro. Depois que a entrada de registro é fixada, é possível alterar o filtro e o Visualizador de registros centraliza automaticamente a pesquisa ao redor da entrada fixada. Com esse recurso, é possível examinar a entrada de registro no contexto especificado por um filtro definido por você. Depois que um registro é fixado, a cor do plano de fundo é alterada e um alfinete é exibido:

Entrada de registro fixada

Para fixar uma entrada de registro, clique no alfinete ou clique em Mais (⋮) e selecione Fixar essa entrada de registro.

O alfinete colocado em uma entrada de registro só fica visível para você. Os outros usuários que visualizarem as mesmas entradas de registro não verão seu alfinete nem terão a visualização modificada de qualquer outra maneira.

Fixar uma entrada de registro não altera a interface nem as configurações do filtro, assim como não atualiza o conteúdo exibido. É você quem determina as configurações de filtro e quando a exibição do Visualizador de registros precisa ser atualizada. É possível modificar as configurações de filtro e atualizar a exibição quantas vezes quiser sem afetar o alfinete.

Fixar uma entrada de registro interrompe o streaming se estiver ativado no momento.

Se uma entrada de registro estiver fixada, será possível mover ou remover o alfinete:

  • Para mover o alfinete para uma entrada de registro diferente, na nova entrada de registro, clique no ícone de alfinete ou clique em Mais (⋮) e selecione Mover o alfinete para esta entrada de registro.

  • Para remover o alfinete de uma entrada de registro, clique no símbolo de alfinete ou clique em Mais (⋮) e selecione Desafixar esta entrada de registro.

Se você ativar o streaming enquanto uma entrada de registro estiver fixada, o Visualizador de registros removerá o alfinete.

Mostrar registros similares

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

Mostrar entradas correspondentes

Ao fazer isso, o Visualizador de registros muda para a interface de filtro avançada. Para modificar a pesquisa, edite o filtro e clique em Enviar filtro. Para saber mais, consulte a interface de filtro avançada.

Além disso, é possível correlacionar as entradas do registro de solicitações do App Engine e visualizá-las em uma estrutura aninhada. Para mais detalhes, consulte Como exibir entradas de registro de solicitações relacionadas e selecione seu idioma de ambiente de execução.

Mostrar detalhes de latência

Novo para os registros de solicitação do App Engine, o Visualizador de registros oferece um link para o Stackdriver Trace a fim de facilitar a visualização dos detalhes de latência da entrada do registro.

Para mostrar o menu de opções relacionadas à latência para uma entrada de registro, identifique o campo protoPayload.latency:

Mostrar protoPayload.latency

Clique no valor de latência:

Mostrar opções de latência

As duas primeiras opções no menu restringem as entradas de registro mostradas àquelas com maior ou menor latência. A última opção do menu restringe as entradas de registro àquelas que contêm detalhes de trace visíveis por meio do Stackdriver Trace. Especificamente, a última opção restringe as entradas de registro àquelas em que a opção Visualizar detalhes de trace está ativada.

Como visualizar detalhes de latência no Stackdriver Trace

Para determinados registros de solicitações do App Engine, a opção Visualizar detalhes de trace está ativada. Quando ativada, clique nessa opção para abrir o Stackdriver Trace e exibir os detalhes de latência da entrada de registro:

Mostrar cronograma de rastreamento

Mostrar no contexto do recurso

Se você identificou uma entrada de registro interessante e quer identificar outras entradas de registro associadas ao mesmo tipo de recurso, clique em Mais (⋮) na extremidade direita da linha e selecione a opção Mostrar no contexto do recurso:

Mostrar contexto

Em resposta à sua ação, o Visualizador de registros:

  1. Fixa a entrada de registro.
  2. Alterna para a interface de filtro avançado e substitui o conteúdo do filtro por um filtro no tipo de recurso.
  3. Atualiza a tela. A entrada de registro fixada é exibida na parte inferior da tela.

Mostrado no contexto

Compartilhar uma entrada de registro

Para compartilhar uma entrada de registro, clique em Mais (⋮) e selecione Copiar link para a entrada de registro da área de transferência. Com isso, o Visualizador de registros gera um URL exclusivo para a entrada de registro e copia o URL na área de transferência.

Como selecionar registros

Use os menus e a caixa de filtro de pesquisa para encontrar os registros que quer ver:

  • Selecione um tipo de recurso e instância com os registros que você quer ver. É possível visualizar todas as instâncias desse tipo de recurso ou selecionar uma instância específica. Na captura de tela acima, a opção Instância da VM do GCE, referente a todas as instâncias, está selecionada. Veja uma lista de tipos de recurso em Lista de recursos monitorados.

  • Selecione os registros nomeados que você quer ver no segundo menu ou selecione Todos os registros. O menu mostra os registros que estão sendo usados pelas instâncias de recurso selecionadas.

  • Selecione o menor nível de gravidade que você quer ver no terceiro menu. Selecionar Qualquer nível de registro também mostra entradas de registro que não têm gravidade atribuída.

  • Selecione o intervalo de tempo que você quer ver no quarto menu. Se preferir, selecione Ir para o momento atual no quinto menu.

Conforme você altera as seleções dos menus, as entradas de registro correspondentes são exibidas.

Observações sobre o menu:

  • São exibidos apenas os tipos de recurso, instâncias e nomes de registros que estão no seu projeto. Pode levar algum tempo para que os menus sejam atualizados depois que você adicionar um novo tipo de recurso ou instância ou fizer gravações em um novo registro.

  • Na interface de filtros básicos, é possível visualizar apenas entradas de registro de um tipo de recurso por vez. A interface de filtros avançados permite a exibição de vários tipos.

  • Nenhum registro será exibido se você navegar até um momento anterior ao período de armazenamento atual. Para mais informações, consulte Períodos de armazenamento dos registros.

Fazer o download de entradas de registro

Com alguns cliques, você pode fazer o download, no formato JSON ou CSV, de todas as entradas de registro armazenadas na memória de trabalho do visualizador de registros. Por motivos de desempenho, o visualizador de registros tenta carregar 100 entradas de registro de cada vez e não retém mais do que 300 entradas de registro na memória de trabalho. Esses valores não são configuráveis.

Para fazer o download de entradas de registro, clique no menu Fazer o download de registros, localizado na parte superior direita do visualizador de registros. Na caixa de diálogo de download, selecione JSON ou CSV para o formato de entrada de registro e clique em Fazer o download:

Mostrar detalhes do download

Para exibir entradas de registro no formato JSON ou CSV em uma página da Web, siga as mesmas etapas para fazer o download, mas selecione Exibir em nova guia.

Como pesquisar com o visualizador de registros

É possível reduzir suas pesquisas usando filtros tanto na interface de filtro básico quanto no avançado. A interface de filtro avançado contém a maioria dos recursos da interface de filtro básico, mas conta com recursos de pesquisa mais sofisticados.

Diferenças entre filtros básicos e avançados

As sintaxes da interface de filtro básico e da interface de filtro avançado são diferentes. A interface de filtro básico é criada com base em pressuposições. Por exemplo, todas as pesquisas não diferenciam maiúsculas de minúsculas, o que não é válido para a interface de filtro avançado.

As próximas seções destacam as principais diferenças na sintaxe dessas duas interfaces.

Palavra-chave "text:"

O Visualizador de registros mostra pesquisas de texto no filtro básico colocando o rótulo text: como prefixo. Não use o rótulo text: com filtros avançados.

A tabela a seguir mostra pesquisas de texto equivalentes:

Filtro básico do Visualizador de registros Filtro avançado com o mesmo significado
text:"one two" "one two"
text:three three
text:n=5 "n=5" (aspas necessárias)

Se, acidentalmente, você usar text: no filtro avançado, será pesquisada uma correspondência em um campo text, que não existe.

Nomes de campos

A interface de filtro básico tem nomes de campo internos para determinados registros, incluindo o registro de solicitações do App Engine. Esses nomes de campo não existem em filtros avançados.

A tabela a seguir mostra uma pesquisa de campo equivalente para um registro de solicitações do App Engine:

Filtro básico Filtro avançado
querystring:var=3 protoPayload.resource:"var=3"
status:400..405 protoPayload.status >= 400 AND protoPayload.status <= 405

Se você usar querystring:var=3 no filtro avançado, procurará um campo chamado querystring, que não existe. Portanto, o Visualizador de registros não encontra entradas de registro correspondentes.

Correspondências de substring

Na interface de filtro básico, todas as pesquisas são correspondências de substring sem distinção entre maiúsculas e minúsculas. Em outras palavras, as pesquisas text:abc ou somefieldname:abc correspondem às entradas de registro que contêm abc, xyabcyx e ABc. Nos filtros avançados de registro, use o operador "tem" (:) para garantir o mesmo comportamento.

Para retornar uma correspondência exata, use o operador de igualdade (=). A comparação field=abc requer que field contenha exatamente abc em letras minúsculas ou maiúsculas. Essa pesquisa não pode ser feita na interface de filtro básica.

AND e OR

Na interface de filtro básico, duas comparações com o mesmo nome de campo (ou text:) são unidas implicitamente com OR, enquanto comparações com rótulos diferentes são unidas por AND. Nos filtros de registros avançados, todas as comparações são unidas por AND a menos que OR seja especificado explicitamente. Também é possível usar parênteses para agrupar comparações. A tabela a seguir mostra pesquisas equivalentes nas duas interfaces de filtro:

Pesquisa com filtro básico Pesquisa com filtro avançado
text:abc querystring:def text:xyz protoPayload.resource:"def" AND ("abc" OR "xyz")

Desempenho da pesquisa

Veja algumas dicas para melhorar o desempenho da pesquisa:

  • Pesquise valores específicos de campos indexados, como o nome da entrada de registro, o tipo de recurso e os rótulos. Para fazer isso na interface de filtros básicos, selecione as opções do menu. Na interface de filtros avançados, use condições como a descrita a seguir:

    resource.type = "gce_instance"
    logName = "projects/[PROJECT_ID]/logs/cloudaudit.googleapis.com%2Factivity"
    resource.labels.module_id="default"
    resource.labels.instance_id="1234567890"
    
  • Escolha correspondências exatas em vez de pesquisas de substring. Principalmente nos campos de índice, as correspondências parciais são mais lentas. Na interface de filtros básicos, todas as pesquisas de texto exibem correspondências parciais. Na interface de filtros avançados, facilite os testes usando o operador de igualdade (=) em vez de dois-pontos (:).

  • Reduza o período pesquisado. Não é possível fazer isso na interface de filtros básicos. No entanto, você pode especificar um intervalo na interface de filtros avançados:

    timestamp >= "2016-11-29T23:00:00Z" AND timestamp <= "2016-11-29T23:30:00Z"
    

Para mais informações sobre o desempenho, consulte Como encontrar entradas do registro rapidamente.

Solução de problemas

Nesta seção, fornecemos instruções para solucionar problemas comuns encontrados ao interagir ou pesquisar com o Visualizador de registros.

Não há registros!

Caso nenhum registro seja exibido, verifique o seguinte:

  • Você selecionou o projeto certo na parte superior da página? Se não tiver selecionado, use o menu suspenso no topo da página para selecionar um projeto. Selecione o projeto que tem os registros que você quer ver.

  • O projeto tem alguma atividade? Mesmo que seja novo, o projeto precisa ter atividades ou registros de auditoria que comprovem a criação dele. Para conseguir mais registros, confira o Guia de início rápido.

  • O intervalo de tempo é muito limitado? Use os menus suspensos abaixo da caixa de filtro de pesquisa para selecionar outros intervalos ou definir um intervalo personalizado. Selecione Ir para este ponto no tempo para filtrar os registros de uma determinada data e hora ou use o menu Ir para o momento atual para ver as entradas de registro atuais.

Minha pesquisa não está funcionando

Se você não sabe ao certo por que sua pesquisa não está funcionando na interface de filtro básico, basta alternar para a interface de filtro avançado:

  1. Selecione Converter em filtro avançado no menu com &blacktriangledown; ao final da caixa de pesquisa de filtro.
  2. Verifique se o filtro avançado está do jeito que você queria.
  3. Retorne à interface de filtro básica usando o botão Voltar do navegador.

Veja outros motivos por que talvez você não esteja vendo todas as entradas de registro esperadas:

  • Talvez você não veja as entradas de registro mais antigas do que o período de armazenamento do Stackdriver Logging. Consulte Períodos de retenção de registros para o período de retenção de registros em vigor.

  • Em períodos com uma grande carga, pode haver atrasos no envio dos registros para o Stackdriver Logging ou no recebimento e exibição deles.

  • O Visualizador 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 uma distorção no tempo do aplicativo que envia os registros.

A seguir

Esta página foi útil? Conte sua opinião sobre:

Enviar comentários sobre…

Stackdriver Logging
Precisa de ajuda? Acesse nossa página de suporte.