Предварительная настройка оповещений

Для работы с оповещениями их необходимо предварительно настроить в файле конфигурации менеджера ppem-manager.yml.

Вы можете указать следующие параметры:

alerts:
  metrics:
    request_chunk_size: количество_идентификаторов_экземпляров
  cleanup_grace_period: интервал_удаления_оповещений_если_данные_не_получены
  scheduler:
    interval: интервал_проверки_новых_оповещений
    initial_delay: задержка_запуска_планировщика_оповещений
    timeout: тайм-аут_обновления_правил_триггеров_оповещений
  delayed_data:
    is_enabled: true или false
    data_delay: задержка_получения_данных_из_любых_источников_установленная_по_умолчанию
    datasource_delays:
      metrics: задержка_получения_метрик
      logs: задержка_получения_данных_журналов
    max_delay: максимально_допустимая_задержка_получения_данных
    is_adaptive_delay: true или false
  notifier:
    num_workers: количество_параллельных_рабочих_процессов
    worker_batch_size: количество_оповещений_в_одном_пакете
    worker_interval: интервал_проверки_новых_оповещений
    backoff_base: длительность_расчёта_экспоненциальной_задержки
    max_retries: максимальное_количество_попыток_оповещения
    notification_timeout: тайм-аут_оповещения
    janitor_interval: интервал_опроса_рабочего_процесса_очистки
    stale_processing_timeout: тайм-аут_обработки_устаревших_оповещений
  email:
    is_enabled: true или false
    smtp:
      host: имя_хоста_или_IP_SMTP-сервера
      port: порт_SMTP-сервера
      username: имя_пользователя_для_аутентификации_в_SMTP-сервере
      password: пароль_для_аутентификации_в_SMTP-сервере
      from: электронная_почта_отправителя_оповещений
      timeout: тайм-аут_подключения_к_SMTP-серверу
      use_starttls: true или false
      use_ssl: true или false
      tls:
        insecure_skip_verify: true или false
        root_ca_path: путь_к_корневому_сертификату

Где:

Создание оповещения

1. В навигационной панели перейдите в Мониторинг → Оповещения.

2. В правом верхнем углу страницы нажмите Создать триггер.

3. Укажите параметры нового оповещения (помеченные звёздочкой параметры являются обязательными):

   • Имя.

   • Приоритет: приоритет оповещения.

     Возможные значения:

     • Низкий

     • Средний

     • Высокий

   • Тип источника данных: тип метрик, которые будут использоваться для триггера оповещения.

     В настоящий момент можно использовать только метрики pgpro-otel-collector.

   • Источник данных.

   • Состояние: состояние оповещения после создания.

     Возможные значения:

     • Выключен

     • Включен

   • Интервал проверки, сек.: интервал времени в секундах для проверки источника данных триггера оповещения.

     Минимальное значение: 60.

   • Проверка на нестабильнось, шт.: количество повторно сработавших триггеров, необходимых для остановки оповещения.

     Если для параметра задано значение 0, это ограничение отключено.

   • Задержка оповещения, сек.: время в секундах, в течение которого триггер должен повторно срабатывать, чтобы было отправлено оповещение.

   • Период охлаждения, сек.: время в секундах, в течение которого оповещение не будет отправляться после последнего сработавшего триггера.

     0 значит, что это ограничение отключено.

4. Нажмите Далее, затем укажите дополнительные параметры (помеченные звёздочкой параметры являются обязательными):

   • Имя метрики: имя метрики без дополнительных символов, которое будет использоваться для триггера оповещения.

     Вы можете использовать следующие метрики pgpro-otel-collector из таблицы monitoring.metrics базы данных репозитория:

     • postgresql.archiver.archived_count

     • postgresql.archiver.failed_count

     • postgresql.bgwriter.buffers_checkpoint

     • postgresql.bgwriter.buffers_clean

     • postgresql.bgwriter.buffers_backend

     • postgresql.bgwriter.buffers_allocated

     • postgresql.bgwriter.maxwritten_clean

     • postgresql.bgwriter.buffers_backend_fsync

     • postgresql.bgwriter.checkpoints_requested

     • postgresql.bgwriter.checkpoints_timed

     • postgresql.bgwriter.checkpoint_sync_time_milliseconds

     • postgresql.bgwriter.checkpoint_write_time_milliseconds

     • postgresql.databases.blocks_hit

     • postgresql.databases.blocks_read

     • postgresql.databases.conflicts

     • postgresql.databases.deadlocks

     • postgresql.databases.checksum_failures

     • postgresql.databases.tuples_fetched

     • postgresql.databases.tuples_returned

     • postgresql.databases.tuples_inserted

     • postgresql.databases.tuples_updated

     • postgresql.databases.tuples_deleted

     • postgresql.databases.temp_bytes

     • postgresql.databases.temp_files

     • postgresql.wal.bytes

     • postgresql.databases.rollbacks

     • system.cpu.utilization

     • system.memory.usage

     • system.paging.usage

     • postgresql.wal.records

     • postgresql.databases.commits

   • Оператор • Порог значения: условие правила триггера оповещения, содержащее логический оператор и значение.

     Возможные логические операторы:

     • = (eq)

     • > (gt)

     • >= (gte)

     • < (lt)

     • <= (lte)

     • != (neq)

     Например, если вы выбираете > и указываете 0, оповещение отправляется, когда значение указанной метрики превышает 0.

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

   • Условие для правил: логические связки для указанных условий правил триггеров оповещений.

     Возможные значения:

     • И

     • Или

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

   • Экземпляры для проверки.

     Возможные значения:

     • Проверять все.

     • Выбрать экземпляры.

       Для этого значения из выпадающего списка Экземпляры выберите экземпляры.

   • Уведомлять пользователей: пользователи, которые будут получать оповещения.

   • Уведомлять группы: группы пользователей, которые будут получать оповещения.

   • Шаблон оповещения: шаблон текста оповещения.

     В тексте оповещения можно использовать следующие переменные:

     • {{.Title}}: имя метрики, используемой для триггера оповещения.

     • {{.Timestamp}}: время и дата, когда сработал триггер оповещения.

     • {{.HostName}}: имя хоста, на котором сработал триггер.

     • {{.AgentName}}: агент, для которого сработал триггер.

     • {{.InstanceName}}: имя экземпляра, в котором сработал триггер.

     • {{.Status}}: статус триггера оповещения.

   • Уведомление о разрешении: указывает, отправляется ли оповещение при разрешении триггера.

     Возможные значения:

     • Включено.

       Для этого значения в поле Шаблон при разрешении введите шаблон текста оповещения.

       В этом тексте оповещения можно использовать такие же переменные, как в поле Шаблон оповещения.

     • Выключено.

5. Нажмите Далее, затем Сохранить, чтобы подтвердить выбранные параметры и создать триггер.

Просмотр оповещений

В навигационной панели перейдите в Мониторинг → Оповещения.

Отобразится таблица оповещений со следующими столбцами:

Просмотр подробной информации об оповещении

1. В навигационной панели перейдите в Мониторинг → Оповещения.

2. Нажмите → Смотреть подробности рядом с оповещением.

   Отобразится окно с информацией об оповещении со следующими вкладками:

   • История оповещений: история срабатывания триггера.

   • Параметры. За подробной информацией о параметрах оповещений обратитесь к Создание оповещения.

3. Нажмите Закрыть.

Отключение и включение оповещений

1. В навигационной панели перейдите в Мониторинг → Оповещения.

2. Нажмите или рядом с оповещением.

Редактирование оповещения

1. В навигационной панели перейдите в Мониторинг → Оповещения.

2. Нажмите → Редактировать рядом с оповещением.

3. Отредактируйте параметры оповещения.

4. Нажмите Сохранить.

Редактирование получателей оповещения

1. В навигационной панели перейдите в Мониторинг → Оповещения.

2. Нажмите → Изменить получателей рядом с оповещением.

3. Отредактируйте пользователей и группы пользователей, которые получают оповещения.

4. Нажмите Сохранить.

Очистка истории оповещений

1. В навигационной панели перейдите в Мониторинг → Оповещения.

2. Нажмите → Смотреть подробности рядом с оповещением.

3. Нажмите Очистить.

Удаление оповещения

Чтобы удалить оповещение:

1. В навигационной панели перейдите в Мониторинг → Оповещения.

2. Нажмите рядом с оповещением.

3. Подтвердите операцию и нажмите Удалить.