Одна точка, где слышно весь ваш парк машин

Типичные задачи #

Выберите, что нужно сделать. В каждом рецепте команда уже написана — подставьте свои ARN и текст и нажмите Копировать.

$ sudo imaxe global-alerts configure \
    --topic-arn arn:aws:sns:eu-west-1:123456789012:imaxe-alerts

$ sudo imaxe global-alerts configure --source web-prod-1

$ sudo imaxe global-alerts test

$ sudo imaxe global-alerts send --severity critical \
    --source backup --subject "резервная копия не удалась" \
    "ночная резервная копия базы данных завершилась с ошибкой"

$ df -h / | sudo imaxe global-alerts send --severity warning -

$ sudo imaxe global-alerts send --severity warning \
    --dedup-key root-disk-full "корневой диск на 95%"

$ sudo imaxe global-alerts status

$ sudo imaxe global-alerts show
$ sudo imaxe global-alerts status --json

$ sudo imaxe global-alerts configure --min-severity warning

dedup_window: 1h   # 30s, 5m, 1h… (по умолчанию 5m)

$ sudo imaxe global-alerts history

$ sudo imaxe global-alerts flush
$ systemctl status imaxe-global-alerts-flush.timer

$ sudo imaxe global-alerts remove

Синопсис #

imaxe global-alerts <подкоманда> [--topic-arn ARN] [--severity УРОВЕНЬ] [флаги]

Подкоманды #

Аргументы и флаги #

Настройка через теги экземпляра #

Каждому развёртыванию нужна своя тема, и пересобирать ради этого AMI не имело бы смысла. Поэтому модуль читает, помимо файла, теги экземпляра с префиксом imaxe.global-alerts. через IMDSv2: если они есть, они важнее YAML. Именно так делает шаблон CloudFormation из лаунчера, который вдобавок требует MetadataOptions.InstanceMetadataTags: enabled, чтобы теги можно было прочитать.

Вне AWS или при заблокированном IMDS чтение падает за миллисекунды, и модуль продолжает с тем, что сказано в файле. Чтобы увидеть, что действительно применилось, — imaxe global-alerts show.

Файлы и пути #

Пример global-alerts.yml:

enabled: true
topic_arn: arn:aws:sns:eu-west-1:123456789012:imaxe-alerts
region: ""            # пусто = выводится из ARN или из IMDS
source: ""            # пусто = hostname экземпляра
min_severity: info
dedup_window: 5m

Состояние (очередь и журнал дедупликации) намеренно лежит в /var/lib/imaxe/, а не в /etc/: это состояние, а не конфигурация. Оба пути можно перенести переменными окружения IMAXE_CONFIG_DIR и IMAXE_STATE_DIR.

Формат оповещения #

Тело сообщения SNS — версионированный JSON (schema: 1), чтобы подписчик мог обработать его Lambda-функцией или очередью, а не только прочитать почтой:

{
  "schema": 1,
  "severity": "critical",
  "source": "backup",
  "subject": "резервная копия не удалась",
  "message": "ночная резервная копия базы данных завершилась с ошибкой",
  "host": "web-prod-1",
  "instance_id": "i-0abc123def4567890",
  "region": "eu-west-1",
  "ts": "2026-07-25T03:14:07Z",
  "dedup_key": "9f2c1b7e44a0d513"
}

Тема сообщения SNS собирается как [imaxe][важность] host: тема, приводится к печатному ASCII и обрезается до 100 символов — это ограничение SNS.

Коды возврата и логи #

Каждый запуск возвращает код, который можно проверить через echo $? — удобно для цепочек в скриптах:

Модуль также отвечает на проверку здоровья imaxe: если он включён, но темы нет, health падает, так что imaxe health выдаст это раньше, чем понадобится первое оповещение.

$ sudo imaxe global-alerts test; echo "код: $?"
$ journalctl -u imaxe-global-alerts-flush.service -n 50

Решение проблем #