Уведомления о заданиях
Настройте уведомления в dbt platform, чтобы получать оповещения о результатах запуска задания. Вы можете выбрать один или несколько следующих результатов запуска, о которых хотите получать уведомления:
- Параметр Succeeds — запуск задания завершился успешно, без предупреждений и ошибок.
- Параметр Warns — при запуске задания возникли предупреждения от тестов данных или проверок актуальности источников.
- Это уведомление вызывается записями уровня предупреждения в журнале этих шагов, а не общим статусом запуска задания. Задание со статусом «success» в пользовательском интерфейсе всё равно может вызвать уведомление о предупреждении, если на шагах тестирования или проверки актуальности в журнал были записаны предупреждения.
- Параметр Fails — запуск задания не удалось завершить.
- Параметр Is canceled — запуск задания отменён.
- Уведомления в Slack могут не приходить для запусков, отменённых процессом очистки по тайм-ауту неактивности в dbt platform (этот процесс отменяет запуски, которые были неактивны в течение 10 минут). Чтобы получать уведомления об этих отменах, используйте уведомления по электронной почте или вебхуки.
Варианты уведомлений
В настоящее время dbt platform поддерживает следующие каналы уведомлений:
Если вы не можете использовать встроенную интеграцию с Microsoft Teams, вы всё равно можете отправлять уведомления о заданиях в канал Teams, указав адрес электронной почты канала в качестве внешнего адреса электронной почты, как описано в следующем разделе.
Уведомления по электронной почте
Вы можете получать оповещения по электронной почте о заданиях, настроив параметры уведомлений по электронной почте в dbt Cloud.
Вы можете получать оповещения о заданиях по электронной почте, настроив уведомления по электронной почте в dbt.
Предварительные требования
- Чтобы настроить уведомления по электронной почте в dbt, вы должны быть пользователем с лицензией разработчика, администратором аккаунта или иметь набор разрешений Notification Manager. Подробнее см. в разделе Пользователи и лицензии.
- Как пользователь с лицензией разработчика, вы можете настроить уведомления по электронной почте для себя.
После того как администратор аккаунта подключит приложение Slack, пользователи с лицензией смогут настроить уведомления о заданиях, если они входят в одну из следующих групп или имеют указанный набор разрешений:
- Стандартная группа Account Admin, Owner или Member
- Набор разрешений Notification Manager (Enterprise). Этот набор разрешений позволяет управлять уведомлениями во всех проектах без полного доступа администратора аккаунта
-
Выберите значок своего профиля, а затем нажмите Настройки уведомлений.
-
По умолчанию dbt Cloud отправляет уведомления на адрес электронной почты, указанный на вашей странице Профиль пользователя.
-
Нажмите значок своего профиля, а затем выберите Notification settings.
-
По умолчанию dbt отправляет уведомления на адрес электронной почты, указанный на странице User profile.
Если вы администратор аккаунта, вы можете выбрать другой адрес электронной почты для получения уведомлений:
- В разделе Job notifications нажмите раскрывающийся список Notification email.
- Выберите другой адрес из списка. Список включает Internal Users — пользователей с доступом к аккаунту — и External Emails — добавленные внешние адреса электронной почты.
- Чтобы добавить внешний адрес электронной почты, нажмите раскрывающийся список Notification email
- Нажмите Add external email.
- Введите адрес электронной почты и нажмите Add user.
После добавления внешний адрес электронной почты становится доступен для выбора в раскрывающемся списке Notification email. Внешними могут быть адреса, не связанные с вашим аккаунтом dbt, а также адреса для интеграций со сторонними сервисами, например каналами в Microsoft Teams и интеграцией PagerDuty через электронную почту.
примечание
Внешние адреса электронной почты и их настройки уведомлений сохраняются до тех пор, пока их не отредактируют или не удалят, даже если администратора, который их добавил, удалили из аккаунта.
-
Выберите Среду, для заданий которой вы хотите получать уведомления, из выпадающего списка.
-
Нажмите Изменить, чтобы настроить параметры уведомлений по электронной почте. Выберите один или несколько статусов выполнения для каждого задания, о которых вы хотите получать уведомления.
-
Когда вы закончите с настройками, нажмите Сохранить.
Как администратор аккаунта, вы можете добавить больше получателей электронной почты, выбрав другой Электронная почта для уведомлений из выпадающего списка, Изменить настройки уведомлений о заданиях и Сохранить изменения.
Чтобы настроить оповещения о заданиях из другой среды, выберите другую Среду из выпадающего списка, Изменить настройки уведомлений о заданиях и Сохранить изменения.
Отписка от уведомлений по электронной почте
- Нажмите на значок своего профиля и выберите Notification settings.
- На странице Email notifications нажмите Unsubscribe from all email notifications.
Отправка уведомлений о заданиях в канал Microsoft Teams (по электронной почте)
Вы можете отправлять уведомления о заданиях dbt по электронной почте непосредственно в канал Microsoft Teams, используя адрес электронной почты канала.
- В Microsoft Teams получите адрес электронной почты канала, в который хотите отправлять уведомления. См. Отправка сообщения электронной почты в канал.
- В dbt platform нажмите на свой профиль на левой боковой панели, а затем выберите Notification settings.
- В разделе Job notifications откройте раскрывающийся список Notification email.
- Чтобы добавить внешний адрес электронной почты, нажмите Add external email в нижней части раскрывающегося списка.
- Введите адрес электронной почты канала Teams и нажмите Add user.
- Убедитесь, что в раскрывающемся списке Notification email выбран адрес электронной почты канала Teams (возможно, он уже выбран).
- Затем выберите среду, об уведомлениях о заданиях которой вы хотите получать сообщения.
- Нажмите Edit и выберите нужные статусы заданий. Затем нажмите Save, чтобы сохранить настройки.
Уведомления в Slack (на уровне пользователя)
Вы можете получать в Slack оповещения о заданиях, настроив интеграцию со Slack, а затем параметры уведомлений Slack в dbt. dbt интегрируется со Slack через OAuth для обеспечения безопасной аутентификации.
Эта интеграция со Slack настраивается на уровне пользователя; её не следует путать с функцией уведомлений в Slack на уровне аккаунта.
Администраторы виртуальной частной сети (VPC) должны связаться с поддержкой для завершения интеграции с Slack.
Если произошли изменения в ролях пользователей или разрешениях Slack, из-за которых у вас больше нет доступа к редактированию настроенного канала Slack, пожалуйста, свяжитесь с поддержкой для получения помощи.
Предварительные требования
- У вас есть рабочее пространство Slack, в котором вы хотите получать уведомления о заданиях.
- Вы должны быть владельцем рабочего пространства Slack.
- Для настройки уведомлений Slack в dbt вы должны быть администратором аккаунта. Подробнее см. в разделе Пользователи и лицензии. На данный момент интеграция поддерживает только публичные каналы в рабочем пространстве Slack.
После того как администратор аккаунта подключит приложение Slack, пользователи с лицензией смогут настраивать уведомления о заданиях, если у них есть что-либо из следующего:
- Членство в одной из стандартных групп: Account Admin, Owner или Member
- Набор разрешений Notification Manager (Enterprise). Он позволяет управлять уведомлениями во всех проектах без полного доступа администратора аккаунта
Настройка интеграции с Slack
- Выберите Account settings, а затем — Integrations на левой боковой панели.
- Найдите раздел OAuth с приложением Slack и нажмите Link.
Если вы уже вошли в Slack
Если вы уже вошли в Slack, для установления соединения достаточно разрешить приложению доступ. Если вы состоите в нескольких рабочих пространствах, выберите нужное в раскрывающемся меню в правом верхнем углу.
Выход из системы
Если вы вышли из системы или приложение/веб-сайт Slack закрыты, вам необходимо пройти аутентификацию перед завершением интеграции.
- Заполните поле, указав рабочее пространство Slack, которое вы хотите интегрировать с dbt.
- Войдите с помощью существующей учётной записи или используйте адрес электронной почты и пароль.
- После успешной аутентификации предоставьте запрашиваемые разрешения.
Настройка уведомлений в Slack
-
Выберите значок своего профиля, а затем нажмите Настройки уведомлений.
-
Выберите Уведомления в Slack в левой боковой панели.
-
Выберите Канал уведомлений, из которого вы хотите получать уведомления о выполнении заданий, из выпадающего списка.
-
Выберите Среду, для заданий которой вы хотите получать уведомления, из выпадающего списка.
-
Нажмите Изменить, чтобы настроить параметры уведомлений в Slack. Выберите один или несколько статусов выполнения для каждого задания, о которых вы хотите получать уведомления.
-
Когда вы закончите с настройками, нажмите Сохранить.
Чтобы отправлять оповещения в другой канал Slack, выберите другой Канал уведомлений из выпадающего списка, Изменить настройки уведомлений о заданиях и Сохранить изменения.
Чтобы настроить оповещения о заданиях из другой среды, выберите другую Среду из выпадающего списка, Изменить настройки уведомлений о заданиях и Сохранить изменения.
-
Выберите Account settings и на странице Integrations прокрутите до раздела OAuth.
-
Нажмите значок X (справа от интеграции со Slack), затем нажмите Unlink. Настроенные вами каналы больше не будут получать уведомления в Slack. Это действие не распространяется на весь аккаунт. Каналы, настроенные другими администраторами аккаунта, продолжат получать уведомления в Slack, если у этих администраторов по-прежнему активны интеграции со Slack. Чтобы передать управление настройками уведомлений для канала Slack, попросите другого администратора аккаунта изменить свои настройки.
Уведомления в Slack (на уровне аккаунта)
Интегрируйте Slack с dbt platform на уровне аккаунта, чтобы получать уведомления о заданиях в Slack. dbt интегрируется со Slack через OAuth для безопасной аутентификации.
Один аккаунт dbt platform можно интегрировать с одним рабочим пространством Slack.
Предварительные требования
- У вас есть рабочее пространство Slack, в котором вы хотите получать уведомления о заданиях.
- Администратор аккаунта dbt platform должен подключить приложение Slack на уровне аккаунта.
- Установите официальное приложение dbt platform для Slack, выполнив действия, описанные в следующем разделе.
- Для установки приложения Slack в рабочее пространство в вашей организации Slack должна быть разрешена установка приложений. В некоторых организациях для этого требуется одобрение администратора Slack.
- На данный момент интеграция поддерживает только общедоступные каналы рабочего пространства Slack.
После того как администратор аккаунта подключит приложение Slack, пользователи с лицензиями смогут настраивать уведомления о заданиях, если им назначено что-либо из следующего:
- Стандартная группа Account Admin, Owner или Member
- Набор разрешений Notification Manager (Enterprise). Это разрешение позволяет управлять уведомлениями во всех проектах без полного доступа уровня Account Admin
Пользователи с лицензиями IT могут получать уведомления о заданиях, но не могут настраивать их. Подключать и отключать рабочее пространство Slack могут только пользователи с ролью Account Admin.
Настройка интеграции со Slack
Интеграция со Slack на уровне аккаунта использует официальное приложение dbt platform для Slack, которое отличается от интеграции со Slack на уровне пользователя.
Чтобы использовать уведомления в Slack, необходимо отключить старое приложение Slack, а затем подключить официальное приложение:
- Перейдите в Account settings > Integrations > OAuth.
- Нажмите значок X рядом со Slack и выберите Unlink.
- В том же разделе OAuth нажмите Link, чтобы подключить официальное приложение Slack.
Пока вы этого не сделаете, вариант интеграции со Slack на уровне аккаунта не появится.
Если вы уже вошли в Slack
Если вы уже вошли в Slack, для интеграции достаточно предоставить приложению доступ. Если вы состоите в нескольких рабочих пространствах, выберите нужное в раскрывающемся меню в правом верхнем углу.
Если вы не вошли в Slack
Если вы вышли из Slack или приложение либо сайт Slack закрыты, перед завершением интеграции необходимо пройти аутентификацию.
-
Заполните поле, указав рабочее пространство Slack, которое вы хотите интегрировать с dbt.
-
Войдите с помощью существующей учётной записи или используйте адрес электронной почты и пароль.
-
После успешной аутентификации предоставьте запрашиваемые разрешения.
Настройка уведомлений в Slack
Настройте канал Slack, в котором вы хотите получать уведомления о заданиях.
- Нажмите значок своего профиля, затем выберите Notification settings.
- Выберите Slack notifications на левой боковой панели.
- В первом раскрывающемся списке выберите Notification channel — канал, в котором вы хотите получать уведомления о запусках заданий.
- Во втором раскрывающемся списке выберите Environment — окружение для заданий, о которых вы хотите получать уведомления.
- Нажмите Edit, чтобы настроить уведомления в Slack. Выберите один или несколько статусов запуска для каждого задания, о котором хотите получать уведомления.
- Завершив настройку, нажмите Save.
- Чтобы отправлять оповещения в другой канал Slack, выберите другой Notification channel в раскрывающемся списке, нажмите Edit, настройте уведомления о заданиях и сохраните изменения кнопкой Save.
- Чтобы настроить оповещения о заданиях из другого окружения, выберите другое Environment в раскрывающемся списке, нажмите Edit, настройте уведомления о заданиях и сохраните изменения кнопкой Save.
Готово! Теперь ваш канал Slack настроен для получения уведомлений о заданиях dbt на уровне аккаунта. Эта интеграция доступна во всём аккаунте для всех пользователей с лицензиями.
Перенос устаревших настроек уведомлений в Slack
Если вы ранее настроили уведомления в Slack с помощью устаревшей интеграции, на странице Slack notifications может появиться баннер переноса настроек.
Баннер появляется, когда выполняются все следующие условия:
- У вас есть настройки уведомлений от предыдущей интеграции со Slack.
- Ваш аккаунт подключён к приложению dbt platform.
- Вы ещё не настроили уведомления в Slack с помощью приложения dbt platform.
Перед переносом необходимо отключить устаревшую интеграцию со Slack и подключить приложение dbt platform. Отключение устаревшей интеграции выполняется вручную; одновременно может быть подключено только одно приложение Slack.
Приложение dbt platform для Slack отправляет уведомления о заданиях только в общедоступные каналы вашего рабочего пространства. Закрытые каналы не поддерживаются.
-
Нажмите Migrate settings, чтобы скопировать существующие настройки в приложение dbt platform, включая:
- Выбранные Notification channel и Environment
- Выбранные задания
- Состояния переключателей уведомлений (например, Succeeds, Warns, Fails и Is canceled)
-
Нажмите Dismiss, чтобы скрыть баннер на время текущего сеанса — он будет появляться снова при перезагрузке страницы, пока перенос не будет завершён.
После успешного переноса dbt скроет баннер и обновит ваши настройки уведомлений в Slack. Если перенос завершится ошибкой, баннер останется, чтобы вы могли повторить попытку.
Отключение интеграции со Slack
На этом шаге вы отключите интеграцию со Slack и удалите учётные данные Slack на уровне аккаунта. Вы всегда можете снова включить интеграцию, выполнив действия из раздела Настройка интеграции со Slack.
- Выберите Account settings и на странице Integrations прокрутите до раздела OAuth.
- Нажмите значок X (справа от интеграции со Slack), затем нажмите Unlink.
- Это удалит учётные данные Slack на уровне аккаунта. Отправка всех уведомлений в Slack, использующих интеграцию на уровне аккаунта, прекратится.
- Если остались устаревшие интеграции со Slack на уровне пользователя, отправка соответствующих уведомлений может продолжаться до отключения этих интеграций. Мы рекомендуем перейти на новое приложение, работающее на уровне аккаунта, и отключить устаревшие подключения.
Уведомления в Microsoft Teams
Вы можете получать оповещения о заданиях dbt в Microsoft Teams, подключив свою учётную запись Teams к dbt platform и настроив параметры уведомлений.
dbt интегрируется с Teams через Microsoft Entra для безопасной аутентификации при подключении Teams и настройке уведомлений.
Предварительные требования
Прежде чем начать:
- У вас должен быть аккаунт dbt platform
- У вас есть учётная запись Microsoft Teams, в которой вы хотите получать уведомления о заданиях.
- Убедитесь, что у вас есть разрешение на просмотр страниц Account integrations и Job notifications в dbt platform.
После того как администратор аккаунта подключит приложение Microsoft Teams, пользователи с лицензиями смогут настраивать уведомления о заданиях, если им назначено что-либо из следующего:
- Стандартная группа Account Admin, Owner или Member
- Набор разрешений Notification Manager (Enterprise). Это разрешение позволяет управлять уведомлениями во всех проектах без полного доступа уровня Account Admin
Настройка Microsoft Teams
Чтобы включить уведомления о заданиях в Microsoft Teams, выполните действия из следующих разделов:
- Подключение аккаунта dbt platform к Teams — подключение на уровне пользователя, которое связывает отдельную учётную запись dbt platform (или выделенную служебную учётную запись) с профилем пользователя Microsoft Teams в вашем клиенте.
- Настройка уведомлений в Teams — настройка каналов Teams, в которые будут поступать уведомления о заданиях.
- Отключение интеграции с Teams (необязательно) — удаление или сброс подключения между dbt platform и Microsoft Teams.
Подключение аккаунта dbt platform к Teams
Вы можете подключить любую учётную запись пользователя Teams из своего клиента, но мы рекомендуем создать отдельную учётную запись исключительно для публикации уведомлений dbt. В процессе OAuth вам потребуется войти в учётную запись Microsoft, чтобы завершить интеграцию.
- Если вы вошли только в одну учётную запись Microsoft, интеграция завершится автоматически.
- Если вы вошли в несколько учётных записей (или не вошли ни в одну), вам предложат выбрать учётную запись или войти в неё.
Чтобы подключить аккаунт dbt platform к Microsoft Teams:
- В dbt platform перейдите на страницу Account settings, нажав на название своего аккаунта и выбрав Account settings.
- На левой боковой панели выберите Integrations.
- Прокрутите до раздела OAuth.
- Рядом с Teams нажмите кнопку Link.
- После этого вам предложат выбрать учётную запись Microsoft перед завершением настройки либо вы сразу вернётесь в dbt platform с подключённым профилем Teams.
- Теперь ваш аккаунт dbt platform подключён к Microsoft Teams!
Теперь dbt добавит приложение dbt-cloud-integration в ваш клиент Microsoft Entra. Это приложение обеспечивает безопасное управление запросами аутентификации и разрешениями.
- Текущие разрешения приложения Entra:
profileopenidoffline_accessTeam.ReadBasic.AllTeamsActivity.SendChannelMessage.SendChannelMessage.Read.AllChannel.ReadBasic.All
Приложение dbt-cloud-integration — это мультитенантное приложение Microsoft Entra, которое уже принадлежит dbt Labs. Вам не нужно ничего предварительно регистрировать в своём клиенте. Предоставление согласия при выполнении Link регистрирует приложение в вашем клиенте как корпоративное приложение (Enterprise Application). Такой же механизм используют другие мультитенантные SaaS-приложения, например Slack или Zoom.
Устранение неполадок при подключении Teams
Если процесс Link завершается ошибкой AADSTS90094: Admin consent is required, в вашем клиенте Microsoft Entra ограничена возможность предоставления пользователями согласия для сторонних приложений.
Чтобы устранить эту проблему, попросите администратора Entra (Cloud Application Administrator или Global Administrator) выполнить одно из следующих действий:
- Самостоятельно выполнить шаг Link и подтвердить запрос согласия.
- Предоставить согласие администратора для приложения
dbt-cloud-integrationв разделе Enterprise applications центра администрирования Entra.
После предоставления согласия администратора повторите процесс Link в dbt platform. Дополнительную информацию см. в документации Microsoft.
Настройка уведомлений в Teams
После подключения dbt platform к Teams вы можете настроить, в какие каналы Teams будут поступать уведомления о заданиях. Для доступа к меню Teams notifications в аккаунте должна быть активна интеграция с Teams.
В настоящее время dbt отправляет уведомления только в те каналы Teams (стандартные, общие или частные), в которых вы состоите.
- В dbt platform нажмите значок своего профиля и выберите Notification settings.
- Выберите Teams notifications на левой боковой панели.
- В первом раскрывающемся списке выберите Notification team — команду, в которую вы хотите отправлять уведомления.
- Во втором раскрывающемся списке выберите Notification channel — канал, в который вы хотите отправлять уведомления.
- dbt platform отправляет уведомления только в те каналы Teams (стандартные, общие или частные), в которых состоите вы.
- В раскрывающемся списке выберите окружение для заданий, о которых вы хотите получать уведомления.
- Нажмите Edit в правом верхнем углу, чтобы настроить уведомления о заданиях в Teams и выбрать статусы заданий, при которых отправляются уведомления.
- Завершив настройку, нажмите Save.
Теперь ваш канал Teams настроен для получения уведомлений о заданиях dbt!
Отключение интеграции с Teams
При отключении и удалении подключения интеграции с Teams в dbt platform она удаляется для всего аккаунта. Чтобы отключить её:
- В dbt platform перейдите в Account settings.
- Нажмите Integrations и прокрутите вниз до OAuth.
- Справа от интеграции Teams нажмите значок X.
- Подтвердите отключение, выбрав Unlink.
Интеграция с Teams отключена. Вы всегда можете снова включить её, выполнив действия из раздела Настройка Microsoft Teams.











