Diagnosticar problemas

En esta página se incluye una lista de los problemas más frecuentes que pueden surgir al trabajar con instancias de Cloud SQL y los pasos que puede seguir para solucionarlos. Consulta también las páginas Problemas conocidos, Solución de problemas y Página de asistencia.

Ver registros

Para ver información sobre las operaciones recientes, puedes consultar los registros de operaciones de la instancia de Cloud SQL o los registros de errores de PostgreSQL.

Problemas de conexión

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

Problemas con las instancias

Copias de seguridad

Para que las copias de seguridad tengan el mejor rendimiento posible, mantén un número razonable de tablas.

Si tienes otros problemas con las copias de seguridad, consulta la sección Copias de seguridad de la página de solución de problemas.

Importar y exportar

Las importaciones en Cloud SQL y las exportaciones desde Cloud SQL pueden tardar mucho tiempo en completarse, dependiendo del tamaño de los datos que se estén procesando. Esto puede tener los siguientes efectos:

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

Puedes reducir el tiempo necesario para completar cada operación usando 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 realizarlas desde una réplica de lectura o usar la exportación sin servidor para minimizar el impacto en el rendimiento de la base de datos y permitir que se ejecuten otras operaciones en tu instancia mientras se lleva a cabo una exportación.

Si tienes otros problemas con la importación y la exportación, consulta la sección Importación y exportación de la página de solución de problemas.

Espacio en disco

Si tu instancia alcanza la cantidad de almacenamiento máxima permitida, se producirán fallos en las operaciones de escritura en la base de datos. Si elimina datos, por ejemplo, eliminando una tabla, se libera espacio, pero no se refleja en el valor Almacenamiento usado de la instancia. Puedes ejecutar el comando VACUUM FULL para recuperar el espacio no utilizado. Ten en cuenta que las operaciones de escritura se bloquean mientras se ejecuta el comando VACUUM FULL. Más información

Estado suspendido

Hay varios motivos por los que Cloud SQL puede suspender una instancia, entre los que se incluyen los siguientes:

  • Problemas de facturación

    Por ejemplo, si la tarjeta de crédito de la cuenta de facturación del proyecto ha caducado, la instancia puede suspenderse. Para consultar la información de facturación de un proyecto, ve a la Google Cloud página de facturación de la consola, selecciona el proyecto y consulta la información de la cuenta de facturación que se usa en él. Una vez que resuelva el problema de facturación, la instancia volverá al estado ejecutable en unas horas.

  • Problemas clave de Cloud Key Management Service

    Por ejemplo, si no está presente la versión de la clave de Cloud KMS que se usa para cifrar los datos de usuario en la instancia de Cloud SQL, se revoca el acceso a la clave o se desactiva o elimina la clave. Para obtener más información, consulta Usar claves de cifrado gestionadas por el cliente (CMEK).

  • Problemas legales

    Por ejemplo, si se infringe la Google Cloud Política de Uso Aceptable, se puede suspender la instancia. Para obtener más información, consulta la sección "Suspensiones y retiradas" de los Google Cloud Términos del Servicio.

  • Problemas operativos

    Por ejemplo, si una instancia se queda atascada en un bucle de fallos (falla al iniciarse o justo después de iniciarse), Cloud SQL puede suspenderla.

Mientras una instancia está suspendida, puedes seguir viendo información sobre ella o eliminarla si los problemas de facturación han provocado la suspensión.

Los usuarios de Cloud SQL con paquetes de asistencia Platino, Oro o Plata pueden ponerse en contacto directamente con nuestro equipo de asistencia para solucionar el problema de las instancias suspendidas. Todos los usuarios pueden usar las directrices anteriores junto con el foro google-cloud-sql.

Rendimiento

Información general

Cloud SQL admite cargas de trabajo que exigen un rendimiento intensivo,ya que ofrece hasta 60.000 IOPS sin coste adicional por E/S. El rendimiento de las IOPS y el rendimiento dependen del tamaño del disco, el número de vCPUs de la instancia y el tamaño del bloque de E/S, entre otros factores.

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

Consulta más información sobre lo siguiente:

Mantener un número razonable de tablas de bases de datos

Las tablas de bases de datos consumen recursos del sistema. Un número elevado puede afectar al rendimiento y la disponibilidad de la instancia, así como provocar que pierda la cobertura de su acuerdo de nivel de servicio. Más información

Habilitar registros de consultas

Para registrar las consultas lentas de Cloud SQL para PostgreSQL, puedes definir la marca log_min_duration_statement. Se registrarán las consultas que se hayan ejecutado durante al menos el tiempo especificado. Si se especifica este valor sin unidades, se considera que está en milisegundos. Ve a Registro de operaciones para ver los registros.

Consejos de rendimiento general

Asegúrate de que tu instancia no tenga limitaciones de memoria o CPU. En el caso de las cargas de trabajo que requieren un alto rendimiento, asegúrate de que tu instancia tenga al menos 60 GB de memoria . Si las inserciones, actualizaciones o eliminaciones de la base de datos son lentas, comprueba las ubicaciones del escritor y de la base de datos. Si los datos se envían a una distancia larga, se introduce latencia.

Mejora el rendimiento de las consultas con Información valiosa sobre las consultas.

En el caso de las selecciones lentas en la base de datos, ten en cuenta estos aspectos:

  • El almacenamiento en caché es importante para el rendimiento de lectura. Consulta las distintas blks_hit / (blks_hit + blks_read) ratios del recogedor de estadísticas de PostgreSQL. Lo ideal es que la proporción sea superior al 99%. Si no es así, considera la posibilidad de aumentar el tamaño de la RAM de tu instancia.
  • Si tu carga de trabajo consta de consultas que consumen muchos recursos de CPU (ordenación, expresiones regulares u otras funciones complejas), es posible que tu instancia se limite. En ese caso, añade vCPUs.
  • Comprueba la ubicación del lector y de la base de datos, ya que la latencia afecta al rendimiento de lectura incluso más que al de escritura.
  • Busca mejoras de rendimiento no relacionadas con Cloud SQL, como añadir una indexación adecuada, reducir los datos escaneados y evitar más idas y vueltas.

Si observas que el rendimiento de las consultas es bajo, usa EXPLAIN para identificar dónde añadir índices a las tablas y mejorar el rendimiento de las consultas. Por ejemplo, asegúrate de que cada campo que usas como clave JOIN tenga un índice en ambas tablas.

Solucionar problemas

Si tienes otros problemas con Cloud SQL, consulta la página de solución de problemas.

Mensajes de error

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

Solucionar problemas de claves de cifrado gestionadas por el cliente (CMEK)

Las operaciones de administrador de Cloud SQL, como crear, clonar o actualizar, pueden fallar debido a errores de Cloud KMS y a la falta de roles o permisos. Entre los motivos habituales por los que se produce un error se incluyen los siguientes: falta una versión de la clave de Cloud KMS, la versión de la clave de Cloud KMS está inhabilitada o destruida, no se tienen permisos de IAM suficientes para acceder a la versión de la clave de Cloud KMS o la versión de la clave de Cloud KMS está en una región diferente a la de la instancia de Cloud SQL. Usa la siguiente tabla para diagnosticar y resolver problemas habituales.

Tabla de solución de problemas de claves de cifrado gestionadas por el cliente

Para este error... El problema puede deberse a lo siguiente: Prueba esto...
No se ha encontrado la cuenta de servicio por producto y por proyecto El nombre de la cuenta de servicio no es correcto. 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 conceder acceso a la cuenta de servicio La cuenta de usuario no tiene permiso para conceder acceso a esta versión de la clave. Añade el rol Administrador de la organización a tu cuenta de usuario o de servicio.

IR A LA PÁGINA CUENTAS DE IAM

La versión de la clave de Cloud KMS se ha destruido La versión de la clave se elimina. Si se destruye la versión de la clave, no podrás usarla para encriptar ni desencriptar datos.
La versión de la clave de Cloud KMS está inhabilitada La versión de la clave está inhabilitada. Vuelve a habilitar la versión de la clave de Cloud KMS.

IR A LA PÁGINA DE CLAVES CRIPTOGRÁFICAS

Permiso insuficiente para usar la clave de Cloud KMS Falta el rol cloudkms.cryptoKeyEncrypterDecrypter en la cuenta de usuario o de servicio que estás usando para ejecutar operaciones en instancias de Cloud SQL, o bien no existe la versión de la clave de Cloud KMS. En el Google Cloud proyecto que aloja la clave, añade el rol cloudkms.cryptoKeyEncrypterDecrypter a tu usuario o cuenta de servicio.

IR A LA PÁGINA CUENTAS DE IAM


Si el rol ya se ha asignado a tu cuenta, consulta Crear una clave para saber cómo crear una nueva versión de la clave. Consulta la nota.
No se ha encontrado la clave de Cloud KMS La versión de la clave no existe. Crea una versión de clave. Consulta Crear una clave. Consulta la nota.
La instancia de Cloud SQL y la versión de la clave de Cloud KMS están en regiones diferentes La versión de la clave de Cloud KMS y la instancia de Cloud SQL deben estar en la misma región. No funciona si la versión de la clave de Cloud KMS está en una región global o multirregional. Crea una versión de la clave en la misma región en la que quieras crear instancias. Consulta Crear una clave. Consulta la nota.
Se ha restaurado la versión de la clave de Cloud KMS, pero la instancia sigue suspendida La versión de la clave está inhabilitada o no concede los permisos adecuados. Vuelve a habilitar la versión de la clave y asigna el rol cloudkms.cryptoKeyEncrypterDecrypter a tu usuario o cuenta de servicio en el Google Cloud proyecto que aloja la clave.

Tabla de solución de problemas de recifrado

Para este error... El problema puede deberse a lo siguiente: Prueba esto...
No se ha podido volver a cifrar el recurso CMEK porque no se puede acceder a la clave de Cloud KMS. Asegúrate de que la versión de la clave principal esté habilitada y de que el permiso se haya concedido correctamente. La versión de la clave está inhabilitada o no concede los permisos adecuados.

Vuelve a habilitar la versión de la clave de Cloud KMS:

IR A LA PÁGINA CLAVES CRIPTOGRÁFICAS

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

IR A LA PÁGINA CUENTAS DE IAM
No se ha podido volver a cifrar el recurso de CMEK debido a un error interno del servidor. Vuelve a intentarlo más tarde. Se ha producido un error interno del servidor. Vuelve a intentar el recifrado. Para obtener más información, consulta Volver a cifrar una instancia o una réplica con CMEK.