Usa la consola de Omni de Spanner

Spanner Omni incluye la consola de Spanner Omni, que muestra el estado y otra información importante sobre tus implementaciones.

Inicia la consola de Spanner Omni

Descarga la consola de Spanner Omni para ejecutar una sola instancia para toda tu implementación. Para obtener más información, consulta Descarga Spanner Omni.

Usa la consola de Spanner Omni con implementaciones de un solo servidor

Para iniciar la consola de Spanner Omni con una implementación de un solo servidor, haz lo siguiente:

  1. Sigue los pasos que se indican en Configura Spanner Omni.

  2. Ejecuta el comando start-single-server para iniciar el servidor de Spanner.

  3. Inicia la consola de Spanner Omni. Si usas contenedores, ejecuta el siguiente comando:

    docker exec -it spanneromni /google/spanner/bin/omni-jre/bin/java -jar /google/spanner/bin/spanner-console

    La consola de Spanner Omni usa las mismas marcas que la CLI de Spanner Omni.

    • Para ejecutar con TLS, usa lo siguiente:

      docker exec -it spanneromni /google/spanner/bin/omni-jre/bin/java -jar \
    /google/spanner/bin/spanner-console \
    --ca-certificate-file=PATH_TO_CA_FILE

    • Para ejecutar con mTLS, usa lo siguiente:

      docker exec -it spanneromni /google/spanner/bin/omni-jre/bin/java -jar \
    /google/spanner/bin/spanner-console \
    --ca-certificate-file=PATH_TO_CA_FILE \
    --client-certificate-directory=PATH_TO_CLIENT_CERT_DIR

    Reemplaza lo siguiente:

    • PATH_TO_CA_FILE: Es la ruta de acceso al archivo del certificado de la entidad certificadora (CA).
    • PATH_TO_CLIENT_CERT_DIR: Es la ruta de acceso al directorio del certificado del cliente.

  4. En tu navegador, ve a http://localhost:15026 para acceder a la consola de Spanner Omni.

Usa la consola de Spanner Omni con implementaciones zonales, regionales y de varios clústeres

En el caso de las implementaciones basadas en Kubernetes, la consola de Spanner Omni se implementa cuando creas una implementación. Para acceder a la consola de Spanner Omni, ve a http://HOST_ADDRESS:15026 en tu navegador.

Reemplaza HOST_ADDRESS por el EXTERNAL_IP de spanner-omni-console que se encuentra en el resultado del siguiente comando:

kubectl get svc -n spanner-ns

Funciones de la consola de Spanner Omni

La consola de Spanner Omni incluye varias páginas que proporcionan estadísticas sobre tu implementación.

Descripción general

La página Overview es el panel central de tu implementación de Spanner Omni. Proporciona la siguiente información general sobre el estado, la situación y el uso de recursos de tus nodos de Spanner:

Información de implementación

En esta sección, se detallan los aspectos de tu implementación:

  • ID de implementación: Es un identificador único para tu implementación actual de Spanner Omni. Especificas este ID cuando creas la implementación.

  • Versión de la base de datos: Es la versión específica del software de Spanner Omni que ejecutas (por ejemplo, 2026.r4-lts).

  • Edition: Es la edición de la licencia de Spanner Omni instalada en la implementación.

  • Tipo de licencia: Es el tipo de licencia instalada en la implementación. Para obtener más información sobre las ediciones de Spanner Omni y los tipos de licencias, consulta la Descripción general de las ediciones de Spanner Omni.

  • Vencimiento de la licencia: Es la fecha en la que vence la licencia de la implementación.

Configuración de implementación

  • Uso de CPU: Es un gráfico en tiempo real que muestra la carga de procesamiento en toda tu implementación. Puedes alternar entre Zona y Servidor para ver la utilización.

  • Tabla de recursos: Proporciona una vista detallada de los componentes de tu implementación con la siguiente información. Los servidores se agrupan por zona.

    Columna Descripción
    Nombre del recurso Es el nombre de la zona o del nodo específico del servidor de Spanner Omni.
    Tipo
    • Zona: Muestra el tipo de zona (por ejemplo, de lectura y escritura, de solo lectura o de testigo).
    • Servidor de Spanner Omni: Son nodos individuales que ejecutan el servicio de Spanner Omni. La consola de Spanner Omni identifica los servidores raíz de forma específica.
    Estado Indica si el recurso está en buen estado (por ejemplo, Ready).
    Ubicación Es la región física o lógica que aloja la zona (por ejemplo, us-central1).
    CPU virtuales, memoria y almacenamiento utilizados Asignación y uso de recursos actuales para cada nodo y zona.

Bases de datos

La página Databases proporciona una vista centralizada de todas las bases de datos en tu implementación de Spanner Omni. La tabla de esta página incluye la siguiente información:

Columna Descripción
Nombre de la base de datos Es el identificador único de tu base de datos (por ejemplo, retail, ycsbdb).
Dialecto Dialecto de SQL que admite la base de datos:
  • GOOGLE_STANDARD_SQL: Es el dialecto predeterminado y ofrece compatibilidad completa con las funciones de Spanner.
  • POSTGRESQL: Es una interfaz compatible con PostgreSQL.
Uso de CPU Es el porcentaje de recursos de CPU que consume la base de datos. Esto te ayuda a identificar las bases de datos con carga alta.
Tablas Es la cantidad total de tablas definidas por el usuario en la base de datos.
Período de retención de la versión Es la duración durante la que Spanner Omni retiene los datos históricos para la recuperación de un momento determinado (por ejemplo, 1h).

Copias de seguridad

En la página Backups, se proporciona una vista integral de todas las copias de seguridad asociadas con tu implementación de Spanner Omni. Las copias de seguridad son instantáneas coherentes de forma externa y transaccional de tu base de datos que Spanner Omni almacena en soluciones de almacenamiento externas.

Para obtener más información, consulta Copias de seguridad de Spanner Omni.

Almacenamiento total de las copias de seguridad

En la sección Almacenamiento total de copias de seguridad, se muestra el tamaño acumulado de todas las copias de seguridad que almacenas en tu almacenamiento externo (por ejemplo, Amazon Simple Storage Service [Amazon S3], Cloud Storage o almacenamiento local compatible con Amazon S3).

Tabla de copias de seguridad

En la tabla de copias de seguridad, se muestra la siguiente información sobre cada copia:

Columna Descripción
Nombre de la copia de seguridad Es el identificador único de la copia de seguridad.
Base de datos de origen Nombre de la base de datos desde la que la consola de Spanner Omni creó la copia de seguridad.
Estado Es el estado actual de la copia de seguridad. Entre los estados comunes, se incluyen los siguientes:
  • Listo: Se completó la copia de seguridad y está disponible para restablecerse.
  • Creando: La copia de seguridad está en curso.
  • Vence pronto: La copia de seguridad está cerca de la fecha de vencimiento especificada por el usuario.
Tamaño de la copia de seguridad Es el tamaño de los datos de la copia de seguridad en el almacenamiento.
Hora de creación Es la marca de tiempo en la que el servidor de Spanner Omni inició el proceso de copia de seguridad.
Fecha y hora de la instantánea (o de la versión) Es el punto en el tiempo que representa la copia de seguridad. Todos los datos de la copia de seguridad son una instantánea coherente de la base de datos en ese momento.
Hora de vencimiento Fecha y hora en que Spanner Omni borra la copia de seguridad.

Estadísticas del sistema

La página Estadísticas del sistema proporciona observabilidad detallada para tu implementación de Spanner Omni, lo que te permite supervisar el estado del sistema, analizar el rendimiento y depurar problemas.

Puedes personalizar los datos que se muestran en el panel con los siguientes filtros:

  • Zonas: Filtra las métricas para zonas de implementación específicas.

  • Servidores: Desglosa los nodos de servidores individuales.

  • Bases de datos: Consulta las métricas de una base de datos específica o de toda la implementación.

  • Período: Selecciona una ventana de visualización de 1 hora hasta 7 días.

Uso de CPU

En esta sección, se supervisa la carga de procesamiento en toda la implementación. Puedes agrupar esta métrica según los siguientes criterios:

  • Zona: Identifica los desequilibrios de carga entre las ubicaciones físicas.

  • Prioridad: Consulta cómo se dividen los recursos entre las tareas de prioridad alta, media y baja.

  • Tipo de operación: Desglosa el uso por tareas iniciadas por el usuario, como lecturas, escrituras y confirmaciones.

Latencia

En esta sección, se hace un seguimiento de la velocidad de tus operaciones:

  • Latencia de solicitud: Es el tiempo que tardan las solicitudes individuales a la API.

  • Latencia de transacción: Es el tiempo total para completar las transacciones de la base de datos.

  • Percentiles: Por ejemplo, consulta el percentil 50 (P50) para ver el rendimiento medio. Sin embargo, la solución de problemas a menudo requiere verificar P90 o P99.

Capacidad de procesamiento y operaciones

En esta sección, se muestra la siguiente información:

  • Capacidad de procesamiento: Es el volumen de datos que el sistema lee de la implementación o escribe en ella (medido en bytes por segundo).

  • Operaciones por segundo: Es el recuento total de llamadas a la API que procesa el sistema.

Tiempo de espera de bloqueo

Esta métrica mide el tiempo acumulado que las transacciones pasan esperando bloqueos. Los picos en esta métrica, en especial cuando se combinan con una latencia alta y un uso normal de la CPU, suelen indicar una contención de bloqueo.

Métricas de almacenamiento

  • Capacidad de almacenamiento: Es el espacio de almacenamiento total y disponible en el sistema de archivos subyacente, que la consola de Spanner Omni agrupa por zona.

  • Utilización del almacenamiento: Es la cantidad de bytes que usan tus bases de datos. El proceso de compactación de datos de Spanner Omni puede causar fluctuaciones temporales en estos números.

Rendimiento del sistema de archivos

En esta sección, se proporcionan estadísticas sobre el rendimiento de la capa de almacenamiento subyacente (SpanhostFS):

  • Latencia del sistema de archivos: Es el tiempo que tardan las operaciones de E/S de bajo nivel (lectura, escritura y vaciado).

  • Capacidad de procesamiento del sistema de archivos: Es la velocidad de transferencia de datos a nivel del sistema de archivos.

Estadísticas de consultas

La página Estadísticas de consultas te ayuda a detectar y diagnosticar problemas de rendimiento de tus consultas de SQL y tus instrucciones de DML (INSERT, UPDATE y DELETE). Usa Estadísticas de consultas para identificar las consultas ineficientes que podrían contribuir a un uso alto de la CPU.

  • Detección: Determina si tus búsquedas son la causa principal de la carga de CPU de tu implementación.

  • Identificación: Identifica las etiquetas de solicitudes de aplicaciones o consultas específicas que consumen más recursos.

  • Análisis: Usa métricas detalladas, como la latencia y el recuento de filas, para comprender por qué una consulta puede ser lenta.

Carga de la base de datos por tiempo de ejecución (todas las consultas)

En Carga de la base de datos por tiempo de ejecución, se muestra el uso de CPU agregado para todas las consultas a lo largo del tiempo. Para mostrar la carga de una base de datos específica, usa un filtro de base de datos.

N búsquedas y etiquetas principales

En esta sección, se proporciona una vista de serie temporal de las consultas o las etiquetas que generan la mayor carga de base de datos dentro del período seleccionado.

Tabla de búsquedas y etiquetas principales

En la tabla, se enumeran las consultas y las etiquetas que más recursos consumen. Puedes usar esta información para identificar las consultas que consumen más recursos en tu carga de trabajo de consultas.

Columna Descripción
Huella digital Es un identificador único para una "forma" de búsqueda específica.
Etiqueta de consulta o solicitud Es el texto SQL normalizado de la consulta. Si tu aplicación proporciona una etiqueta de solicitud en las opciones de la consulta, la consola de Spanner Omni mostrará esa etiqueta en su lugar, lo que te permitirá agrupar consultas relacionadas (por ejemplo, checkout_process).
Tipo de consulta Es el tipo de operación (por ejemplo, QUERY).
CPU (%) Es el porcentaje de los recursos totales de CPU de la base de datos que consume esta consulta durante el intervalo.
Cantidad de ejecuciones Es la cantidad total de veces que la consola de Spanner Omni ejecutó la consulta.
Latencia promedio (ms) Es el tiempo promedio que se tarda en completar la búsqueda, incluido el tiempo de red entre los servidores.
Promedio de filas analizadas Es la cantidad promedio de filas que Spanner Omni lee para procesar la consulta. Los ratios altos de elementos analizados a devueltos suelen indicar que faltan índices o que son ineficientes.
Promedio de filas mostradas Es la cantidad promedio de filas que la consola de Spanner Omni envía a tu aplicación.
Bytes mostrados Es la cantidad promedio de datos que devuelve la consola de Spanner Omni por ejecución.