Yandex Cloud
Поиск
Связаться с намиПодключиться
  • Документация
  • Блог
  • Все сервисы
  • Статус работы сервисов
    • Популярные
    • Инфраструктура и сеть
    • Платформа данных
    • Контейнеры
    • Инструменты разработчика
    • Бессерверные вычисления
    • Безопасность
    • Мониторинг и управление ресурсами
    • Машинное обучение
    • Бизнес-инструменты
  • Все решения
    • По отраслям
    • По типу задач
    • Экономика платформы
    • Безопасность
    • Техническая поддержка
    • Каталог партнёров
    • Обучение и сертификация
    • Облако для стартапов
    • Облако для крупного бизнеса
    • Центр технологий для общества
    • Облако для интеграторов
    • Поддержка IT-бизнеса
    • Облако для фрилансеров
    • Обучение и сертификация
    • Блог
    • Документация
    • Контент-программа
    • Мероприятия и вебинары
    • Контакты, чаты и сообщества
    • Идеи
    • Истории успеха
    • Тарифы Yandex Cloud
    • Промоакции и free tier
    • Правила тарификации
  • Документация
  • Блог
Проект Яндекса
© 2025 ООО «Яндекс.Облако»
Yandex Monitoring
  • Начало работы
    • Обзор
    • Правила записи
    • Правила алертинга
    • Чтение и запись метрик кластера Kubernetes
  • Управление доступом
  • Правила тарификации
  • Справочник Terraform
  • История изменений
  • Обучающие курсы

В этой статье:

  • Требования к правилам алертинга
  • Алерт-менеджер
  • Предварительная настройка для работы с API
  • Добавление и замена файла с правилами алертинга
  • Добавление и замена файла с конфигурацией алерт-менеджера
  1. Yandex Managed Service for Prometheus®
  2. Правила алертинга

Правила алертинга

Статья создана
Yandex Cloud
Обновлена 19 ноября 2024 г.
  • Требования к правилам алертинга
  • Алерт-менеджер
  • Предварительная настройка для работы с API
  • Добавление и замена файла с правилами алертинга
  • Добавление и замена файла с конфигурацией алерт-менеджера

Примечание

Правила алертинга находятся на стадии Technical Preview. Чтобы получить доступ к функциональности, обратитесь в техническую поддержку.

Алертинг в Yandex Managed Service for Prometheus® позволяет добавить правила вычисления алертов и отправлять уведомления об их срабатывании. Настройка алертинга в Prometheus включает создание правил алертинга и настройку Alert manager для обработки и доставки уведомлений.

Требования к правилам алертингаТребования к правилам алертинга

В Prometheus вы можете использовать ваши существующие файлы с правилами алертинга (alerting rules) на основе PromQL.

Для описания правил поддерживаются все поля из спецификации YAML-файла. Поддерживается шаблонизация аннотаций с помощью переменных $value и $labels. Итерации и функции не поддерживаются.

В этом разделе описаны особенности работы с правилами алертинга и конфигурацией алерт-менеджера. Способы загрузки и работы с файлами см. в разделе Правила записи.

Алерт-менеджерАлерт-менеджер

Алерт-менеджер — компонент в составе Prometheus, который отвечает за отправку уведомлений и настраивается отдельно от файлов правил. Вы можете использовать ваши существующие файлы конфигурации.

Особенности обработки правил:

  • Каналы уведомлений из файла конфигурации сопоставляются с каналами уведомлений в Yandex Monitoring, которые заданы в каталоге воркспейса.
  • Поддерживается отправка в каналы email и Telegram. Остальные каналы будут проигнорированы без уведомлений об ошибках. В будущем планируется поддержка всех каналов уведомлений, доступных в Yandex Monitoring.
  • Канал выбирается согласно заданному типу, динамическая маршрутизация пока не поддерживается, но запланирована.
  • Если в конфигурации нет каналов, соответствующих каналам в каталоге, файл не будет принят.

Вы можете использовать правила алертинга, не загружая файл конфигурации. В этом случае они будут рассчитываться и создавать метрики ALERTS и ALERTS_FOR_STATE, но отправки уведомлений по алертам не будет.

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

Предварительная настройка для работы с APIПредварительная настройка для работы с API

API представлен набором REST-ресурсов, которые находятся по адресу https://monitoring.api.cloud.yandex.net/prometheus/workspaces/<идентификатор_воркспейса>/extensions/v1/rules.

Чтобы начать выполнять запросы:

  1. Установите cURL.
  2. Аутентифицируйтесь в API.
  3. Создайте воркспейс и скопируйте его идентификатор, чтобы использовать в адресе запросов.

Добавление и замена файла с правилами алертингаДобавление и замена файла с правилами алертинга

Консоль управления
API
  1. На странице сервиса Monitoring слева выберите Prometheus.
  2. Выберите или создайте воркспейс.
  3. Перейдите на вкладку Recording rules.
  4. Если у вас еще нет загруженных файлов, нажмите Добавить файл и выберите файл .yml с правилами.
  5. Чтобы добавить еще один файл, нажмите Добавить файл.
  6. Чтобы заменить существующий файл, справа от него нажмите > Заменить файл.
  1. Закодируйте содержимое файла в Base64 согласно RFC 4648:

    cat alerting-rule.yaml
    
    # groups:
    #   - name: example
    #     rules:
    #     - alert: HighRequestLatency
    #       expr: job:request_latency_seconds:mean5m{job="myjob"} > 0.5
    #       for: 10m
    #       labels:
    #         severity: page
    #       annotations:
    #         summary: High request latency
    
    base64 -i alerting-rule.yaml
    
    # Z3JvdXBzOgotIG5hbWU6IGV4YW1wbGUKICBydWxlczoKICAtIGFsZXJ0OiBIaW...CBsYXRlbmN5Cg==
    
  2. Сохраните результат в JSON-файл:

    body.json

    {
        "name": "alerting-rules",
        "content" : "Z3JvdXBzOgotIG5hbWU6IGV4YW1wbGUKICBydWxlczoKICAtIGFsZXJ0OiBIaW...CBsYXRlbmN5Cg=="
    }
    
  3. Создайте или замените файл с правилами алертинга:

    export IAM_TOKEN=<IAM-токен>
    
    curl -X PUT \
        -H "Content-Type: application/json" \
        -H "Authorization: Bearer ${IAM_TOKEN}" \
        -d "@body.json"  \
        "https://monitoring.api.cloud.yandex.net/prometheus/workspaces/<идентификатор_воркспейса>/extensions/v1/rules"
    

Добавление и замена файла с конфигурацией алерт-менеджераДобавление и замена файла с конфигурацией алерт-менеджера

Консоль управления
API
  1. На странице сервиса Monitoring слева выберите Prometheus.
  2. Выберите или создайте воркспейс.
  3. Перейдите на вкладку Конфигурация Alert manager.
  4. Если у вас еще нет загруженного файла конфигурации, нажмите кнопку Загрузить файл конфигурации и выберите файл .yml.
  5. Чтобы скачать файл, нажмите Скачать.
  6. Чтобы заменить файл, нажмите Заменить файл.
  1. Закодируйте содержимое файла в Base64 согласно RFC 4648:

    cat alert-manager.yaml
    
    # receivers:
    #   - name: 'email'
    #     email_configs:
    #       - to: 'alerts@monitoring.org'
    #   - name: 'telegram'
    #     telegram_configs:
    #     - api_url: https://api.telegram.org
    
    base64 -i alert-manager.yaml
    
    # cmVjZWl2ZXJzOgogIC0gbmFtZTogJ2VtYWlsJwogICA...sOiBodHRwczovL2FwaS50ZWxlZ3JhbS5vcmcKCg==
    
  2. Сохраните результат в JSON-файл:

    body.json

    {
        "content" : "cmVjZWl2ZXJzOgogIC0gbmFtZTogJ2VtYWlsJwogICA...sOiBodHRwczovL2FwaS50ZWxlZ3JhbS5vcmcKCg=="
    }
    
  3. Создайте или замените файл конфигурации:

    export IAM_TOKEN=<IAM-токен>
    
    curl -X PUT \
        -H "Content-Type: application/json" \
        -H "Authorization: Bearer ${IAM_TOKEN}" \
        -d "@body.json"  \
        "https://monitoring.api.cloud.yandex.net/prometheus/workspaces/<идентификатор_воркспейса>/extensions/v1/alertmanager"
    

В случае успешного запроса будет возвращен HTTP-код 204, иначе — текст ошибки. Файл, в котором не удалось найти ни одного соответствия текущим каналам уведомлений в каталоге, не будет принят.

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

Предыдущая
Правила записи
Следующая
Чтение и запись метрик кластера Kubernetes
Проект Яндекса
© 2025 ООО «Яндекс.Облако»