dbt Cloud ジョブの失敗アラートと、開始されなかった実行
dbt Cloud のジョブが毎朝、ダッシュボードの元になるモデルをビルドしています。失敗はほかのジョブのアラートと一緒に Microsoft Teams やメールで受け取りたく、予定された実行が始まらなかったときにも知りたいところです。ここでは、dbt 自身の通知が現在何をしてくれるのか、そして外部の監視がまだ何を補えるのかを説明します。
dbt が自分で送るもの
ジョブ通知に関する dbt のドキュメント(2026年10月更新)には、メール、Slack、Microsoft Teams の 3 つのチャネルが挙げられています。どれも、実行が成功した、警告が出た、失敗した、キャンセルされたときに送るよう設定できます。知っておきたい制限がいくつかあります。
- Teams のメッセージは、連携している dbt ユーザーが参加しているチャネルにしか届きません。Slack は公開チャネルで使え、アカウントレベルの Slack 連携は 1 つのワークスペースにしか接続できません。
- それ以外の連携に使う Webhook は Starter、Enterprise、Enterprise+ プランで使え、実行の開始、完了、エラーのイベントがあります。
- これらはすべて実行についてのものです。予定された実行が始まらなかった場合、たとえば変更作業中にジョブのスケジュールをオフにしてそのまま戻し忘れた場合には、実行が生まれないので通知も送られません。これはドキュメントを読んだうえでの私たちの解釈です。行われなかった実行のイベントはありません。
つまり、失敗を Teams で受け取りたいだけなら、今は dbt だけでできます。足りないのは、実行されなかった実行、いつもよりずっと時間がかかる実行、そして dbt のアラートを周りの Python、Power BI、ファイルのジョブと同じ場所にまとめることです。
TaskBeacon で dbt Cloud のジョブを監視する
TaskBeacon の dbt Cloud 連携は、読み取り専用のサービストークンを使って、選んだ各ジョブの最新の実行を読み取ります。プロジェクトのコードを変更する必要はありません。dbt のジョブごとに:
- 成功した実行は、所要時間付きで OK になります。
- エラーになった、またはキャンセルされた実行は、dbt のステータスメッセージ付きで Failed(失敗)になります。
- 実行中の実行は Running(実行中)で、いつもよりずっと長くかかると Late(遅延)になります。
- TaskBeacon でジョブのスケジュールを dbt と同じに設定しておけば、始まらなかった実行は Missed(未実行)になります。
アラートはほかのすべてのジョブと同じ場所に届きます。メール(dbt アカウントの外にいる同僚にも)、Slack、Teams、Discord、Google Chat、ntfy、Webhook に、すぐに、または 1 日 1 回まとめて送れます。ドキュメントの dbt Cloud のページに、dbt のプランごとのトークンの権限が載っています。連携は Pro の機能で(現在は誰でも利用できます)、この連携はベータ版です。実際の環境ではまだ動かしていないので、結果をお知らせください。
実行は新しく、データは古い
成功した dbt の実行でも、古いソースデータからモデルをビルドしていることがあります。dbt 自身の答えはソースの freshness(dbt freshness で実行)で、loaded_at_field が error_after より古いと失敗します。これを定期ジョブのステップとして追加すれば、「古いデータ」のケースは失敗した実行になり、TaskBeacon がほかの失敗と同じように報告します。dbt の外で読み込まれるデータについては、データの鮮度チェックをご覧ください。
TaskBeacon を使わない場合
失敗とキャンセルについて、dbt の Teams 通知またはメール通知をオンにします。多くのチームでは、これで失敗した実行のケースはカバーできます。実行されなかった実行については、Webhook の受信側か小さな定期スクリプトで毎朝 dbt Cloud API を呼び出し、ジョブの最後の実行を確認して、想定より古ければアラートを出す方法があります。あるいはメインのジョブのあとに「カナリア」ジョブをつなぎ、dbt の外の仕組みでそれを待ち受けます。これもハートビートの考え方です。
Claude や ChatGPT を TaskBeacon に接続していますか?「昨夜失敗したのは何で、原因は?」と聞けば、あなたのジョブをもとに答えてくれます。その仕組みをご覧ください。
関連ページ
ドキュメント:dbt Cloud ジョブ · 連携 · スケジュール
- 日次のテーブルやファイルが新しいことを確認する「成功」したのに、昨日のデータをもう一度読み込んだだけの処理。
- チーム全員への Power BI 更新失敗の通知失敗のメールだけ、スケジュール更新だけ、テナント内だけ。
- ジョブの読み込みが 0 行、または通常よりはるかに少ないときにアラートを受け取る終了コード 0 は、何行届いたかについて何も語りません。
TaskBeacon は無料で始められます。現在はすべての機能が使え、クレジットカードも不要です。ジョブを作成してコードを貼り付ければ、最初の ping がジョブのページに表示されます。
無料で始める ライブデモを見る出典
- dbt docs: Job notifications(メール、Slack、Microsoft Teams) (2026年10月15日更新)
- dbt ドキュメント:ジョブの Webhook(Starter、Enterprise、Enterprise+ プラン) (2026年7月23日更新)
- dbt docs: freshness (2026年10月12日更新)
このページは 2026年11月9日 に出典と照合しました。他社製品のメニューや制限は変わります。ここに書かれていることが合わなくなっていたら、support@taskbeacon.io までお知らせください。