Kube Prometheus Stack

Подготовительные шаги

Ознакомьтесь с системными требованиями аддона, чтобы убедиться, что у вас достаточно ресурсов для его установки.
(Опционально) Выполните ручное масштабирование групп worker-узлов или настройте автоматическое масштабирование.

Установка аддона

Для аддона Kube Prometheus Stack доступно несколько вариантов установки.

Стандартная установка

Установка на выделенные worker-узлы

Быстрая установка

Установите аддон:
Личный кабинет
Перейдите в личный кабинет VK Cloud.

Выберите проект, где находится нужный кластер.

Перейдите в раздел Кластеры Kubernetes → Кластеры Kubernetes.

Нажмите на имя нужного кластера.

Перейдите на вкладку Аддоны.

Нажмите кнопку Установить на карточке аддона kube-prometheus-stack и нажмите кнопку Установить аддон.

(Опционально) Отредактируйте:

название приложения;

название пространства имен, куда будет установлен аддон;

код настройки аддона (например, для установки временного пароля веб-интерфейса Grafana).

Нажмите кнопку Установить аддон.

Начнется установка аддона в кластер. Этот процесс может занять длительное время.
(Опционально) Измените размер диска Prometheus.
(Опционально) Получите пароль для Grafana из секрета Kubernetes.
(Опционально) Подключитесь к веб-интерфейсу Grafana, входящему в состав аддона Kube Prometheus Stack.

Редактирование кода настройки аддона при установке

Редактирование кода аддона применимо для стандартной установки и установки на выделенные worker-узлы. Полный код настройки аддона вместе с описанием полей доступен на GitHub.

Установка временного пароля для веб-интерфейса Grafana

При установке аддона с параметрами по умолчанию будет создан секрет Kubernetes, содержащий постоянный пароль для входа в веб-интерфейс Grafana.

Также при установке аддона можно указать временный пароль пользователя. В этом случае первый вход в веб-интерфейс Grafana выполняется в этим паролем, затем будет предложено его сменить. Для этого измените значение поля в коде настройки аддона:


grafana:  adminPassword: "<ВРЕМЕННЫЙ_ПАРОЛЬ>"

Значение этого поля действует только при установке аддона. Если изменить его у уже установленного аддона, секрет Kubernetes обновится, но пароль для входа в Grafana не изменится: пользователь admin хранится в базе Grafana на PVC и не перезаписывается при обновлении. В этом случае пароль из секрета может не подойти для входа.

Чтобы сменить пароль на уже установленном аддоне, задайте новый пароль с помощью команды сброса или переустановите аддон с удалением PVC Grafana.

После редактирования кода продолжите установку аддона.

Дополнительные действия с аддоном

Изменение размера диска Prometheus

На диске Prometheus хранятся данные мониторинга кластера. Если для них недостаточно места, или вы хотите увеличить производительность диска Prometheus, увеличьте размер диска.

Личный кабинет

Перейдите в личный кабинет VK Cloud.
Выберите проект, где находится нужный кластер.
Перейдите в раздел Кластеры Kubernetes → Кластеры Kubernetes.
Нажмите на имя нужного кластера.
Перейдите на вкладку Аддоны.
Нажмите для аддона kube-prometheus-stack и выберите пункт Изменить размер диска Prometheus.
Задайте нужный размер диска. Операция работает только в сторону увеличения.
Нажмите кнопку Подтвердить.

Получение пароля для Grafana из секрета Kubernetes

Если аддон был установлен без указания временного пароля, значение пароля для входа в веб-интерфейс Grafana можно получить из секрета Kubernetes. Если после установки аддона значение grafana.adminPassword изменялось, пароль в секрете может не совпадать с паролем для входа в Grafana.

Headlamp

kubectl

Подключитесь к кластеру с помощью Headlamp, если он установлен.
Перейдите в раздел меню Конфигурация → Секреты.
Найдите в списке секрет Grafana и нажмите на его имя.

Секрет находится в пространстве имен, в котором установлен аддон (по умолчанию — prometheus-monitoring). Его имя формируется на основе названия приложения: <НАЗВАНИЕ_ПРИЛОЖЕНИЯ>-grafana. Если аддон был установлен через личный кабинет и название приложения было сгенерировано автоматически, имя секрета будет иметь вид addon-<ХЕШ>-grafana.
В блоке Данные нажмите на иконку глаза.

Будет отображен пароль.

Сброс пароля для Grafana

Если пароль для входа в веб-интерфейс Grafana утерян или не подходит (например, пароль в секрете Kubernetes не совпадает с фактическим), вы можете задать новый пароль.

Получите имя пода Grafana:


kubectl -n <ПРОСТРАНСТВО_ИМЕН> get pod -l app.kubernetes.io/name=grafana

Здесь <ПРОСТРАНСТВО_ИМЕН> — пространство имен, в котором установлен аддон. По умолчанию — prometheus-monitoring.

Сбросьте пароль, выполнив команду внутри пода Grafana:
```
kubectl -n <ПРОСТРАНСТВО_ИМЕН> exec <ИМЯ_ПОДА_GRAFANA> -- sh -c "grafana cli --debug admin reset-admin-password <НОВЫЙ_ПАРОЛЬ>"
```
Здесь:
- <ПРОСТРАНСТВО_ИМЕН> — пространство имен, в котором установлен аддон.
- <ИМЯ_ПОДА_GRAFANA> — имя пода из вывода предыдущей команды.
- <НОВЫЙ_ПАРОЛЬ> — новый пароль для входа в Grafana.
Если пароль успешно сброшен, в выводе команды будет сообщение Admin password changed successfully ✔.

Переустановка аддона с удалением PVC Grafana

Этот способ позволяет задать пароль Grafana через поле grafana.adminPassword в коде настройки аддона.

Удалите аддон kube-prometheus-stack.

Проверьте, остался ли PVC Grafana:


kubectl -n <ПРОСТРАНСТВО_ИМЕН> get pvc -l app.kubernetes.io/name=grafana

Здесь <ПРОСТРАНСТВО_ИМЕН> — пространство имен, в котором был установлен аддон. По умолчанию — prometheus-monitoring.

Если PVC остался, удалите его:
```
kubectl -n <ПРОСТРАНСТВО_ИМЕН> delete pvc <ИМЯ_PVC_GRAFANA>
```
Здесь:
- <ПРОСТРАНСТВО_ИМЕН> — пространство имен, в котором был установлен аддон.
- <ИМЯ_PVC_GRAFANA> — имя PVC из вывода предыдущей команды.
Установите аддон заново и задайте нужный пароль в коде настройки.

Была ли статья полезна?

Содержание

Была ли статья полезна?