Чтение и запись метрик кластера Yandex Managed Service for Kubernetes с помощью Prometheus Operator

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

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

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 | jq -c > sa-key.json
     

     Совет

     Вы также можете автоматически создать новый API-ключ во время установки приложения.

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

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

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

5. Если у вас еще нет воркспейса Prometheus, создайте его:

   Консоль управления

   1. Откройте главную страницу сервиса Monitoring.
   2. На панели слева выберите Prometheus.
   3. Нажмите кнопку Создать воркспейс.

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

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

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

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

   Консоль управления

   1. Откройте главную страницу сервиса Monitoring.
   2. Слева выберите раздел Prometheus.
   3. Выберите воркспейс Prometheus.
   4. Откроется вкладка Общая информация, где отображается идентификатор воркспейса — сохраните его.

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

   helm pull oci://cr.yandex/yc-marketplace/yandex-cloud/prometheus/kube-prometheus-stack \
     --version 72.6.2-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"
   

Просмотр графиков по метрикамПросмотр графиков по метрикам

Добавление графика на дашбордДобавление графика на дашборд

(Опционально) Настройка алертинга по метрикам(Опционально) Настройка алертинга по метрикам

1. Создайте канал уведомлений, выбрав доступный способ отправки.

2. Настройте Alert Manager, который отвечает за отправку уведомлений:

   1. Откройте главную страницу сервиса Monitoring.

   2. Слева выберите раздел Prometheus.

   3. Выберите воркспейс Prometheus.

   4. Перейдите на вкладку Конфигурация Alert manager.

   5. Нажмите кнопку Загрузить файл конфигурации и загрузите файл конфигурации в формате YAML.

      Пример файла конфигурации

      global:
        resolve_timeout: 5m
      route:
        receiver: telegram
        routes:
          - receiver: "null"
            matchers:
              - severity="none"
            continue: false
      
      receivers:
        - name: telegram
          yandex_monitoring_configs:
            - channel_names:
              - "<имя канала уведомлений>"
        - name: "null"
          yandex_monitoring_configs:
            - channel_names: []
      

3. Добавьте тестовое правило алертинга:

   cat <<EOF | kubectl apply -f -
   apiVersion: monitoring.coreos.com/v1                                                        
   kind: PrometheusRule
   metadata:
     labels:
       release: kube-prometheus-stack
     name: test
   spec:
     groups:
     - name: test
       rules:
         - alert: Test
           annotations:
             description: this is a test alert
             summary: test alert
           expr: vector(1)
           labels:
             severity: warning
   EOF
   

4. Дождитесь, пока в выбранный канал уведомлений придет алерт, или проверьте статус алерта в консоли управления:

   1. Откройте главную страницу сервиса Monitoring.
   2. Слева выберите раздел Prometheus.
   3. Выберите воркспейс Prometheus.
   4. Перейдите на вкладку Управление правилами.
   5. Нажмите на имя тестового алерта.
   6. Перейдите на вкладку Алерты.
   7. Убедитесь, что тестовый алерт перешел в состояние FIRING.

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

• Yandex Managed Service for Kubernetes

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