Filtros de registros básicos

Neste guia, mostramos como filtrar as entradas do registro por rótulo ou pesquisa de texto na interface de filtros básica do Visualizador de registros.

Para opções de filtragem mais avançadas, consulte Filtros de registro avançados.

Para exportar as entradas de registro, consulte Como exportar registros. Para ler as entradas usando a API, consulte entries.list. Também é possível ler com o SDK. Consulte Como ler entradas de registro.

Primeiros passos com filtros básicos

  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.

A captura de tela a seguir mostra a interface de filtros básica do Visualizador de registros. Quatro entradas de registro de um aplicativo do App Engine são mostradas. A visualização da segunda entrada foi ampliada ao clicar na seta de expansão (▸):

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 de janela permitem escolher Registros (Visualizador de registros), Métricas (consulte Métricas com base em registros), Exportações (consulte Como exportar 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 é mostrado, 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 saber mais informações, consulte Expandir entradas de registro.
  8. O menu Ver opções, na extremidade direita, tem mais opções de exibição.
  9. O menu Download de registros, na extremidade direita, permite 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 (⋮).

Pesquisas básicas

Na interface de filtro básico, digite o texto na caixa de filtro de pesquisa acima dos menus e pressione ENTER. A pesquisa retornará todas as entradas de registro que incluem os termos de pesquisa em qualquer lugar e em qualquer campo (exceto timestamp), em letras maiúsculas ou minúsculas. A palavra text: que o Visualizador de registros adiciona antes dos termos da pesquisa indica que ela inclui "todos os campos".

Veja a seguir algumas pesquisas comuns e outras que não atendem às expectativas.

Exemplos comuns de pesquisa básica

Unicorn (text:Unicorn)

Encontra todas as entradas de registro que contêm unicorn, em qualquer campo e em letras minúsculas e maiúsculas.

unicorn phoenix (text:unicorn text:phoenix)

Encontra todas as entradas de registro contendo unicorn ou phoenix em campos iguais ou diferentes. Se quiser entradas com ambos os termos, use a interface de filtro avançado.

"unicorn phoenix" (text:"unicorn phoenix")

Encontra todas as entradas de registro contendo unicorn e phoenix no mesmo campo, em letras minúsculas e maiúsculas, separadas por exatamente um espaço. A interface de filtro básico não aceita a pesquisa de "unicorn e phoenix em qualquer lugar no mesmo campo". É possível fazer isso na interface de filtro avançado.

-unicorn (-text:unicorn)

Encontra todas as entradas de registro contendo unicorn em qualquer campo e em maiúsculas ou minúsculas e as exclui das entradas exibidas. A interface de filtro básico não aceita a pesquisa de "-unicorn e -phoenix" em campos iguais ou diferentes. É possível fazer isso na interface de filtro avançado.

2345 (text:2345)

Encontra todas as entradas de registro que contêm a string 2345. Os números nas entradas geralmente são representados como strings. Portanto, isso corresponde a 123456, por exemplo.

Pesquisas que falham

uni* (text:uni*)
Esta não é uma pesquisa curinga. Ela encontra todas as entradas de registro que contêm a string "uni*" de 4 caracteres. O Visualizador de registros não é compatível com pesquisas de expressões regulares, e não há caracteres curingas especiais como * ou ? nas interfaces de filtros básica e avançada.
2017-02-05 (text:2017-02-05)
Não corresponde a carimbos de data/hora de entradas de registro. Essa pesquisa encontra todas as entradas de registro que contêm a string 2017-02-05 em qualquer campo, exceto timestamp. É possível pesquisar as entradas de registro se elas tiverem strings de data no payload ou em outros campos. Também é possível usar o menu Pular para data abaixo da caixa de filtro de pesquisa. Na interface de filtro avançado, é possível fazer pesquisas que especifiquem um intervalo de carimbos de data/hora.
200..299 (text:200..299)
Não corresponde a 250. Essa pesquisa na interface de filtros básica encontra entradas de registro que contêm a string "200..299" de 8 caracteres. Essa notação de intervalo só é permitida em pesquisas restritas a campos com números inteiros. Consulte Como pesquisar campos específicos.
unicorn NOT phoenix (text:unicorn text:NOT text:phoenix)
unicorn OR phoenix (text:unicorn text:OR text:phoenix)
Essas não são pesquisas de texto booleano, já que não é possível incluir operadores booleanos (AND, OR, NOT ou AND NOT) em pesquisas de texto no filtro básico. Se você incluir vários termos de pesquisa de texto, eles serão implicitamente conectados por or. Em vez do operador booleano NOT, é possível usar o operador - (sinal de subtração). Para saber detalhes, consulte a seção Exemplos de pesquisas básica comuns acima.

Como pesquisar campos específicos

É possível restringir a pesquisa a um campo específico. Basta adicionar o nome do campo e um sinal de dois pontos na frente dos termos buscados. O nome do campo substitui text: nas pesquisas em todos os campos. Ao digitar na caixa de filtro de pesquisa, você vê uma lista de campos correspondentes:

Pesquisa básica de campo{ class="screenshot" }

Nos exemplos a seguir, status: é o código de status HTTP completo e path: é o caminho HTTP na solicitação:

path:query
Encontra entradas de registro com caminho HTTP que contém query em letras minúsculas e maiúsculas. Por exemplo, /query ou /App/Query/17.
path:*
Encontra entradas de registro com um campo path. Esse é um uso especial do asterisco (*). Geralmente, ele não é tratado como um caractere especial.
status:200
Exibe entradas de registro com um status de exatamente 200. A pesquisa não corresponde, por exemplo, a um status de 2000. Como status é um campo de número inteiro, a comparação é numérica.
status:abc
Inválido porque status contém um número inteiro.
status:400..499
Encontra entradas de registro com um status HTTP de 400 até 499. Os intervalos só estão disponíveis para campos que contêm números inteiros. Se você usa um intervalo em outros campos, ele é interpretado como uma única string que contém caracteres ..
path:query unicorn
Encontra entradas de registro com campos path contendo query e unicorn em qualquer campo. Como unicorn não é precedido por um nome de campo, é como se você escrevesse text:unicorn. Quando você inclui termos de pesquisa em diferentes campos ou nos campos e em text:, os termos são conectados implicitamente com e.
path:query path:status
Encontra entradas de registro com o campo path contendo query ou status. Os termos de pesquisa são implicitamente unidos com or quando você inclui vários deles.
path:query status:200 path:status status:500..502
Encontra entradas de registro com caminhos contendo query ou status e que tenham valores de status como 200, 500, 501 ou 502. Em outras palavras, or se liga mais do que and, e a ordem dos termos de pesquisa não importa.

Solução de problemas

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

  1. Selecione Converter em filtro avançado usando a seta suspensa (▾) na extrema direita da caixa de filtro de pesquisa.

  2. Verifique se a caixa de filtro de pesquisa está do jeito que você espera.

  3. Retorne à interface de filtro básico usando o botão Voltar do navegador. Essa opção retorna às seleções anteriores na interface de filtros básica.

  4. Se você identificou filtros não intencionais no passo dois, poderá alterá-los ou excluí-los na caixa de pesquisa de filtros, no menu de seleção básico ou no menu de seleção de período.

Veja outros motivos pelos quais você pode não ver 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.

  • Durante os períodos de carga grande, talvez haja atrasos no envio dos registros para o Stackdriver Logging ou no recebimento e na exibição deles.

  • O Visualizador de registros não mostra as entradas de registro que tenham carimbos 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.

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.