Consultas básicas sobre registros

En esta guía, se muestra cómo consultar entradas de registro buscando texto o etiquetas en la interfaz de consultas básicas del visor de registros.

Para conocer más opciones de consulta de registros avanzados, visita la página sobre consultas de registro avanzadas.

Para exportar entradas de registro, consulta la página sobre cómo exportar registros. Para leer entradas de registro a través de la API, visita entries.list. Si quieres leer entradas de registro con el SDK, visita la página sobre cómo leer entradas de registro.

Comienza con las consultas básicas

  1. Ve a la página Stackdriver Logging > Registros (Visor de registros) en Cloud Console:

    Ir a la página Visor de registros

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

  3. En el menú desplegable , selecciona el recurso cuyos registros quieres ver.

En la siguiente captura de pantalla, se muestra la interfaz de consultas básicas de registros. Se muestran cuatro entradas de una aplicación de App Engine. La segunda entrada se expandió mediante un clic en la flecha de expansión .

Interfaz de usuario que muestra las opciones de consultas básicas de registros.

La interfaz de consultas básicas tiene los siguientes componentes principales (indicados con números rojos en la captura de pantalla), algunos de los cuales se comparten con la interfaz de consultas avanzadas:

  1. Las pestañas de la ventana te permiten elegir Registros (Visor de registros), Métricas (consulta Descripción general de las métricas basadas en registros), Exportaciones (consulta Exporta con el visor de registros) y Transferencia de registros (consulta Exclusiones de registros).
  2. El cuadro de consulta de búsqueda en la interfaz de consultas básicas de registros te permite consultar entradas de registro si buscas texto o etiquetas. Se muestra la interfaz de consultas básicas, pero el menú desplegable te permite cambiar a la interfaz de consultas avanzadas, o bien obtener un vínculo a tu consulta. Las consultas de registro se etiquetan como “filtros” en la interfaz de usuario, ya que te permiten seleccionar un conjunto específico de entradas de registro.
  3. Los menús de selección básicos te permiten elegir recursos, registros y niveles de gravedad para mostrar.

    • Recursos: los recursos disponibles en tu proyecto actual
    • Registros: los tipos de registro disponibles para los recursos actuales de tu proyecto
    • Gravedad del registro: los niveles de gravedad del registro
  4. Los menús desplegables del selector de rango de tiempo te permiten consultar fechas y horas específicas en los registros.

  5. El selector de transmisión en la parte superior de la página controla si las entradas de registro nuevas se muestran o no a medida que llegan.

  6. La tabla de entrada de registro contiene las entradas de registro disponibles según tus consultas actuales y los campos personalizados.

  7. La flecha de expansión delante de cada entrada de registro te permite ver el contenido completo de la entrada. Para obtener más información, consulta cómo expandir las entradas de registro en esta página.

  8. El menú Ver opciones (View Options) tiene opciones de visualización adicionales.

  9. El menú Descargar registros (Download logs) te permite descargar un conjunto de entradas de registro.

  10. Las opciones Más que se muestran con cada entrada de registro te permiten colocar un marcador en la entrada de registro, mostrar la entrada de registro en el contexto del recurso y copiar una URL para la entrada de registro al portapapeles.

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

Búsquedas básicas

En la interfaz de consultas básicas, ingresa el texto en el cuadro de consulta de búsqueda y selecciona INTRO. La búsqueda muestra todas las entradas de registro que incluyen los términos de búsqueda en cualquier lugar y en cualquier campo (excepto timestamp), tanto en mayúsculas como en minúsculas. La palabra text: que el visor de registros agrega antes de los términos de búsqueda indica que se trata de una búsqueda en "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)

Busca todas las entradas de registro que contienen unicorn y en cualquier campo, tanto en mayúsculas como en minúsculas.

unicorn phoenix (text:unicorn text:phoenix)

Busca todas las entradas de registro que contengan unicorn o phoenix, en los mismos campos o en campos diferentes. Si quieres buscar entradas de registro que contengan ambos términos, usa la interfaz de consultas avanzadas.

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

Busca todas las entradas de registro que contengan unicorn y phoenix en el mismo campo, tanto en mayúsculas como en minúsculas, separadas por un solo espacio. La interfaz de consultas básicas de registros no admite la búsqueda de "unicorn y phoenix" en el mismo campo, pero la interfaz de consultas avanzadas sí.

-unicorn (-text:unicorn)

Busca todas las entradas de registro que contengan unicorn en cualquier campo, tanto en mayúsculas como en minúsculas, y las excluye de las entradas que se muestran. La interfaz de consultas básicas de registros no admite la búsqueda de "-unicorn y -phoenix" en el mismo campo o en campos diferentes, pero la interfaz de consultas avanzadas de registros 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 se encarga de todas las entradas de registro que contengan una string "uni*" de 4 caracteres. El visor de registros no admite búsquedas de expresiones regulares y no hay caracteres comodín especiales, como * o ?, en las interfaces de consultas básicas o avanzadas.
2017-02-05 (text:2017-02-05)
Esto no busca coincidencias con marcas de tiempo de entradas de registro. Esta búsqueda rastrea todas las entradas de registro que contengan 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ú Ir a la fecha. La interfaz de consultas avanzadas de registros te permite utilizar búsquedas donde se especifica un intervalo de marcas de tiempo.
200..299 (text:200..299)
Esto no busca coincidencias con 250. La búsqueda de la interfaz de consultas básicas rastrea entradas de registro que contengan la string "200..299" de 8 caracteres. Esta notación de rangos solo se permite en búsquedas restringidas a campos de números enteros. Ve a Busca campos específicos en esta página.
unicorn NOT phoenix (text:unicorn text:NOT text:phoenix)
unicorn OR phoenix (text:unicorn text:OR text:phoenix)
Estas búsquedas no son booleanas de texto, ya que los operadores booleanos (Y, O, NO o Y NO) no son compatibles con las búsquedas de texto en las consultas básicas de registros. Si incluyes varios términos de búsqueda de texto, estos se conectan implícitamente mediante o. En lugar del operador booleano NOT, puedes usar el operador - (menos). Para obtener más información, consulta Ejemplos de búsqueda básica comunes en esta página.

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 todo el campo. A medida que escribas en el cuadro de consulta de búsqueda, verás una lista de campos que coinciden:

Cuadro de consulta de búsqueda que muestra los campos que coinciden.

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

path:query
Busca entradas de registro cuya ruta de acceso HTTP contenga query en mayúsculas o minúsculas, por ejemplo: /query o /App/Query/17.
path:*
Busca entradas de registro que tengan 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. Dado que status es un campo de número entero, 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
Busca entradas de registro cuyos campos pathcontengan query y unicorn en cualquier campo. Debido a que unicorn no está precedido por un nombre de campo, es como si escribieras text:unicorn. Cuando incluyes términos de búsqueda para campos diferentes, o para campos y text:, los términos están implícitamente conectados con y.
path:query path:status
Busca las entradas de registro cuyo campo path contiene 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 o.
path:query status:200 path:status status:500..502
Busca entradas de registro cuyas rutas contengan query o status, y que tengan valores de status de 200, 500, 501 o 502. En otras palabras, o vincula de forma de más estrecha que y, 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 en la interfaz de consultas básicas de registros, cambia brevemente a la interfaz de consultas avanzadas:

  1. Selecciona Convertir en filtro avanzado mediante el menú desplegable en el cuadro de búsqueda.

  2. Observa el cuadro de búsqueda de consultas para ver si es lo que deseas.

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

  4. Si identificaste consultas no deseadas en el paso 2, puedes cambiarlas o borrarlas en el cuadro de búsqueda, en el menú del selector básico o en el menú del selector de intervalo 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 las entradas de registro anteriores al período de retención de 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, puede haber demoras en el envío de registros a Logging o en la recepción y visualización de los registros.

  • 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, posiblemente causada por un desvío temporal en la aplicación que envía los registros.