Objetivos

Recibir alertas puntuales sobre la utilización de recursos es clave para gestionar su base de datos, evitar problemas y mitigar el tiempo de inactividad. Si sabes de antemano que tu base de datos se está quedando sin disco, toma medidas para escalar esos recursos.

En este tutorial, se utiliza la API IBM Cloud API y la IBM Cloud CLI para configurar una alerta que le envíe un correo electrónico cada vez que la utilización del disco de su base de datos supere el 90%. Este ejemplo específico crea una alerta en un Databases for Elasticsearch despliegue, pero es aplicable a todas las bases de datos del IBM Cloud Databases catálogo.

Conseguir productividad

ibmcloud plugin install monitoring

ibmcloud plugin install cloud-databases

Recuperar su instancia de servicio de monitorización

En este paso, obtendrá las credenciales necesarias para acceder a su instancia de monitorización.

Comience por iniciar sesión en el IBM Cloud CLI con el siguiente comando:

ibmcloud login -sso

Siga las instrucciones en pantalla para iniciar sesión.

A continuación, seleccione la región adecuada para su instancia:

ibmcloud target -r <REGION>

A continuación, liste las instancias de monitorización existentes en esa región con el siguiente comando:

ibmcloud monitoring service-instances

Observe el nombre de la instancia de servicio que tiene "Platform Metrics" activado.

Ahora crear un token de autorización para la API, mediante el uso de un comando como:

Los siguientes pasos sólo funcionan en Bash.

AUTH_TOKEN=$(ibmcloud iam oauth-tokens | awk '{print $4}')

Ahora puede recuperar el ID de su instancia de servicio de monitorización para la API con el siguiente comando:

GUID=$(ibmcloud resource service-instance <instance_name_from_step_above> --output json | jq -r '.[].guid')

Configurar el canal de notificaciones

Configure un canal de notificación para que se le notifique cuando se active una alerta. Para configurar su canal de notificación, utilice el siguiente comando:

curl -X POST https://<region>.monitoring.cloud.ibm.com/api/notificationChannels -H "Authorization: Bearer $AUTH_TOKEN" -H "IBMInstanceID: $GUID" -H "content-type: application/json"  --data-raw '{"notificationChannel":{"id":null,"version":null,"teamId":"","name":"<notification_channel>","type":"EMAIL","enabled":true,"sendTestNotification":true,"options":{"notifyOnOk":true,"notifyOnResolve":true,"emailRecipients":["email@email.com"]}}}'

Verá la siguiente salida:

{"notificationChannel":{"id":39209,"version":1,"customerId":34292,"enabled":true,"sendTestNotification":true,"createdOn":1678967870764,"modifiedOn":1678967870764,"name":"thursTest","options":{"notifyOnOk":true,"emailRecipients":["email@email.com"],"notifyOnResolve":true},"type":"EMAIL"}}% 

Ahora ha creado un canal de notificación para sus alertas.

Anote el id campo que devuelve la llamada a la API.

Crear la alerta

Ahora que tiene un canal de notificación, cree su regla de alerta. La regla de alerta describe la consulta métrica que se va a supervisar, el valor umbral y la acción que se debe realizar cuando se supera el umbral. En este caso, estás monitorizando tu ibm_service_instance_name para asegurarte de que la max utilización no supera el 90%. Si eso ocurre, se activa una alerta y se te notifica.

Esta alerta se activa al 90% de utilización del disco. Sin embargo, es preferible una utilización del disco del 50-70%.

Para recuperar el nombre de la instancia de base de datos para la que desea configurar la alerta, liste todas sus instancias de base de datos con un comando como

ibmcloud cdb ls

Asegúrese de seleccionar una base de datos en la misma región que la instancia de monitorización.

Verá un resultado similar al siguiente:

Retrieving instances for all database types in all resource groups in all locations under IBM as …
OK
Name                          Location   State
Databases for PostgreSQL-76   us-south   inactive
testelastic                   eu-gb      active
Databases for MySQL-9j        us-south   active

Ahora, utilice el nombre de su base de datos para crear la alerta mediante un comando como:

curl --request POST \
  --url https://<region>.monitoring.cloud.ibm.com/api/alerts \
  --header "Authorization: Bearer  $AUTH_TOKEN" \
  --header 'Content-Type: application/json' \
  --header "IBMInstanceID: $GUID" \
  --data-raw  '{
	"alert":
		{
			"type": "MANUAL",
			"name": "Disk Alert",
			"description": "",
			"enabled": true,
			"severity": 1,
			"timespan": 60000000,
			"notificationChannelIds": [
				<id_from_previous_step>
			],
			"filter": "ibm_service_instance_name in (\"<db_instance_name_from_previous_step>\")",
		  "condition": "max(max(ibm_databases_for_elasticsearch_disk_used_percent)) > 0.9"
		}
}'

Este comando toma la utilización máxima de disco de cualquier miembro disponible, independientemente del número de miembros.

Compruebe que su alerta está creada

Se crea una alerta cada vez que se alcanza el 90% del tamaño del disco. Recibirás la alerta en el mismo correo electrónico que creaste en el canal de notificación. También puede utilizar el siguiente comando para comprobar las alertas activas actuales:

ibmcloud monitoring alert list --name <monitoring instance name>

Ahora recibirá una alerta cada vez que la utilización del disco de su instancia Databases for Elasticsearch supere el 90%, para que pueda actuar antes de que el disco esté demasiado lleno.

Próximos pasos

Para modificar su alerta u obtener más información sobre la supervisión, consulte Introducción a{{site{{site.data.keyword.mon_full_notm}}.

Cloud Databases métricas de servicio

Este tutorial utiliza IBM Cloud® Databases for Elasticsearch. Sin embargo, el mismo proceso se aplica a otros servicios Cloud Databases:

• Databases for MongoDB
• Databases for PostgreSQL
• Databases for Redis
• Databases for MySQL
• Messages for RabbitMQ