Краткое руководство. Добавление группы доступности
В этом кратком руководстве вы добавите в Excubius группу доступности с двумя репликами ООО «Лукоморье» и увидите ее на панели мониторинга Overview. Если имя входа для мониторинга уже создано, это займет около 15 минут.
Перед началом работы
- Имя входа для мониторинга существует на каждой реплике с одинаковым SID. См. раздел Предварительные требования.
- У вас есть роль Entity admin (администратор сущности) в сущности, где будет находиться группа, например ООО «Лукоморье» › Production.
- Сервер Excubius обращается к прослушивателю и обеим репликам по порту SQL.
В примерах реплики называются sql-ventas-01.ciguapa.example и sql-ventas-02.ciguapa.example, а группа — ag-ventas.
1. Сохраните имя входа один раз
Учетными данными, сохраненными в ООО «Лукоморье», может пользоваться любой ресурс ниже этой сущности.
- Консоль
- API
- Откройте Settings › Credentials и выберите ООО «Лукоморье» в средстве выбора сущности.
- Нажмите Add credential и выберите тип SQL login.
- Введите имя
sql-monitoring, пользователяusr_monitoringи пароль. - Нажмите Save. Пароль шифруется и больше никогда не отображается.
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 — это https://<your server>/api/v1, а H содержит ваш токен носителя; см. справочник по API.
2. Добавьте каждую реплику как экземпляр
- Консоль
- API
- Откройте Resources › Add resource.
- Type: SQL Server instance.
- Place and name: ООО «Лукоморье» › Production, имя
sql-ventas-01. - Connection: узел
sql-ventas-01.ciguapa.example, порт1433. - Tags:
env:prod,role:sql,client:ciguapa; критичность4. - Credential:
sql-monitoring. - Review, затем Create resource.
Повторите эти действия для 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
Проверки экземпляра SQL Server по умолчанию настраиваются сразу; первые значения поступают в течение одной-двух минут.
3. Проверьте подключение
На первой реплике нажмите Test connection. Успешная проверка показывает имя сервера, версию, выпуск и задержку, а также все недостающие разрешения.
| Результат | Значение | Исправление |
|---|---|---|
auth | Вход не выполнен, или имена входа SQL отключены | Проверьте пароль и убедитесь, что экземпляр принимает имена входа SQL (смешанный режим) |
unreachable | Имя, брандмауэр или порт | Проверьте DNS и брандмауэр с сервера Excubius |
timeout | Нет ответа за отведенное время | Проверьте сетевой путь и порт SQL |
Предупреждение: имя входа входит в sysadmin | Работает, но не соответствует принципу минимальных прав | Пересоздайте имя входа по инструкциям из раздела Предварительные требования |
4. Обнаружьте группу доступности
Только на одной реплике нажмите Discover. Обнаружение читает сервер, его группы доступности с их репликами, ролями и прослушивателем, его базы данных и связанные серверы и добавляет их как дочерние ресурсы с собственными проверками. Запускайте обнаружение повторно при каждом изменении топологии; исчезнувшие дочерние ресурсы помечаются как отсутствующие, но никогда не удаляются.
5. Посмотрите группу на панели Overview
Откройте панель Overview для ООО «Лукоморье». Карточка ag-ventas показывает прослушиватель, первичную реплику, обе реплики с работоспособностью их синхронизации и базы данных. Обе реплики должны быть в состоянии Работоспособно.
Очистка
Чтобы удалить добавленное, удалите оба экземпляра в разделе Resources; вместе с ними удаляются обнаруженные дочерние ресурсы, проверки, метрики и оповещения. Учетные данные удалите в последнюю очередь, когда они больше нигде не используются.