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

Статья
10/13/2023

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

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

Необходимые компоненты

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

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

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

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

Портал
Azure CLI

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

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

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

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

Для включения или обновления параметров SMTP требуется расширение CLI управляемой 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> \

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

Совет

Ниже приведены некоторые советы по правильной настройке SMTP:

При использовании учетной записи электронной почты бизнеса, такой как Office 365, может потребоваться обратиться к администратору электронной почты, чтобы включить SMTP AUTH (например, включить smtp-auth-for-specific-mailboxes). После этого вы сможете создать пароль приложения и использовать его в качестве параметра пароля SMTP.
При использовании личной учетной записи электронной почты, например Outlook или Gmail, необходимо создать пароль приложения и использовать его в качестве параметра пароля SMTP. Обратите внимание, что ваша учетная запись не будет работать для уведомлений по электронной почте, если она настроена с многофакторной проверкой подлинности.

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

# fill in all the empty values for the following parameters
host="" # SMTP host name with port separated by a ":", e.g. smtp.office365.com:587
user="" # email address, e.g. team1@microsoft.com
password="" # password
fromAddress="" # source email address (usually the same as user above), e.g. team1@contoso.com
toAddress="" # destination email address, e.g. team2@contoso.com
ehlo="" # grafana endpoint, e.g. team1-ftbghja6ekeybng8.wcus.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

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

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

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

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

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

Портал
Azure CLI

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

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

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

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

Примечание.

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

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

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

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

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

Следующие шаги

В этом руководстве вы узнали, как настроить параметры SMTP Grafana. Сведения о создании отчетов и их отправке по электронной почте получателям см. в статье "Создание панелей мониторинга".