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 mais avançadas de filtragem de registros, consulte Filtros de registros 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 básica de filtros 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

A interface de filtros de registros básicos tem os seguintes componentes principais (indicados por números vermelhos na captura de tela acima), onde alguns são compartilhados com a interface de filtros de registros avançados:

  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 filtros de registros básicos permite filtrar as entradas de registro por pesquisa de rótulo ou texto. A interface de filtros de registros básicos é mostrada e a seta suspensa (& blacktriangledown;) na extrema direita permite alternar para a interface de filtros de registros avançados 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 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 filtros de registro básicos, insira o texto na caixa de filtro de pesquisa acima dos menus e pressione ENTER. A pesquisa retorna todas as entradas de registro que incluem os termos de pesquisa em qualquer lugar e em qualquer campo (exceto timestamp) e em letras maiúsculas ou minúsculas. A palavra text: que o visualizador de registros adiciona antes do(s) termo(s) de pesquisa indica que essa é uma pesquisa de "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 de registro que contenham ambos os termos, use a interface de filtros de registros avançados.

"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 filtros de registro básicos não suporta a pesquisa por "unicorn e phoenix em qualquer lugar no mesmo campo", mas a interface de filtros de registros avançados sim.

-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 filtros de registros básicos não suporta a pesquisa de "-unicorn e -phoenix" no mesmo ou em diferente(s) campo(s), mas a interface do filtro registros avançados sim.

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 oferece suporte a pesquisas de expressões regulares e não há caracteres curinga especiais, como * ou ?, nas interfaces de filtros de registros básicos ou avançados.
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. A interface de filtros de registros avançados permite usar pesquisas que especificam um intervalo de registros de data e hora.
200..299 (text:200..299)
Isso não corresponde a 250. A pesquisa na interface de filtros de registros básicos encontra entradas de registro contendo a cadeia de oito caracteres "200..299". 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 de registro básico. Se vários termos de pesquisa de texto forem incluídos, os termos serão implicitamente conectados por ou. Em vez do operador booleano NOT, é possível usar o operador - (menos). Para detalhes, consulte Exemplos de pesquisa básica comuns.

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 termos de pesquisa são incluídos 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.

Resolver problemas

Se não tiver certeza do motivo pelo qual a pesquisa não está funcionando na interface de filtros de registros básicos, alterne brevemente para a interface de filtros de registros avançados:

  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 filtros de registros básicos usando o botão Voltar do navegador. Selecionar essa opção retorna para as seleções anteriores na interface de filtros de registros básicos.

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

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.