Как настроить SMTP в Grafana для писем с алертами

Что указать в Grafana

Настройка по шагам

1. Купите пакет на странице Bulko SMTP Relay и скопируйте логин и пароль из Dashboard -> SMTP Access.
2. Откройте конфиг Grafana: /etc/grafana/grafana.ini при установке из пакета или custom.ini в каталоге conf при установке из архива.
3. Найдите секцию [smtp], уберите ; в начале нужных строк и впишите значения из примера ниже. Обратите внимание: в host указывается и порт, smtp.bulko.io:587.
4. Для портов 587 и 2525 задайте startTLS_policy = MandatoryStartTLS. С портом 465 (host = smtp.bulko.io:465) Grafana сама использует неявный TLS.
5. Если в пароле есть # или ;, заключите его в тройные кавычки, иначе Grafana посчитает остаток строки комментарием.
6. В Docker или Kubernetes файл можно не трогать и передать переменные GF_SMTP_* (имя секции и ключа в верхнем регистре через подчёркивание).
7. Перезапустите Grafana (systemctl restart grafana-server или перезапуск контейнера).

grafana.ini (секция [smtp])

[smtp]
enabled = true
host = smtp.bulko.io:587
user = smtp_xxxxxxxxxxxxxxxx
# тройные кавычки нужны, если в пароле есть # или ;
password = """YOUR_BULKO_SMTP_PASSWORD"""
from_address = [email protected]
from_name = Grafana
startTLS_policy = MandatoryStartTLS
skip_verify = false

# То же самое для Docker / Kubernetes:
# GF_SMTP_ENABLED=true
# GF_SMTP_HOST=smtp.bulko.io:587
# GF_SMTP_USER=smtp_xxxxxxxxxxxxxxxx
# GF_SMTP_PASSWORD=YOUR_BULKO_SMTP_PASSWORD
# [email protected]
# GF_SMTP_FROM_NAME=Grafana
# GF_SMTP_STARTTLS_POLICY=MandatoryStartTLS

Проверка

В Grafana откройте Alerting -> Contact points, создайте или отредактируйте точку контакта с интеграцией Email, укажите свой адрес и нажмите Test. Тестовое уведомление должно прийти в течение минуты.

При ошибке Grafana покажет ответ SMTP прямо в интерфейсе, а полный текст будет в логе сервера (/var/log/grafana/grafana.log или docker logs). Приглашения и сброс пароля используют те же настройки SMTP.

Ошибки и решения

Частые вопросы

Можно ли настроить SMTP в Grafana через веб-интерфейс?

Нет. SMTP-сервер задаётся только в grafana.ini (или custom.ini) либо переменными GF_SMTP_*. В интерфейсе настраиваются точки контакта, которые этот сервер используют.

Какая переменная окружения отвечает за SMTP-хост Grafana?

GF_SMTP_HOST, например GF_SMTP_HOST=smtp.bulko.io:587. Все ключи строятся по схеме GF_<СЕКЦИЯ>_<КЛЮЧ>, поэтому startTLS_policy превращается в GF_SMTP_STARTTLS_POLICY.

Подходит ли это для Grafana Cloud?

Инструкция рассчитана на self-hosted Grafana (OSS или Enterprise), где у вас есть доступ к grafana.ini. В Grafana Cloud доставкой почты занимается сам сервис.

Сколько писем с алертами можно отправить?

По умолчанию 2 000 писем в сутки на один SMTP-аккаунт, лимит можно поднять через [email protected]. Группируйте алерты в notification policies, чтобы не устраивать лавину писем.

Сколько это стоит?

Пакеты Bulko SMTP оплачиваются один раз: $5 за 5 000 писем, $15 за 20 000, $30 за 50 000 или $60 за 150 000. Неиспользованные письма не сгорают, что удобно при небольшом потоке алертов.

Какой порт выбрать для Grafana?

Обычно 587 с startTLS_policy = MandatoryStartTLS. Для неявного TLS подойдёт 465, а если сеть закрывает стандартные порты, 2525.