Создание и синхронизация
Форма создания уже запускает проверку и синхронизацию. Отдельно нажимать эти действия при первом подключении не нужно — важнее проверить результат каждого источника данных.
Заполните форму
Откройте новый коннектор
В Oopps.ai перейдите в Коннекторы, нажмите Добавить коннектор и выберите Yandex Cloud. Создавать коннекторы может участник с ролью не ниже operator.
Укажите идентификаторы
Введите произвольное понятное название, обязательный Folder ID, при наличии — Cloud ID и Billing Account ID. Поля ожидают ID, а не имена ресурсов.
Выберите аутентификацию
Для SaaS production выберите Service Account Key (JSON). Остальные варианты и ограничения описаны на странице Аутентификация.
Нажмите «Создать коннектор»
Приложение сохраняет коннектор, проверяет доступ к Folder API, затем запускает синхронизацию. В основном сценарии страницы коннекторов оно также пытается запустить аудит обнаруженных кластеров.
Запись коннектора могла уже сохраниться до шага проверки. Вернитесь в список, откройте меню ⋮ → Изменить, исправьте реквизиты и используйте Проверить. Не создавайте дубликат, пока не убедились, что первой записи нет.
Что делает синхронизация
- получает inventory доступных ресурсов каталога;
- обнаруживает Managed Kubernetes кластеры и node groups;
- если указан Billing Account ID, запрашивает billing-отчёты;
- сохраняет результат и время последней синхронизации;
- при запуске из списка коннекторов пытается провести аудит обнаруженных кластеров.
Inventory может обновиться успешно, даже если billing недоступен. UI в таком случае показывает отдельное предупреждение. Аналогично, обнаружение кластера через cloud API не означает, что Kubernetes-аудит имеет достаточный RBAC.
Проверьте результат
| Где | Что проверить | Если данных нет |
|---|---|---|
| Коннекторы | Статус «активен», нет last_error, время sync обновилось | Откройте ⋮ → Проверить |
| Inventory | Есть VM, диски и сети именно нужного каталога | Проверьте Folder ID и роли на каталоге |
| Кластеры | Количество и имена Managed Kubernetes кластеров совпадают с консолью | Проверьте k8s.cluster-api.viewer |
| Аудиты | Аудит завершается, видит nodes и workloads | Отделите сетевую ошибку master endpoint от Kubernetes Forbidden |
| Биллинг | Период, валюта и итоговая сумма выглядят правдоподобно | Проверьте Billing Account ID, binding облака и роль на аккаунте |
Повторная синхронизация
В списке коннекторов откройте меню ⋮ → Синхронизация. Эта операция повторно обновляет inventory и billing и затем запускает аудит доступных кластеров. Сначала исправьте ошибки прав: повторный запуск с теми же credentials их не устранит.
Как понять источник метрик
| Источник | Проверка | Ожидаемый эффект |
|---|---|---|
| metrics-server через прямой аудит | kubectl top pods -A | Текущий snapshot CPU/RAM во время аудита |
| In-cluster агент | Страница Агенты, heartbeat и логи pod | Периодическая отправка метрик metrics-server и, в режиме apply, выполнение команд |
| Prometheus / VictoriaMetrics | Источник в настройках rightsizing и успешный backend collection | Исторические ряды; backend сначала пробует Prometheus, затем использует metrics-server как fallback |