Inicio rápido: agregar un grupo de disponibilidad
En este inicio rápido agregas a Excubius un grupo de disponibilidad de dos réplicas de Ciguapa Inc. y lo ves en la Vista general. Tarda unos 15 minutos una vez que existe el inicio de sesión de monitoreo.
Antes de empezar
- El inicio de sesión de monitoreo existe en todas las réplicas con el mismo SID. Consulta Requisitos previos.
- Eres Administrador de entidad en la entidad que contendrá el grupo, por ejemplo Ciguapa Inc. › Producción.
- El servidor de Excubius llega al listener y a ambas réplicas por el puerto SQL.
En los ejemplos, las réplicas son sql-ventas-01.ciguapa.example y sql-ventas-02.ciguapa.example, y el grupo es ag-ventas.
1. Guarda el inicio de sesión una sola vez
Una credencial guardada en Ciguapa Inc. la pueden usar todos los recursos que están debajo.
- Consola
- API
- Abre Configuración › Credenciales y elige Ciguapa Inc. en el selector de entidades.
- Selecciona Agregar credencial, tipo Inicio de sesión de SQL.
- Escribe el nombre
sql-monitoring, el usuariousr_monitoringy la contraseña. - Selecciona Guardar. La contraseña se cifra y no se vuelve a mostrar.
CRED=$(curl -s "${H[@]}" -X POST "$BASE/credentials" -d "{
\"entity_id\": \"$CIGUAPA\", \"name\": \"sql-monitoring\", \"kind\": \"sql_login\",
\"username\": \"usr_monitoring\", \"secret\": \"<password>\"
}" | jq -r .id)
$BASE es https://<your server>/api/v1 y H contiene tu token de portador; consulta la referencia de la API.
2. Agrega cada réplica como una instancia
- Consola
- API
- Abre Recursos › Agregar recurso.
- Tipo: SQL Server instance.
- Ubicación y nombre: Ciguapa Inc. › Producción, nombre
sql-ventas-01. - Conexión: host
sql-ventas-01.ciguapa.example, puerto1433. - Etiquetas:
env:prod,role:sql,client:ciguapa; criticidad4. - Credencial:
sql-monitoring. - Revisión y, luego, Crear recurso.
Repite los pasos para sql-ventas-02.
for n in 01 02; do
curl -s "${H[@]}" -X POST "$BASE/resources" -d "{
\"entity_id\": \"$PROD\", \"type\": \"sqlserver_instance\", \"name\": \"sql-ventas-$n\",
\"attributes\": {\"host\": \"sql-ventas-$n.ciguapa.example\", \"port\": 1433},
\"tags\": {\"env\": \"prod\", \"role\": \"sql\", \"client\": \"ciguapa\"}, \"criticality\": 4,
\"credential_id\": \"$CRED\"
}" | jq '{id, name, checks_provisioned}'
done
Las comprobaciones predeterminadas de una instancia de SQL Server se configuran de inmediato; los primeros valores llegan en uno o dos minutos.
3. Prueba la conexión
En la primera réplica, selecciona Probar conexión. Una prueba correcta muestra el nombre del servidor, la versión, la edición y la latencia, y enumera los permisos que falten.
| Resultado | Significa | Solución |
|---|---|---|
auth | Error de inicio de sesión, o los inicios de sesión de SQL están deshabilitados | Revisa la contraseña y que la instancia acepte inicios de sesión de SQL (modo mixto) |
unreachable | Nombre, firewall o puerto | Revisa el DNS y el firewall desde el servidor de Excubius |
timeout | No hubo respuesta a tiempo | Revisa la ruta de red y el puerto SQL |
Advertencia: el inicio de sesión es sysadmin | Funciona, pero no aplica el privilegio mínimo | Vuelve a crear el inicio de sesión según Requisitos previos |
4. Descubre el grupo de disponibilidad
Solo en una réplica, selecciona Descubrir. El descubrimiento lee el servidor, sus grupos de disponibilidad con sus réplicas, roles y listener, sus bases de datos y sus servidores vinculados, y los agrega como recursos hijo con sus propias comprobaciones. Vuelve a ejecutarlo cada vez que cambie la topología; los recursos hijo que desaparecen se marcan como faltantes, nunca se eliminan.
5. Velo en la Vista general
Abre la Vista general de Ciguapa Inc.. La tarjeta de ag-ventas muestra el listener, la primaria, ambas réplicas con la salud de su sincronización y las bases de datos. Ambas réplicas deberían mostrar Saludable.
Limpieza
Para quitar lo que agregaste, elimina las dos instancias desde Recursos; sus recursos hijo descubiertos, sus comprobaciones, métricas y alertas se eliminan con ellas. Elimina la credencial al final, cuando ya nada la use.