Consultas básicas sobre registros

En esta guía, se muestra cómo consultar las entradas de registro por etiqueta o búsqueda de texto en la interfaz de consulta básica del visor de registros heredado. Para obtener más opciones de consultas de registro avanzadas con el Visor de registros heredado, consulta Consultas de registros avanzadas.

Para exportar entradas de registro, consulta Exporta con el visor de registros heredado. 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 Registro del paquete de operaciones de Google Cloud > Registros en Cloud Console:

    Ir a la página Visor de registros

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

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

En la siguiente captura de pantalla, se muestra la interfaz de consulta básica. 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. Los modelospestañas de ventanas le permiten elegirRegistros (Visor de registros heredado)Métricas (consultaMétricas basadas en registros ).Exportaciones (consultaExporta registros ).Transferencia de registros (consultaExclusiones 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 consulta básica, y el menú desplegable te permite obtener un vínculo a tu consulta o cambiar a la interfaz de consulta avanzada. 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 Expande entradas de registro en esta página.

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

  9. El menú Download logs (Descargar registros) 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 heredado utiliza la posición del cursor para destacar la entrada de registro asociada y colocar un símbolo de alfiler (📌) junto a 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 heredado 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, en mayúsculas o en minúsculas, separadas por un solo espacio. La interfaz de consulta de registros básica no admite la búsqueda de “unicorn y phoenix” en cualquier parte del mismo campo, pero la interfaz de consulta avanzada sí.

-unicorn (-text:unicorn)

Busca todas las entradas de registro que contengan unicorn en cualquier campo, en mayúsculas o en minúsculas, y las excluye de las entradas que se muestran. La interfaz de consulta de registros básica no admite la búsqueda de “-unicorn y -phoenix” en el mismo campo o en otros, pero la interfaz de consulta de registros avanzada 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 mediante comodines de expresiones regulares. Esta búsqueda se encarga de todas las entradas de registro que contengan una string "uni*" de 4 caracteres. Ten en cuenta que la interfaz de consulta básica no admite búsquedas de expresiones regulares y no puedes aplicar caracteres comodín especiales como * o ?. Para usar expresiones regulares en la interfaz de consulta avanzada, ve a Consulta entradas mediante expresiones regulares.
2017-02-05 (text:2017-02-05)
Esta opción no coincide con las marcas de tiempo de las 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)
Esta opción no coincide con 250. La búsqueda de la interfaz de consulta básica 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 opciones no son búsquedas de texto booleanas, ya que incluir operadores booleanos (AND, OR, NOT o AND NOT) no es compatible con las búsquedas de texto en la consulta de registros básica. Si incluyes varios términos de búsqueda de texto, estos se conectan de forma implícita 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 de asterisco (*); por lo general, no se 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 path contengan query y que contengan unicorn en cualquier campo. Como 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 campos y text:, los términos están conectados de forma implícita 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 manera más estrecha que y, y el orden de los términos de búsqueda no importa.

Soluciona problemas

Si no estás seguro de por qué tu búsqueda no funciona en la interfaz de consultas de registros básica, cambia por un momento a la interfaz de consulta avanzada:

  1. Selecciona Convertir a 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 heredados no muestra las entradas de registro con marcas de tiempo en el futuro hasta que el tiempo actual lo “alcance”. Esta es una situación poco común, posiblemente causada por un desvío temporal en la aplicación que envía los registros.