Supervisa instancias con Cloud Monitoring

En este documento, se describe cómo usar la consola de Cloud Monitoring para supervisar tus instancias de Spanner.

La consola de Cloud Monitoring proporciona varias herramientas de supervisión para Spanner:

• Un panel seleccionado, que muestra gráficos prediseñados para tus recursos de Spanner
• Gráficos personalizados, incluidos gráficos ad hoc en el Explorador de métricas, así como gráficos en paneles personalizados.
• Alertas, que te notifican si una métrica excede un límite que tú especificas.

Si prefieres supervisar Spanner de manera programática, usa las bibliotecas cliente de Cloud para Cloud Monitoring a fin de recuperar las métricas.

Nota: También puedes supervisar tus instancias si ves los gráficos en la consola de Google Cloud. Usa la consola de Google Cloud para obtener una vista rápida de las métricas más importantes de tu instancia.

Usa el panel seleccionado de Cloud Monitoring

Cloud Monitoring te proporciona un panel seleccionado que resume información clave sobre tus instancias de Spanner, incluido lo siguiente:

• Incidentes: alertas de supervisión creadas por el usuario que están abiertas, activas o resueltas
• Eventos: Una lista de registros de auditoría de Spanner (si están habilitados y disponibles)
• Instancias: Resumen de alto nivel de las instancias de Spanner, incluida la capacidad de procesamiento, el recuento de bases de datos y el estado de la instancia
• Gráficos agregados de capacidad de procesamiento y uso de almacenamiento

Para ver el panel de Spanner, haz lo siguiente:

1. En la consola de Google Cloud, selecciona Monitoring o usa el siguiente botón:

   Ir a Monitoring

2. Si se muestra Recursos en el panel de navegación, selecciona Recursos y, luego, Cloud Spanner. De lo contrario, selecciona Paneles y, a continuación, el panel llamado Cloud Spanner.

Ve los detalles de la instancia y la base de datos

Cuando abras el panel seleccionado para Spanner, se mostrarán los datos agregados de todas tus instancias. Para ver más detalles sobre una instancia específica, haz clic en el nombre de la instancia en Instancias.

El panel muestra información como metadatos de instancias, bases de datos en la instancia y gráficos de diversas métricas desglosados por región.

En la página del panel de la instancia, también puedes ver los gráficos de una base de datos específica en la instancia:

1. En la parte derecha, sobre los gráficos de métricas de la instancia, haz clic en Métricas de la base de datos.

2. En la lista desplegable Seleccionar un desglose, selecciona la base de datos que deseas examinar.

   En la consola de Cloud Monitoring, se muestran gráficos para la base de datos.

Crea gráficos personalizados para las métricas de Spanner

Puedes usar Cloud Monitoring a fin de crear gráficos personalizados para las métricas de Spanner. Puedes usar el Explorador de métricas para crear gráficos temporales y ad hoc, o bien crear gráficos que aparecen en paneles personalizados.

En particular, Cloud Monitoring te permite crear un gráfico personalizado que muestra si dos o más métricas están correlacionadas entre sí. Por ejemplo, puedes verificar una correlación entre el uso de CPU y la latencia en una instancia de Spanner, lo que podría indicar que tu instancia necesita más capacidad de procesamiento o que algunas de tus consultas generan un uso elevado de CPU.

Para comenzar con este ejemplo, sigue estos pasos:

1. En la consola de Google Cloud, selecciona Monitoring o usa el siguiente botón:

   Ir a Monitoring

2. Si el Explorador de métricas aparece en el panel de navegación, selecciónalo. De lo contrario, selecciona Recursos y, luego, Explorador de métricas.

3. Haz clic en la pestaña Ver opciones y, luego, selecciona la casilla de verificación Escala de registro en el eje Y. Esta opción te permite comparar varias métricas cuando una métrica tiene valores mucho más altos que las otras.

4. En la lista desplegable que se encuentra arriba del panel derecho, selecciona Línea.

5. Haz clic en la pestaña Métricas. Ahora puedes agregar métricas al gráfico.

Para agregar métricas de latencia al gráfico, sigue estos pasos:

1. En el cuadro Buscar tipo de recurso y métrica, ingresa el valor spanner.googleapis.com/api/request_latencies y, luego, haz clic en la fila que aparece debajo del cuadro.
2. En el cuadro Filtro, ingresa el valor instance_id, luego ingresa el ID de la instancia que deseas examinar y haz clic en Aplicar.
3. En la lista desplegable Agregador, haz clic en máx.

4. Opcional: cambia el percentil de latencia:

   1. Haz clic en Mostrar opciones avanzadas.

   2. Haz clic en la lista desplegable Alineador y, luego, en el percentil de latencia que deseas ver.

      En la mayoría de los casos, debes observar la latencia del percentil 50 para comprender la latencia típica o la latencia del percentil 99 a fin de comprender la latencia del 1% más lento de las solicitudes.

Para agregar métricas del uso de CPU al gráfico, sigue estos pasos:

1. Haz clic en Agregar métrica.
2. En el cuadro Buscar tipo de recurso y métrica, ingresa el valor spanner.googleapis.com/instance/cpu/utilization y, luego, haz clic en la fila que aparece debajo del cuadro.
3. En el cuadro Filtro, ingresa el valor instance_id, luego ingresa el ID de la instancia que deseas examinar y haz clic en Aplicar.
4. En la lista desplegable Agregador, haz clic en máx.

Ahora tienes un gráfico en el que se muestran las métricas de uso de CPU y latencia de una instancia de Spanner. Si ambas métricas son más altas de lo esperado al mismo tiempo, puedes realizar pasos adicionales para corregir el problema.

Para obtener más información sobre cómo crear gráficos personalizados, consulta la documentación de Cloud Monitoring.

Crea alertas para las métricas de Spanner

Cuando creas una instancia de Spanner, debes elegir la capacidad de procesamiento de la instancia. A medida que cambia la carga de trabajo de la instancia, Spanner no ajusta su capacidad de procesamiento de forma automática. Como resultado, debes configurar varias alertas para asegurarte de que la instancia se mantenga dentro de los valores máximos recomendados para el uso de CPU y el límite de almacenamiento recomendado.

En los siguientes ejemplos, se muestra cómo configurar políticas de alertas para algunas métricas de Spanner. Para obtener una lista completa de las métricas disponibles, consulta la lista de métricas de Spanner.

CPU de alta prioridad

Si quieres crear una política de alertas que se active cuando el uso de la CPU de alta prioridad para Spanner supere el umbral recomendado, usa la siguiente configuración.

Pasos para crear una política de alertas.

Para crear una política de alertas, sigue estos pasos:

1. En el panel de navegación de la consola de Google Cloud, elige Monitoring y, luego,  Alertas:

   Ir a las Alertas

2. Si aún no creas canales de notificaciones y deseas recibir notificaciones, haz clic en Edit Notification Channels y agrega tus canales de notificaciones. Regresa a la página Alertas después de agregar tus canales.
3. En la página Alertas, selecciona Crear política.
4. Para seleccionar el recurso, la métrica y los filtros, expande el menú Seleccionar una métrica y, luego, usa los valores de la tabla Condición nueva:
   1. Opcional: Para limitar el menú a entradas relevantes, ingresa el nombre del recurso o la métrica en la barra de filtros.
   2. Selecciona un tipo de recurso. Por ejemplo, selecciona Instancia de VM.
   3. Selecciona una Categoría de métrica. Por ejemplo, selecciona instancia.
   4. Seleccionar una métrica. Por ejemplo, selecciona Uso de CPU.
   5. Selecciona Apply (Apply).
5. Haz clic en Siguiente y, luego, configura el activador de la política de alertas. Para completar estos campos, usa los valores de la tabla Configurar activador de alertas.
6. Haz clic en Siguiente.

7. Para agregar notificaciones a tu política de alertas, haz clic en Canales de notificaciones (opcional). En el diálogo, selecciona uno o más canales de notificaciones del menú y, luego, haz clic en Aceptar.

   Si deseas recibir notificaciones cuando se abran y se cierren incidentes, marca Notificar el cierre de incidentes. De forma predeterminada, se envían notificaciones solo cuando los incidentes se abren.

8. Opcional: Actualiza la Duración del cierre automático de incidentes. Este campo determina cuándo Monitoring cierra los incidentes ante la ausencia de datos de métricas.
9. Opcional: Haz clic en Documentación y, luego, agrega la información que deseas incluir en un mensaje de notificación.
10. Haz clic en Nombre de la alerta y, luego, ingresa un nombre para la política de alertas.
11. Haga clic en Crear política.

Nueva condición Campo	Valor
Recurso y métrica	En el menú Recursos, selecciona Instancia de Cloud Spanner. En el menú Categorías de métricas, selecciona Instancia. En el menú Métricas, selecciona Uso de CPU por prioridad. (El metric.type es spanner.googleapis.com/instance/cpu/utilization_by_priority).
Filtro	instance_id = YOUR_INSTANCE_ID priority = high
Series temporales Grupo de series temporales por	location para instancias multirregionales; déjalo en blanco para instancias regionales.
Series temporales Agregación de series temporales	sum
Ventana progresiva	10 m
Función analítica progresiva	mean

Configura el activador de alertas Campo	Valor
Tipo de condición	Threshold
Activador de alertas	Any time series violates
Posición del umbral	Above threshold
Valor del umbral	45% para instancias multirregionales; 65% para instancias regionales.
Período para volver a probar	10 minutes

CPU promedio móvil de 24 horas

Para crear una política de alertas que se active cuando el promedio móvil de 24 horas del uso de tu CPU para Spanner supere el umbral recomendado, usa la siguiente configuración.

Pasos para crear una política de alertas.

Para crear una política de alertas, sigue estos pasos:

1. En el panel de navegación de la consola de Google Cloud, elige Monitoring y, luego,  Alertas:

   Ir a las Alertas

2. Si aún no creas canales de notificaciones y deseas recibir notificaciones, haz clic en Edit Notification Channels y agrega tus canales de notificaciones. Regresa a la página Alertas después de agregar tus canales.
3. En la página Alertas, selecciona Crear política.
4. Para seleccionar el recurso, la métrica y los filtros, expande el menú Seleccionar una métrica y, luego, usa los valores de la tabla Condición nueva:
   1. Opcional: Para limitar el menú a entradas relevantes, ingresa el nombre del recurso o la métrica en la barra de filtros.
   2. Selecciona un tipo de recurso. Por ejemplo, selecciona Instancia de VM.
   3. Selecciona una Categoría de métrica. Por ejemplo, selecciona instancia.
   4. Seleccionar una métrica. Por ejemplo, selecciona Uso de CPU.
   5. Selecciona Apply (Apply).
5. Haz clic en Siguiente y, luego, configura el activador de la política de alertas. Para completar estos campos, usa los valores de la tabla Configurar activador de alertas.
6. Haz clic en Siguiente.

7. Para agregar notificaciones a tu política de alertas, haz clic en Canales de notificaciones (opcional). En el diálogo, selecciona uno o más canales de notificaciones del menú y, luego, haz clic en Aceptar.

   Si deseas recibir notificaciones cuando se abran y se cierren incidentes, marca Notificar el cierre de incidentes. De forma predeterminada, se envían notificaciones solo cuando los incidentes se abren.

8. Opcional: Actualiza la Duración del cierre automático de incidentes. Este campo determina cuándo Monitoring cierra los incidentes ante la ausencia de datos de métricas.
9. Opcional: Haz clic en Documentación y, luego, agrega la información que deseas incluir en un mensaje de notificación.
10. Haz clic en Nombre de la alerta y, luego, ingresa un nombre para la política de alertas.
11. Haga clic en Crear política.

Nueva condición Campo	Valor
Recurso y métrica	En el menú Recursos, selecciona Instancia de Cloud Spanner. En el menú Categorías de métricas, selecciona Instancia. En el menú Métricas, selecciona Uso de CPU suavizado. (El metric.type es spanner.googleapis.com/instance/cpu/smoothed_utilization).
Filtro	instance_id = YOUR_INSTANCE_ID
Series temporales Agregación de series temporales	sum
Ventana progresiva	10 m
Función analítica progresiva	mean

Configura el activador de alertas Campo	Valor
Tipo de condición	Threshold
Activador de alertas	Any time series violates
Posición del umbral	Above threshold
Umbral	90%
Período para volver a probar	10 minutes

Almacenamiento

Para crear una política de alertas que se active cuando el almacenamiento de la instancia de Spanner supere el límite recomendado, usa la siguiente configuración.

Pasos para crear una política de alertas.

Para crear una política de alertas, sigue estos pasos:

1. En el panel de navegación de la consola de Google Cloud, elige Monitoring y, luego,  Alertas:

   Ir a las Alertas

2. Si aún no creas canales de notificaciones y deseas recibir notificaciones, haz clic en Edit Notification Channels y agrega tus canales de notificaciones. Regresa a la página Alertas después de agregar tus canales.
3. En la página Alertas, selecciona Crear política.
4. Para seleccionar el recurso, la métrica y los filtros, expande el menú Seleccionar una métrica y, luego, usa los valores de la tabla Condición nueva:
   1. Opcional: Para limitar el menú a entradas relevantes, ingresa el nombre del recurso o la métrica en la barra de filtros.
   2. Selecciona un tipo de recurso. Por ejemplo, selecciona Instancia de VM.
   3. Selecciona una Categoría de métrica. Por ejemplo, selecciona instancia.
   4. Seleccionar una métrica. Por ejemplo, selecciona Uso de CPU.
   5. Selecciona Apply (Apply).
5. Haz clic en Siguiente y, luego, configura el activador de la política de alertas. Para completar estos campos, usa los valores de la tabla Configurar activador de alertas.
6. Haz clic en Siguiente.

7. Para agregar notificaciones a tu política de alertas, haz clic en Canales de notificaciones (opcional). En el diálogo, selecciona uno o más canales de notificaciones del menú y, luego, haz clic en Aceptar.

   Si deseas recibir notificaciones cuando se abran y se cierren incidentes, marca Notificar el cierre de incidentes. De forma predeterminada, se envían notificaciones solo cuando los incidentes se abren.

8. Opcional: Actualiza la Duración del cierre automático de incidentes. Este campo determina cuándo Monitoring cierra los incidentes ante la ausencia de datos de métricas.
9. Opcional: Haz clic en Documentación y, luego, agrega la información que deseas incluir en un mensaje de notificación.
10. Haz clic en Nombre de la alerta y, luego, ingresa un nombre para la política de alertas.
11. Haga clic en Crear política.

Nueva condición Campo	Valor
Recurso y métrica	En el menú Recursos, selecciona Instancia de Cloud Spanner. En el menú Categorías de métricas, selecciona Instancia. En el menú Métricas, selecciona Almacenamiento utilizado. (El metric.type es spanner.googleapis.com/instance/storage/utilization).
Filtro	instance_id = YOUR_INSTANCE_ID
Series temporales Agregación de series temporales	sum
Ventana progresiva	10 m
Función analítica progresiva	max

Configura el activador de alertas Campo	Valor
Tipo de condición	Threshold
Activadores de condición si:	Any time series violates
Posición del umbral	Above threshold
Valor del umbral	Establece el límite en un 75% del almacenamiento máximo por nodo, multiplicado por la cantidad de nodos. Para conocer los límites actuales de los nodos, consulta Cuotas y límites de Spanner.
Período para volver a probar	10 minutes

Nota: Los importes de uso de Spanner se calculan en terabytes binarios, en los que 1 TB equivale a 2⁴⁰ bytes. Esta unidad de medición también se conoce como tebibyte (TiB).

¿Qué sigue?

• Comprende las métricas de uso de CPU y latencia para Spanner.
• Usa la consola de Google Cloud para obtener una vista rápida de las métricas más importantes de tu instancia.
• Obtén más información sobre Cloud Monitoring.