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 en 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 autoridad certificadora (AC).
   • 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, en tu navegador, ve a http://HOST_ADDRESS:15026.

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 Descripción general es el panel central de tu implementación de Spanner Omni. Proporciona la siguiente información general sobre el estado y el uso de recursos de tus nodos de Spanner:

Información de implementación

En esta sección, se enumeran los detalles de tu implementación:

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

• Versión de la base de datos: Es la versión específica del software de Spanner Omni que estás ejecutando (por ejemplo, 2026.r5).

• Edición: 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 y los tipos de licencias de Spanner Omni, consulta 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 la Deployment

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

• 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 de servidor de Spanner Omni específico.
  Tipo	Zona: Muestra el tipo de zona (por ejemplo, de lectura y escritura, de solo lectura o testigo). Servidor de Spanner Omni: Son nodos individuales que ejecutan el servicio de Spanner Omni. La consola de Spanner Omni identifica específicamente los servidores raíz.
  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 usados	La asignación y el uso actuales de recursos para cada nodo y zona.

Bases de datos

La página Bases de datos proporciona una vista centralizada de todas las bases de datos de 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	El dialecto de SQL que admite la base de datos: GOOGLE_STANDARD_SQL: Es el dialecto predeterminado, que ofrece compatibilidad total 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 conserva los datos históricos para la recuperación de un momento determinado (por ejemplo, 1h).

Copias de seguridad

La página Copias de seguridad proporciona una vista completa de todas las copias de seguridad asociadas con tu implementación de Spanner Omni. Las copias de seguridad son instantáneas transaccionales y con coherencia externa 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 para cada copia de seguridad:

Columna	Descripción
Nombre de la copia de seguridad	Es el identificador único de la copia de seguridad.
Base de datos de origen	Es el nombre de la base de datos a partir de la cual 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: La copia de seguridad se completó y está disponible para restablecerla. 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 de cuando el servidor de Spanner Omni inició el proceso de copia de seguridad.
Hora de la instantánea (o de la versión)	Es el momento 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 este momento.
Hora de vencimiento	La 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 de 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 entre 1 hora y 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 por 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 solicitudes a la API: Es el tiempo que tardan las solicitudes individuales a la API.

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

• Percentiles: Por ejemplo, consulta esto en el percentil 50 (P50) para obtener el rendimiento mediano. Sin embargo, para solucionar problemas, a menudo se debe 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 o escribe en la implementación (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 aumentos repentinos 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.

• Uso 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 tasa 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 en tus consultas en SQL y sentencias 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 CPU.

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

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

• Análisis: Usa métricas detalladas, como la latencia y los recuentos 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 etiquetas que generan la mayor carga de la base de datos dentro del período seleccionado.

Tabla de consultas y etiquetas principales

En la tabla, se enumeran las consultas y etiquetas que más 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 consulta específica.
Etiqueta de consulta o solicitud	Es el texto de SQL normalizado de la consulta. Si tu aplicación proporciona una etiqueta de solicitud en las opciones de consulta, la consola de Spanner Omni muestra esa etiqueta, lo que te permite agrupar las consultas relacionadas (por ejemplo, checkout_process).
Tipo de consulta	Es el tipo de operación (por ejemplo, QUERY).
CPU (%)	Es el porcentaje del total de recursos 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 consulta, incluido el tiempo de red entre servidores.
Promedio de filas analizadas	Es la cantidad promedio de filas que Spanner Omni lee para procesar la consulta. Las proporciones altas de documentos analizados en comparación con los devueltos suelen indicar que faltan índices o que estos son ineficientes.
Promedio de filas mostradas	Es la cantidad promedio de filas que la consola de Spanner Omni devuelve a tu aplicación.
Bytes mostrados	Es la cantidad promedio de datos que devuelve la consola de Spanner Omni por ejecución.