Настройка параметров SMTP

В этом руководстве описано, как настроить уведомления по электронной почте SMTP в Управляемой Grafana Azure для создания оповещений электронной почты в Управляемой Grafana Azure. В этой статье рассматриваются пошаговые инструкции по настройке SMTP-серверов и включению оповещений электронной почты для предупреждения пользователей о возникновении определенных сценариев на панели мониторинга Grafana.

Параметры SMTP можно включить в существующей рабочей области Azure Managed Grafana с помощью портал Azure и Azure CLI. Включение параметров SMTP при создании новой рабочей области в настоящее время не поддерживается.

Предварительные условия

Чтобы выполнить действия, описанные в этом руководстве, необходимо:

Учетная запись Azure с активной подпиской. Создайте учетную запись бесплатно .
Рабочая область Azure Managed Grafana в тарифном плане "Стандартный". Если у вас еще нет одного, создайте новую рабочую область.
SMTP-сервер. Если у вас еще нет, вам может потребоваться использовать API электронной почты Twilio SendGrid для Azure.

Включение и настройка параметров SMTP

Выполните следующие действия, чтобы активировать параметры SMTP, включить Уведомления по электронной почте и настроить точку контакта электронной почты в Управляемой Grafana Azure.

Портал
Azure CLI

В портал Azure откройте рабочую область Grafana и в разделе "Параметры" выберите "Конфигурация".
Перейдите на вкладку "Параметры электронной почты ".
Переключите параметры SMTP так, чтобы появилось Enable.

Отображаются параметры SMTP. Заполните форму следующей конфигурацией:

Параметр	Пример	Описание
хост	smtp.sendgrid.net:587	Введите имя узла SMTP-сервера с портом.
Пользователь	администратор	Введите имя пользователя проверки подлинности SMTP.
Пароль	пароль	Введите пароль проверки подлинности SMTP. Если пароль содержит "#" или ";", заключите его в тройные кавычки.
Адрес отправителя	user@domain.com	Введите адрес электронной почты, используемый при отправке сообщений электронной почты.
Имя	Уведомление Azure Managed Grafana	Введите имя, используемое при отправке сообщений электронной почты. По умолчанию используется уведомление Azure Managed Grafana, если параметр не задан или пуст.
Пропустить проверку	Отключить	Этот параметр определяет, проверяет ли клиент цепочку сертификатов сервера и имя узла. Если Пропуск проверкивключён, клиент принимает любой сертификат, представленный сервером, и любое имя узла в этом сертификате. В этом режиме протокол TLS подвержен атакам типа «человек посередине», если не используется настраиваемая проверка. Значение по умолчанию — "Отключить " (отключается). Дополнительные сведения.
Политика StartTLS	OpportunisticStartTLS	Существует три варианта. Дополнительные сведения. OpportunisticStartTLS означает, что транзакции SMTP шифруются, если STARTTLS поддерживается SMTP-сервером. В противном случае сообщения отправляются в незашифрованном виде. Это параметр по умолчанию. Обязательный параметрStartTLS означает, что транзакции SMTP должны быть зашифрованы. Транзакции SMTP прерваны, если STARTTLS не поддерживается SMTP-сервером. NoStartTLS означает, что шифрование отключено, и сообщения отправляются в ясном виде.

Нажмите кнопку "Сохранить", чтобы сохранить параметры SMTP. Обновление может занять несколько минут.

Примечание.

Exchange Online больше не поддерживает базовую аутентификацию, см. статью "Отказ от использования базовой проверки подлинности". Не используйте Exchange Online в качестве ретранслятора SMTP, так как вы получите сообщение об ошибке, которое не удалось отправить.

После завершения процесса появится сообщение "Обновление выбранных элементов. Сообщение "Обновление успешно" отображается в уведомлениях Azure. На странице "Обзор", состояние создания рабочей области изменяется на обновление, а затем меняется на Успешно после завершения обновления.

Для включения или обновления параметров SMTP требуется расширение CLI для Azure Managed Grafana версии 1.1 или выше. Чтобы обновить расширение, выполните команду az extension update --name amg.

Выполните команду az grafana update, чтобы настроить параметры SMTP для заданной рабочей области Azure Managed Grafana. Замените заполнители сведениями из собственной рабочей области.

az grafana update --resource-group <resource-group> \
    --name <azure-managed-grafana-name> \
    --smtp enabled \
    --from-address <from-address> \
    --from-name <from-name> \
    --host "<host>" \
    --user <user> \
    --password "<password>" \
    --start-tls-policy <start-TLS-policy> \
    --skip-verify <true-or-false> \

Параметр	Пример	Описание
`--resource-group`	my-resource-group	Введите имя группы ресурсов рабочей области Azure Managed Grafana.
`--name`	моя-azure-управляемая-grafana	Введите имя рабочей области Azure Managed Grafana.
`--smtp`	включено	Введите включено , чтобы отключить параметры SMTP.
`--from-address`	user@domain.com	Введите адрес электронной почты, используемый при отправке сообщений электронной почты.
`--from-name`	Уведомление Azure Managed Grafana	Введите имя, используемое при отправке сообщений электронной почты. По умолчанию используется уведомление Azure Managed Grafana, если параметр не задан или пуст.
`--host`	smtp.sendgrid.net:587	Введите имя узла SMTP-сервера с портом.
`--user`	администратор	Введите имя пользователя проверки подлинности SMTP.
`--password`	пароль	Введите пароль проверки подлинности SMTP. Если пароль содержит "#" или ";", заключите его в тройные кавычки.
`--start-tls-policy`	OpportunisticStartTLS	Параметр StartTLSPolicy конфигурации SMTP. Существует три варианта. Дополнительные сведения. OpportunisticStartTLS означает, что транзакции SMTP шифруются, если STARTTLS поддерживается SMTP-сервером. В противном случае сообщения отправляются в открытом виде. Этот параметр принимается по умолчанию. Обязательный параметрStartTLS означает, что транзакции SMTP должны быть зашифрованы. Транзакции SMTP прерваны, если STARTTLS не поддерживается SMTP-сервером. NoStartTLS означает, что шифрование отключено, и сообщения отправляются в ясном виде.
`--skip-verify`	ложь	Этот параметр определяет, проверяет ли клиент цепочку сертификатов сервера и имя узла. Если параметр --skip-verify имеет значение true, клиент принимает любой сертификат, представленный сервером, и любое имя узла в этом сертификате. В этом режиме протокол TLS подвержен атакам типа «человек посередине», если не используется настраиваемая проверка. Значение по умолчанию — false. Дополнительные сведения.

Совет

При использовании личной учетной записи электронной почты необходимо создать пароль приложения и использовать его в качестве параметра пароля SMTP. Обратите внимание, что ваша учетная запись не будет работать для уведомлений по электронной почте, если для нее настроена многофакторная проверка подлинности.

Рекомендуется убедиться, что конфигурации SMTP будут работать должным образом, прежде чем применять их к рабочей области Azure Managed Grafana. Например, можно использовать средство открытый код, например swaks (швейцарский армейский нож для SMTP) для отправки тестовой электронной почты с помощью конфигураций SMTP, выполнив следующую команду в окне терминала:

# fill in all placeholders with your own values for the following parameters
host="<SMTP-host>:<port>" # for example "smtp.sendgrid.net:587"
user="<SMTP-user-email>" # for example "team1@contoso.com"
password="<SMTP-password>" # enter your own password
fromAddress="<from-email-address>" # "for example "team1@contoso.com"
toAddress="<to-email-address>" # for example "team2@contoso.com"
ehlo="<grafana-endpoint>" # for example "<workspace-prefix>-<ID>.<region>.grafana.azure.com"

header="Subject:Test"
body="Testing!"

# test SMTP connection by sending an email
swaks --auth -tls \
    --server $host \
    --auth-user $user \
    --auth-password $password \
    --from $fromAddress \
    --to $toAddress \
    --ehlo $ehlo \
    --header $header \
    --body $body

Совет

Чтобы подключиться к SMTP-серверу через частную сеть, можно настроить управляемую частную конечную точку в собственной службе приватного канала для SMTP-сервера.

Настройка точек контактов Grafana и отправка тестового сообщения электронной почты

Настройка точек контактов Grafana выполняется на портале Grafana:

В рабочей области Azure Managed Grafana в разделе "Обзор" выберите URL-адрес конечной точки .
Переходите в раздел Точки контакта с оповещениями.
Выберите пункт "Создать контактную точку" или "Изменить контактную точку", чтобы обновить существующую точку контакта.
Добавьте или обновите Имя и тип контактной точки.
Введите целевое сообщение электронной почты в разделе "Адреса" и выберите " Тест".
Выберите Отправить тестовое уведомление, чтобы отправить уведомление с предопределенным тестовым сообщением, или выберите Настраиваемый, чтобы сначала изменить сообщение.
Отображается уведомление "Тестовое оповещение", что означает, что настройка электронной почты успешно настроена. Тестовое сообщение электронной почты отправлено на указанный адрес электронной почты. При неправильной настройке отображается сообщение об ошибке.

Отключение параметров SMTP

Чтобы отключить параметры SMTP, выполните следующие действия.

Портал
Azure CLI

В портале Azure перейдите в раздел "Конфигурация > Параметры электронной почты и отключите Параметры SMTP, чтобы отобразить Отключено.
Нажмите кнопку "Сохранить", чтобы проверить и начать обновление рабочей области Azure Managed Grafana.

Для отключения параметров SMTP требуется расширение CLI Azure Managed Grafana версии 1.1 или выше. Чтобы обновить расширение, выполните команду az extension update --name amg.

az grafana update --resource-group <resource-group> \
    --name <azure-managed-grafana-name> \
    --smtp disabled

Параметр	Пример	Описание
`--resource-group`	my-resource-group	Введите имя группы ресурсов рабочей области Azure Managed Grafana.
`--name`	моя-azure-управляемая-grafana	Введите имя рабочей области Azure Managed Grafana.
`--smtp`	disabled (выключено)	Введите disabled, чтобы отключить параметры SMTP.

Примечание.

Когда пользователи отключают параметры SMTP, все учетные данные SMTP удаляются из серверной части. Azure Managed Grafana не будет сохранять учетные данные SMTP при отключении.

Сообщения об ошибках оповещений Grafana

На портале Grafana можно найти список всех ошибок оповещений Grafana, возникших в уведомлениях об > сбоях оповещений.

Ниже приведены некоторые распространенные сообщения об ошибках, которые могут возникнуть:

"Сбой проверки подлинности: предоставленный грант авторизации недопустим, истек или отменен". Grafana не удалось подключиться к SMTP-серверу. Проверьте правильность пароля, введенного в параметрах SMTP в портал Azure.
"Не удалось отправить тестовое оповещение: SMTP не настроено". SMTP отключен. Откройте рабочую область Azure Managed Grafana в портал Azure и включите параметры SMTP.

Обратная связь

Были ли сведения на этой странице полезными?

Last updated on 2026-02-25