Ver registros de instancias

En esta página, se describe cómo usar Cloud Logging para ver y consultar registros de tu instancia de Cloud SQL.

Cloud Logging recopila automáticamente los datos de registro de tus instancias de Cloud SQL. Puedes usar Logging para consultar, ver y analizar tus datos de registro, lo que te ayudará a solucionar problemas y mejorar la observabilidad. Para obtener más información, consulta la documentación de Cloud Logging y revisa las consultas de muestra de Cloud SQL.

Antes de comenzar

Para obtener los permisos que necesitas para usar el Explorador de registros y ver las entradas de registro, pídele a tu administrador que te otorgue los siguientes roles de IAM:

  • Para ver las entradas de registro en el bucket _Required y las de la vista _Default en el bucket _Default, o para seleccionar un ámbito de registros: Visor de registros (roles/logging.viewer) en tu proyecto, carpeta u organización.
  • Para ver todas las entradas de registro en los buckets _Required y _Default: Visualizador de registros privados (roles/logging.privateLogViewer) en tu proyecto, carpeta u organización.

Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

También puedes obtener los permisos necesarios a través de roles personalizados o cualquier otro rol predefinido.

Ver registros

Para ver las entradas de registro de tu instancia de Cloud SQL, haz lo siguiente:

Console

  1. En la consola de Google Cloud , ve a la página de Cloud Logging.

    Ir a Cloud Logging

  2. Selecciona un proyecto de Cloud SQL.
  3. En el panel Consulta, realiza las siguientes selecciones:
    • Todos los recursos: selecciona Base de datos de Cloud SQL. En el cuadro de diálogo, selecciona una instancia de Cloud SQL.
    • Todos los nombres de registros: Ve a la sección de Cloud SQL y selecciona los archivos de registro apropiados para la instancia. Por ejemplo:
      • cloudsql.googleapis.com/sqlagent.out
      • cloudsql.googleapis.com/sqlserver.err
    • Todos los niveles de gravedad: Selecciona un nivel de gravedad. Por ejemplo, selecciona Error para ver los registros con un nivel de gravedad de, al menos, Error.
    • Selector de período: Selecciona una opción de tiempo preestablecida, especifica una hora de inicio y finalización personalizadas, o centra el período en una marca de tiempo específica.

gcloud

Usa el comando gcloud logging para ver las entradas del registro. En el siguiente ejemplo, reemplaza PROJECT_ID. La marca limit es un parámetro opcional que indica la cantidad máxima de entradas que se mostrarán.

gcloud logging read "resource.type=cloudsql_database" \
--project=PROJECT-ID \
--limit=10 \
--format=json

Ve el registro de operaciones de instancia

Puedes ver los registros de una instancia en el panel Operaciones. En el panel Operaciones se registra cada operación realizada en la instancia con la siguiente información:

  • La hora en que se completó la operación, en tu zona horaria local
  • El tipo de operación
  • El estado de la operación
  • Un mensaje que describe el resultado de la operación.

Si la operación falla, puedes usar el mensaje para solucionar el problema.

Para ver el registro de operaciones de una instancia, sigue estos pasos:

  1. En la consola de Google Cloud , ve a la página Instancias de Cloud SQL.

    Ir a Instancias de Cloud SQL

  2. Para abrir la página de Descripción general de una instancia, haz clic en su nombre.
  3. Ve al panel Operaciones y registros para ver el registro de operaciones.
Nota: En el registro de operaciones, no se incluyen operaciones realizadas con herramientas de administración externas, como las herramientas de línea de comandos de SQL Server. En el registro de operaciones, solo se incluyen las operaciones de administración de usuarios y cambio de contraseña que se realizan con la consola deGoogle Cloud , la gcloud CLI o la API de Cloud SQL Admin.

Ver los registros de la aplicación

Las aplicaciones que se conectan a Cloud SQL almacenan los registros en diferentes ubicaciones.

Entorno flexible de App Engine

Para ver los registros de tus servicios de App Engine, haz lo siguiente:

  1. Ve a la página Servicios de App Engine en la consola de Google Cloud :

    Ir a Servicios

  2. Selecciona un servicio de la tabla y haz clic en Registros en la columna Diagnosticar.

    Se te redireccionará al Explorador de registros con una consulta que recupera los registros de tu servicio de App Engine.

Para ver los registros de App Engine en la sección Explorador de registros de la consola deGoogle Cloud , usa una consulta como la siguiente:

resource.type="gae_app"
resource.labels.module_id="default"

Cloud Run

Para ver los registros de Cloud Run en la sección Explorador de registros de la consola deGoogle Cloud , usa una consulta como la siguiente:

resource.type="cloud_run_revision"
resource.labels.service_name="$SERVICE_NAME"
resource.labels.revision_name="$REVISION_NAME"

Ten en cuenta que Cloud Run solo informa mensajes de error del proxy de autenticación de Cloud SQL.

Proxy de autenticación de Cloud SQL

Para ver los registros del proxy de autenticación de Cloud SQL en la sección Explorador de registros de la consola deGoogle Cloud , usa una consulta como la siguiente:

log_id("appengine.googleapis.com/cloud-sql-proxy")

Ver registros de auditoría

Cloud SQL escribe registros de auditoría de Cloud para registrar las actividades administrativas y el acceso a los datos en tus recursos. Puedes ver los siguientes tipos de registros de auditoría para tus instancias de Cloud SQL:

  • Actividad del administrador: Entradas de registro escritas por llamadas a la API controladas por el usuario o por otras acciones que modifican la configuración o los metadatos de los recursos. No puedes desactivar estos registros.
  • Acceso a los datos: Entradas de registro escritas por llamadas a la API que leen la configuración o los metadatos de los recursos. Estos registros también incluyen operaciones que leen o escriben datos proporcionados por el usuario. Para escribir registros de auditoría de acceso a los datos, debes habilitarlos.
  • Eventos del sistema: Son entradas de registro escritas por los sistemas de Google Cloud y los agentes de servicios administrados que modifican la configuración de los recursos. No puedes desactivar estos registros.

Para obtener más información sobre cómo ver los registros de auditoría de Cloud SQL, incluida una lista completa de los métodos auditados, consulta Registros de auditoría de Cloud SQL para SQL Server.

Precios

Para obtener más información sobre los precios de Cloud Logging, consulta Resumen de precios de Cloud Logging.

Solucionar problemas

Problema Soluciona problemas
No se encuentran los registros de auditoría. Los registros de acceso a datos solo se escriben si la operación es una llamada a la API controlada por el usuario y autenticada que crea, modifica o lee datos creados por el usuario, o si la operación accede a metadatos o archivos de configuración de recursos.
No se encontró información de operaciones en los registros. Deseas encontrar más información sobre una operación.

Por ejemplo, se borró un usuario, pero no puedes averiguar quién lo hizo. Los registros muestran que la operación inició, pero no proporcionan más información. Debes habilitar el registro de auditoría para que se registre este tipo de información de identificación personal (PII) detallada.
Algunos registros se filtran del registro error.log de una instancia de Cloud SQL para SQL Server. En los registros filtrados, se incluyen los registros de AD sin marcas de tiempo y se incluye lo siguiente: Login failed for user 'x'. Reason: Token-based server access validation failed with an infrastructure error. Login lacks connect endpoint permission. [CLIENT: 127.0.0.1]. Estos registros se filtran porque existe la posibilidad de que causen confusión.
Los archivos de registro son difíciles de leer Prefieres ver los registros en formato JSON o de texto: puedes usar el comando gcloud logging read junto con los comandos de procesamiento posterior de Linux para descargar los registros.

Para descargar los registros en formato JSON, sigue estos pasos:

gcloud logging read \
"resource.type=cloudsql_database \
AND logName=projects/PROJECT_ID \
/logs/cloudsql.googleapis.com%2FLOG_NAME" \
--format json \
--project=PROJECT_ID \
--freshness="1d" \
> downloaded-log.json

Para descargar los registros como TEXT, sigue estos pasos:

gcloud logging read \
"resource.type=cloudsql_database \
AND logName=projects/PROJECT_ID \
/logs/cloudsql.googleapis.com%2FLOG_NAME" \
--format json \
--project=PROJECT_ID \
--freshness="1d"| jq -rnc --stream 'fromstream(1|truncate_stream(inputs)) \
| .textPayload' \
--order=asc
> downloaded-log.txt