Diagnosticar problemas

En esta página, se muestra una lista de los problemas más frecuentes que pueden generarse cuando trabajamos con instancias de Cloud SQL y los pasos que se pueden seguir para solucionarlos. También revisa las páginas Problemas conocidos, Solución de problemas y Página de asistencia.

View logs

Para ver información sobre operaciones recientes, puedes consultar los registros de operaciones de instancias de Cloud SQL o los registros de error de PostgreSQL.

Problemas de conexión

Consulta la página Depuración de problemas de conexión o la sección Conectividad de la página de solución de problemas para obtener ayuda con problemas de conexión.

Problemas de instancias

Copias de seguridad

Para obtener el mejor rendimiento de las copias de seguridad, mantén la cantidad de tablas en un número razonable.

Para otros problemas de copia de seguridad, consulta la sección Copias de seguridad en la página de solución de problemas.

Importación y exportación

Las importaciones en Cloud SQL y las exportaciones fuera de Cloud SQL pueden tardar mucho tiempo en completarse, según el tamaño de los datos que se procesan. Esto puede tener las siguientes consecuencias:

  • No puedes detener una operación de instancia de larga duración de Cloud SQL.
  • Solo puedes realizar una operación de importación o exportación a la vez para cada instancia, y una importación o exportación de larga duración bloquea otras operaciones, como las copias de seguridad automáticas diarias. Las exportaciones sin servidores te permiten ejecutar otras operaciones, como editar instancias, importar, conmutar por error y desbloquear copias de seguridad automáticas diarias.

Puedes disminuir la cantidad de tiempo que lleva completar cada operación mediante la función de importación o exportación de Cloud SQL con lotes de datos más pequeños.

En el caso de las exportaciones, puedes realizar la exportación desde una réplica de lectura o usar la exportación sin servidores para minimizar el impacto en el rendimiento de la base de datos y permitir que se ejecuten otras operaciones en tu instancia mientras se ejecuta una exportación.

Para otros problemas de importación y exportación, consulta la sección Importar y exportar de la página de solución de problemas.

Espacio en el disco

Si tu instancia alcanza la cantidad máxima de almacenamiento permitido, provoca un error de escritura en la base de datos. Por ejemplo, si borras los datos, como cuando quitas una tabla, el espacio se libera, pero no se reflejará en el Almacenamiento usado informado de la instancia. Puedes ejecutar el comando VACUUM FULL para recuperar el espacio que no se usó; ten en cuenta que las operaciones de escritura se bloquean mientras se ejecuta el comando de vaciado. Más información

Estado de suspensión

Existen varios motivos por los que Cloud SQL puede suspender una instancia, incluidos los siguientes:

  • Problemas de facturación

    Por ejemplo, si la tarjeta de crédito de la cuenta de facturación del proyecto caducó, se puede suspender la instancia. Si quieres verificar los datos de facturación de un proyecto, visita la página de facturación de la consola de Google Cloud, selecciona el proyecto y visualiza la información de la cuenta de facturación que se usó para el proyecto. Después de resolver el problema de facturación, la instancia vuelve al estado ejecutable en unas pocas horas.

  • Problemas de clave KMS

    Por ejemplo, si la versión de clave KMS usada para encriptar los datos del usuario en la instancia de Cloud SQL no está presente, o si se inhabilitó o destruyó. Consulta Usa claves de encriptación administradas por el cliente (CMEK).

  • Problemas legales

    Por ejemplo, una infracción de la Política de Uso Aceptable de Google Cloud puede provocar la suspensión de la instancia. Para obtener más información, consulta “Suspensiones y eliminaciones” en las Condiciones del Servicio de Google Cloud.

  • Problemas operativos

    Por ejemplo, si una instancia se bloquea en un bucle de fallas (si falla mientras se inicia o poco después del inicio), Cloud SQL puede suspenderla.

Mientras una instancia está suspendida, puedes continuar viendo información sobre ella o borrarla si los problemas de facturación activaron la suspensión.

Los usuarios de Cloud SQL con paquetes de asistencia Platino, Oro, o Plata se pueden comunicar directamente con nuestro equipo de asistencia al cliente si quieren obtener información acerca de las instancias suspendidas. Todos los usuarios pueden usar la guía anterior junto con el foro google-cloud-sql.

Rendimiento

Descripción general

Cloud SQL admite cargas de trabajo de alto rendimiento de hasta 60,000 IOPS y sin costo adicional para IO. * Las IOPS y el rendimiento de la capacidad de procesamiento de un disco persistente dependen de la cantidad de CPU virtuales de la instancia, del tamaño del bloque de E/S y del tamaño del disco, entre otros factores.

El rendimiento de tu instancia también depende del tipo de almacenamiento que elijas y de la carga de trabajo.

Conoce más sobre:

Mantén un número razonable de tablas de base de datos

Las tablas de base de datos consumen recursos del sistema. Una cantidad muy grande de estas tablas puede afectar el rendimiento y la disponibilidad de la instancia, y hacer que pierda su cobertura del ANS. Más información

Habilita registros de consultas

Puedes registrar consultas lentas en Cloud SQL para PostgreSQL si configuras la marca log_min_duration_statement. Se registrarán las consultas que se ejecutaron al menos durante el período especificado. Si este valor se especifica sin unidades, se toma como milisegundos. Navega a Registro de operaciones para ver los registros.

Sugerencias para un mejor rendimiento general

Asegúrate de que tu instancia no esté restringida en la memoria o la CPU. Para las cargas de trabajo de rendimiento intensivo, asegúrate de que tu instancia tenga al menos 60 GB de memoria. Para inserciones de base de datos, actualizaciones o eliminaciones lentas, verifica las ubicaciones del escritor y de la base de datos; el envío de datos a larga distancia genera latencia.

Mejora el rendimiento de las consultas con las Estadísticas de consultas.

Para la selección de base de datos lenta, considera lo siguiente:

  • El almacenamiento en caché es importante para el rendimiento de lectura. Verifica las diversas proporciones blks_hit / (blks_hit + blks_read) del recolector de estadísticas de PostgreSQL. Lo ideal sería que la proporción esté por encima del 99%. Si no es así, considera aumentar el tamaño de la RAM de tu instancia.
  • Si la carga de trabajo consta de consultas que requieren mucha CPU (ordenamiento, expresiones regulares y otras funciones complejas), es posible que se limite la instancia. Recomendamos que agregues CPU virtuales.
  • Verifica la ubicación del lector y de la base de datos. La latencia afecta el rendimiento de la lectura, incluso más que el de la escritura.
  • Investiga las mejoras de rendimiento no específico de Cloud SQL, como agregar la indexación adecuada, reducir los datos analizados y evitar las idas y vueltas adicionales.

Si observas un rendimiento bajo en la ejecución de consultas, usa EXPLAINpara identificar dónde agregar índices a las tablas y así mejorar el rendimiento de la consulta. Por ejemplo, asegúrate de que cada campo que usas como una clave JOIN tenga un índice en ambas tablas.

Solucionar problemas

Para otros problemas de Cloud SQL, consulta la página de solución de problemas.

Mensajes de error

Para ver mensajes de error de API específicos, consulta la página de referencia Mensajes de error.

Soluciona problemas de claves de encriptación administradas por el cliente (CMEK)

Las operaciones del administrador de Cloud SQL, como la creación, clonación o actualización, pueden fallar por errores de Cluod KMS y funciones o permisos faltantes. Entre los motivos más comunes de las fallas se incluyen una versión de clave de Cloud KMS faltante, una versión de clave de Cloud KMS inhabilitada o destruida, permisos de IAM insuficientes para acceder a la versión de clave de Cloud KMS o la ubicación de la versión de clave de Cloud KMS en una región diferente a la de la instancia de Cloud SQL. Usa la siguiente tabla de solución de problemas para diagnosticar y resolver problemas comunes.

Tabla de solución de problemas de claves de encriptación administradas por el cliente

Para este error… El problema podría ser… Prueba lo siguiente…
No se encontró la cuenta de servicio por proyecto ni por producto. El nombre de la cuenta de servicio es incorrecto. Asegúrate de haber creado una cuenta de servicio para el proyecto de usuario correcto.

IR A LA PÁGINA CUENTAS DE SERVICIO
No se puede otorgar acceso a la cuenta de servicio. La cuenta de usuario no tiene permiso para otorgar acceso a esta versión de clave. Agrega el rol Administrador de la organización a tu usuario o cuenta de servicio.

IR A LA PÁGINA CUENTAS DE IAM
Se destruye la versión de clave de Cloud KMS La versión de clave está destruida. Si la versión de clave se destruye, no podrás usarla para encriptar o desencriptar datos.
Se inhabilita la versión de la clave de Cloud KMS La versión de clave está inhabilitada. Vuelve a habilitar la versión de la clave de Cloud KMS.

IR A LA PÁGINA CLAVES CRIPTOGRÁFICAS
Permiso insuficiente para usar la clave de Cloud KMS Falta la función cloudkms.cryptoKeyEncrypterDecrypter en el usuario o la cuenta de servicio que usas para ejecutar operaciones en instancias de Cloud SQL, o la versión de la clave de Cloud KMS no existe. En el proyecto de Google Cloud que aloja la clave, agrega el rol cloudkms.cryptoKeyEncrypterDecrypter a tu usuario o cuenta de servicio.

IR A LA PÁGINA CUENTAS DE IAM


Si el rol ya se otorgó a tu cuenta, consulta la sección sobre cómo crear una clave para aprender cómo crear una versión de clave nueva. Consulta la nota.
No se encontró la clave de Cloud KMS La versión de clave no existe. Crea una versión de clave nueva. Consulta la página sobre cómo crear una clave. Consulta la nota.
La instancia de Cloud SQL y la versión de clave de Cloud KMS se encuentran en regiones diferentes. La versión de clave de Cloud KMS y la instancia de Cloud SQL deben estar en la misma región. No funciona si la versión de clave de Cloud KMS se encuentra en una región global o multirregión. Crea una versión de clave en la misma región donde deseas crear instancias. Consulta la página sobre cómo crear una clave. Consulta la nota.
Se restablece la versión de clave de Cloud KMS, pero la instancia sigue suspendida La versión de clave está inhabilitada o no otorga los permisos adecuados. Vuelve a habilitar la versión de clave y otorga el rol cloudkms.cryptoKeyEncrypterDecrypter a tu usuario o cuenta de servicio en el proyecto de Google Cloud que aloja la clave.

Tabla de solución de problemas de reencriptación

Para este error… El problema podría ser… Solución
No se pudo volver a encriptar el recurso CMEK porque no se puede acceder a la clave de Cloud KMS. Asegúrate de que la versión de clave primaria esté habilitada y de que el permiso se haya otorgado de forma correcta. La versión de clave está inhabilitada o no otorga los permisos adecuados.

Se vuelve a habilitar la versión de la clave de Cloud KMS.

IR A LA PÁGINA DE CLAVES CRIPTOGRÁFICAS

En el proyecto de Google Cloud que aloja la clave, confirma que el rol cloudkms.cryptoKeyEncrypterDecrypter se otorga a tu cuenta de servicio o usuario:

IR A LA PÁGINA CUENTAS DE IAM
No se pudo volver a encriptar el recurso CMEK debido al error interno del servidor. Vuelve a intentarlo más tarde. Hay un error interno del servidor. Vuelve a intentar la encriptación. A fin de obtener más información, consulta Vuelve a encriptar una instancia o réplica habilitada para CMEK existente.