Установка Prometheus Operator с поддержкой Yandex Monitoring

Prometheus Operator с поддержкой Yandex Monitoring упрощает установку и управление системой мониторинга Yandex Managed Service for Prometheus®. С помощью нее можно собирать, хранить и читать метрики из контейнеров, приложений и инфраструктуры. Система использует модель данных Prometheus и язык запросов PromQL, что позволяет работать с уже существующими дашбордами в Grafana.

Перед началом работыПеред началом работы

1. Убедитесь, что группы безопасности для кластера Managed Service for Kubernetes и его групп узлов настроены корректно. Если отсутствует какое-либо из правил — добавьте его.

   Важно

   От настройки групп безопасности зависит работоспособность и доступность кластера, а также запущенных в нем сервисов и приложений.

2. Создайте сервисный аккаунт с ролью monitoring.editor.

3. Создайте API-ключ для сервисного аккаунта:

   • Если установка Prometheus Operator будет выполняться с помощью Yandex Cloud Marketplace, создайте API-ключ в формате JSON и сохраните его в файл sa-key.json:

     yc iam api-key create \
        --service-account-name=<имя_сервисного_аккаунта> \
        --format=json > sa-key.json
     

   • Если установка Prometheus Operator будет выполняться с помощью Helm-чарта, выполните команду и сохраните полученный секретный ключ (secret):

     yc iam api-key create --service-account-name=<имя_сервисного_аккаунта>
     

4. Установите kubectl и настройте его на работу с созданным кластером.

Установка с помощью Yandex Cloud MarketplaceУстановка с помощью Yandex Cloud Marketplace

1. Перейдите на страницу каталога и выберите сервис Managed Service for Kubernetes.
2. Нажмите на имя нужного кластера Kubernetes и выберите вкладку Marketplace.
3. В разделе Доступные для установки приложения выберите Prometheus Operator с поддержкой Yandex Monitoring и нажмите кнопку Перейти к установке.
4. Задайте настройки приложения:
   • Пространство имен — создайте новое пространство имен (например, prometheus-operator-space). Если вы оставите пространство имен по умолчанию, Prometheus Operator может работать некорректно.
   • Название приложения — укажите название приложения.
   • Prometheus Workspace — выберите нужный воркспейс Prometheus.
   • API-ключ — укажите содержимое файла sa-key.json, полученного ранее.
5. Нажмите кнопку Установить.
6. Дождитесь перехода приложения в статус Deployed.

Установка с помощью Helm-чартаУстановка с помощью Helm-чарта

1. Установите менеджер пакетов Helm версии не ниже 3.8.0.

2. Получите идентификатор воркспейса Prometheus, он понадобится для дальнейшей настройки:

   1. На главной странице сервиса Yandex Monitoring, на панели слева, выберите Prometheus.
   2. Перейдите на страницу нужного воркспейса. На ней отображается его идентификатор.

3. Для установки Helm-чарта с Prometheus Operator выполните команду:

   helm pull oci://cr.yandex/yc-marketplace/yandex-cloud/prometheus/kube-prometheus-stack \
     --version 57.2.0-1 \
     --untar && \
   helm install \
     --namespace <пространство_имен_для_Prometheus_Operator> \
     --create-namespace \
     --set prometheusWorkspaceId=<идентификатор_воркспейса_Prometheus> \
     --set iam_api_key_value_generated.secretAccessKey=<секретная_часть_API-ключа> \
     prometheus ./kube-prometheus-stack/
   

   Эта команда также создаст новое пространство имен для работы Prometheus Operator.

   Если вы укажете в параметре namespace пространство имен по умолчанию, Prometheus Operator может работать некорректно. Рекомендуем указывать значение, отличное от всех существующих пространств имен (например, prometheus-operator-space).

   Примечание

   Если вы используете версию Helm ниже 3.8.0, добавьте в начало команды строку export HELM_EXPERIMENTAL_OCI=1 && \, чтобы включить поддержку Open Container Initiative (OCI) в клиенте Helm.

4. Убедитесь, что поды Prometheus Operator перешли в состояние Running:

   kubectl get pods --namespace=<пространство_имен_для_Prometheus_Operator> \
      -l "release=prometheus"
   

Подключение к дашборду GrafanaПодключение к дашборду Grafana

Чтобы подключиться к дашборду Grafana:

1. Получите имя пода с работающим приложением Grafana:

   kubectl get pods --namespace=<пространство_имен_Prometheus_Operator> \
     | grep grafana
   

2. Настройте переадресацию порта сервиса grafana на локальный компьютер:

   kubectl port-forward --namespace=<пространство_имен_Prometheus_Operator> \
     <имя_пода_Grafana> 8080:3000
   

   Примечание

   Если закрыть окно терминала или прервать выполнение команды, переадресация порта будет остановлена.

3. Откройте в браузере дашборд Grafana по адресу http://localhost:8080.

4. Авторизуйтесь с логином admin и паролем prom-operator.

См. такжеСм. также

• Yandex Monitoring.
• Yandex Managed Service for Prometheus®.
• Документация Prometheus Remote Storage.

© 2025 Linux Foundation. Все права защищены. Linux Foundation зарегистрировала товарные знаки и использует товарные знаки. Список товарных знаков Linux Foundation см. на странице Trademark Usage.