Filtros básicos de registros

En esta guía se muestra cómo filtrar entradas de registro por etiqueta o búsqueda de texto en la interfaz de filtro básico del visor de registros.

Para ver opciones de filtrado más avanzadas, consulta Filtros avanzados de registros.

Si quieres exportar tus entradas de registro, visita Exporta registros. Para leer entradas de registro a través de la API, consulta entries.list. Si quieres leer entradas de registro con el SDK, visita Lee entradas de registro.

Comienza a usar filtros básicos

  1. Dirígete a la página Stackdriver Logging > Logs (Registros) (Logs Viewer) (Visor de registros) en GCP Console:

    Ir a la página Visor de registros

  2. Selecciona un proyecto de GCP existente en la parte superior de la página o crea un proyecto nuevo.

  3. Con los menús desplegables, selecciona el recurso cuyos registros quieres ver.

En la siguiente captura de pantalla se muestra la interfaz de filtro básico del visor de registros. Se muestran cuatro entradas desde una aplicación de App Engine. La segunda entrada se desplegó con un clic en la flecha desplegable (▶):

Visor de registros

La interfaz de filtro básico tiene los siguientes componentes principales (como lo indican los números rojos en la captura de pantalla de arriba), algunos de los cuales se comparten con la interfaz de filtro avanzado:

  1. Las pestañas de la ventana te permiten elegir Logs (Visor de registros), Metrics (Métricas) (consulta Métricas basadas en registros), Exports (Exportaciones) (consulta Exporta registros) y Logs ingestion (Transferencia de registros) (consulta Exclusiones de registros).
  2. El cuadro de filtro de búsqueda en la interfaz de filtro básico te permite filtrar entradas de registro mediante búsqueda de etiquetas o texto. El filtro básico se muestra, y la flecha desplegable (▼) en el extremo derecho te permite cambiar a la interfaz de filtro avanzado o, también, obtener un vínculo a tu filtro.
  3. Los menús de selección básicos te permiten elegir recursos, registros y niveles de gravedad para mostrar.
  4. Los menús desplegables de selector de intervalo de tiempo te permiten filtrar fechas y horarios específicos en los registros.
  5. El selector de transmisión, en la parte superior de la página, controla si las nuevas entradas de registro se muestran o no cuando llegan.
  6. La tabla de entrada de registros contiene las entradas de registro disponibles de acuerdo con tus archivos actuales y campos personalizados.
  7. La flecha desplegable (▶) frente a cada entrada de registro te permite mirar el contenido total de esa entrada. Para obtener más información, consulta Expande entradas de registro.
  8. El menú View Options (Ver opciones), en el extremo derecho, tiene opciones de visualización adicionales.
  9. El menú Download logs (Descargar registros), en el extremo derecho, te permite descargar un conjunto de entradas de registro.
  10. La opción More (Más) (⋮) que se muestra en cada entrada de registro, te permite colocar un marcador en esta, mostrarla en su contexto de recursos y copiar una URL para la entrada de registro en el portapapeles.

Por último, el visor de registros usa la posición del cursor para destacar la entrada de registro asociada y colocar un símbolo de alfiler (📌) junto a More (⋮).

Búsquedas básicas

En la interfaz de filtro básico, ingresa tu texto en el cuadro de filtro de búsqueda sobre los menús y presiona ENTRAR. La búsqueda muestra todas las entradas de registro que incluyen tus términos de búsqueda en cualquier lugar, en cualquier campo (excepto timestamp) y en minúsculas o mayúsculas. La palabra text: que el visor de registros agrega antes de tus términos de búsqueda indica que esta es una búsqueda de “todos los campos”.

A continuación, hay algunas búsquedas comunes y algunas que no producen el resultado que esperas.

Ejemplos de búsquedas básicas comunes

Unicorn (text:Unicorn)

Encuentra todas las entradas de registro que contienen unicorn, en cualquier campo y en minúsculas o mayúsculas.

unicorn phoenix (text:unicorn text:phoenix)

Encuentra todas las entradas de registro que contienen unicorn o phoenix, en el mismo campo o en campos diferentes. Si quieres encontrar entradas de registro que contengan ambos términos, usa la interfaz de filtro avanzado.

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

Encuentra todas las entradas de registro que contienen unicorn y phoenix en el mismo campo, en minúsculas o mayúsculas y separados por un espacio. La interfaz de filtro básico no es compatible con búsquedas de “unicorn y phoenix en el mismo campo”, pero la interfaz de filtro avanzado sí.

-unicorn (-text:unicorn)

Encuentra todas las entradas de registro que contienen unicorn en cualquier campo en minúsculas o mayúsculas y las excluye de las entradas visibles. La interfaz de filtro básico no es compatible con búsquedas de “-unicorn y -phoenix” en el mismo campo o en campos diferentes, pero la interfaz de filtro avanzado sí.

2345 (text:2345)

Encuentra todas las entradas de registro que contienen la string 2345. Los números en las entradas de registro suelen representarse como strings, así que esta coincide con, por ejemplo, 123456.

Búsquedas que no producen el resultado que esperas

uni* (text:uni*)
Esta no es una búsqueda comodín. Esta búsqueda encuentra todas las entradas de registro que contienen la string de 4 caracteres "uni*". El visor de registros no es compatible con búsquedas de expresiones regulares y no hay otros caracteres de comodín especiales como * o ?, ya sea en la interfaz de filtro básico o en la de filtro avanzado.
2017-02-05 (text:2017-02-05)
Esta no busca coincidencias con marcas de tiempo de entradas de registro. Esta búsqueda encuentra todas las entradas de registro que contienen la string 2017-02-05 en cualquier campo excepto timestamp. Si tus entradas de registro contienen strings de fechas en sus cargas útiles o en otros campos, puedes buscarlos. También puedes usar el menú Jump to date (Ir a fecha) bajo el cuadro de filtro de búsqueda. La interfaz de filtro avanzado te permite usar búsquedas que especifican un rango de marcas de tiempo.
200..299 (text:200..299)
Esto no busca coincidencias con 250. Esta interfaz de filtro básico encuentra entradas de registro que contienen la string de 8 caracteres "200..299". Esta notación de rangos solo se permite en búsquedas restringidas a campos de números enteros. Consulta Busca campos específicos.
unicorn NOT phoenix (text:unicorn text:NOT text:phoenix)
unicorn OR phoenix (text:unicorn text:OR text:phoenix)
Estas no son búsquedas de texto booleano, ya que la inclusión de operadores booleanos (AND, OR, NOT o AND NOT) no es compatible con las búsquedas de texto en el filtro básico. Si incluyes varios términos de búsqueda de texto, los términos están conectados de manera implícita por or. En lugar del operador booleano NOT, puedes usar el operador - (menos). Para obtener más información, consulta la sección Ejemplos de búsquedas básicas comunes de arriba.

Busca campos específicos

Puedes restringir tu búsqueda a un campo específico si agregas el nombre del campo y una coma delante de los términos de búsqueda. El nombre del campo reemplaza a text: en las búsquedas de todos los campos. A medida que escribes en el cuadro de filtros de búsqueda, puedes ver una lista de campos que coinciden:

Búsqueda básica de campos{ class="screenshot" }

En los siguientes ejemplos, status: es el código de estado HTTP de número entero y path: es la ruta de acceso HTTP en la solicitud:

path:query
Encuentra entradas de registro cuyas rutas de acceso HTTP contienen query en minúsculas o mayúsculas; por ejemplo, /query o /App/Query/17.
path:*
Encuentra entradas de registro que tienen un campo path. Este es un uso especial del carácter asterisco (*); por lo general, no se lo trata como un carácter especial.
status:200
Visualiza entradas de registro con un estado igual a 200. La búsqueda no coincide, por ejemplo, con un estado de 2000. Como se sabe que status es un campo de números enteros, la comparación es numérica.
status:abc
Ilegal, ya que se sabe que status contiene un número entero.
status:400..499
Encuentra entradas de registro con un estado HTTP de 400 a 499. Los rangos solo están disponibles para campos que se sabe que contienen números enteros. Si usas un rango para otros campos, el rango se interpreta como una sola string que contiene caracteres ..
path:query unicorn
Encuentra entradas de registro cuyos campos path contengan query y unicorn en cualquier campo. Ya que unicorn no tiene un nombre de campo adelante, es como si se escribiera text:unicorn. Cuando incluyes términos de búsqueda para campos diferentes o campos y text:, los términos están conectados de manera implícita por and.
path:query path:status
Encuentra entradas de registro cuyos campos path contengan query o status. Cuando incluyes varios términos de búsqueda para el mismo campo, los términos están conectados de manera implícita por or.
path:query status:200 path:status status:500..502
Encuentra entradas de registro que tienen rutas de acceso que contienen query o status y que tienen valores de status de 200, 500, 501, o 502. En otras palabras, or vincula de forma de más estrecha que and y el orden de los términos de búsqueda no importa.

Solución de problemas

Si no estás seguro de por qué tu búsqueda no funciona con la interfaz de filtro básico, cambia un momento a la interfaz de filtro avanzado:

  1. Selecciona Convert to advanced filter (Convertir en filtro avanzado) con la flecha desplegable (▼) en el extremo derecho del cuadro de filtros de búsqueda.

  2. Mira el cuadro de filtros de búsqueda para ver si es lo que pretendías.

  3. Vuelve a la interfaz de filtro básico con el botón Back (Atrás) del navegador. Si seleccionas esta opción, volverás a tus selecciones anteriores en la interfaz de filtro básico.

  4. Si identificaste filtros no deseados en el paso 2, puedes cambiar o borrarlos en el cuadro de filtros de búsqueda, el menú de selección básico o el menú de selección de rango de tiempo.

A continuación, te presentamos otras razones por las cuales podrías no ver todas las entradas de registro que esperas:

  • No puedes ver entradas de registro anteriores al período de retención de Stackdriver Logging. Consulta Períodos de retención de registros para conocer el período de retención de registros vigente.

  • Durante períodos de mucha carga podría haber demoras en el envío de registros a Stackdriver Logging o en la recepción y visualización de estos.

  • El visor de registros no muestra las entradas de registro con marcas de tiempo en el futuro hasta que el tiempo actual lo haya “alcanzado”. Esta es una situación poco común, que tal vez sea causada por un desvío temporal en la aplicación que envía los registros.

¿Te sirvió esta página? Envíanos tu opinión:

Enviar comentarios sobre…

Stackdriver Logging
¿Necesitas ayuda? Visita nuestra página de asistencia.