Démarrage rapide : ajouter un groupe de disponibilité
Dans ce démarrage rapide, vous ajoutez à Excubius un groupe de disponibilité à deux réplicas de Combray SA et vous l'affichez sur le tableau de bord Overview. Comptez environ 15 minutes une fois la connexion de supervision créée.
Avant de commencer
- La connexion de supervision existe sur chaque réplica avec le même SID. Consultez Prérequis.
- Vous avez le rôle Entity admin (administrateur d'entité) sur l'entité qui contiendra le groupe, par exemple Combray SA › Production.
- Le serveur Excubius accède à l'écouteur et aux deux réplicas sur le port SQL.
Dans les exemples, les réplicas sont sql-ventas-01.ciguapa.example et sql-ventas-02.ciguapa.example, et le groupe est ag-ventas.
1. Stocker la connexion une seule fois
Des informations d'identification stockées sur Combray SA sont utilisables par toutes les ressources situées en dessous.
- Console
- API
- Ouvrez Settings › Credentials et choisissez Combray SA dans le sélecteur d'entité.
- Sélectionnez Add credential, de type SQL login.
- Saisissez le nom
sql-monitoring, l'utilisateurusr_monitoringet le mot de passe. - Sélectionnez Save. Le mot de passe est chiffré et n'est plus jamais affiché.
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 vaut https://<your server>/api/v1 et H contient votre jeton du porteur ; consultez la référence de l'API.
2. Ajouter chaque réplica comme instance
- Console
- API
- Ouvrez Resources › Add resource.
- Type : SQL Server instance.
- Place and name : Combray SA › Production, nom
sql-ventas-01. - Connection : hôte
sql-ventas-01.ciguapa.example, port1433. - Tags :
env:prod,role:sql,client:ciguapa; criticité4. - Credential :
sql-monitoring. - Review, puis Create resource.
Répétez l'opération pour 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
Les vérifications par défaut d'une instance SQL Server sont configurées immédiatement ; les premières valeurs arrivent en une ou deux minutes.
3. Tester la connexion
Sur le premier réplica, sélectionnez Test connection. Un test réussi affiche le nom du serveur, la version, l'édition et la latence, et répertorie les autorisations manquantes.
| Résultat | Signification | Solution |
|---|---|---|
auth | Échec de la connexion, ou connexions SQL désactivées | Vérifiez le mot de passe et que l'instance accepte les connexions SQL (mode mixte) |
unreachable | Nom, pare-feu ou port | Vérifiez le DNS et le pare-feu depuis le serveur Excubius |
timeout | Pas de réponse à temps | Vérifiez le chemin réseau et le port SQL |
Avertissement : la connexion est sysadmin | Fonctionne, mais ne respecte pas le principe des privilèges minimaux | Recréez la connexion à partir des Prérequis |
4. Découvrir le groupe de disponibilité
Sur un seul réplica, sélectionnez Discover. La découverte lit le serveur, ses groupes de disponibilité avec leurs réplicas, leurs rôles et leur écouteur, ses bases de données et ses serveurs liés, et les ajoute comme ressources enfants avec leurs propres vérifications. Relancez-la chaque fois que la topologie change ; les enfants qui disparaissent sont marqués comme manquants, jamais supprimés.
5. Afficher le groupe sur le tableau de bord Overview
Ouvrez le tableau de bord Overview de Combray SA. La carte ag-ventas affiche l'écouteur, le principal, les deux réplicas avec l'intégrité de leur synchronisation et les bases de données. Les deux réplicas doivent indiquer Sain.
Nettoyer
Pour supprimer ce que vous avez ajouté, supprimez les deux instances depuis Resources ; leurs enfants découverts, leurs vérifications, leurs métriques et leurs alertes sont supprimés avec elles. Supprimez les informations d'identification en dernier, une fois que plus rien ne les utilise.