ワークフロー失敗通知
ワークフロー失敗通知は、ワークフローの実行が失敗した際に自動的にメールアラートを送信し、チームが問題を迅速に把握し対応するのに役立ちます。通知はデフォルトでワークフローのオーナーに送信され、ワークフローごとに受信者を追加することもできます。
前提条件
- チームに対して SMTP が設定されている必要があります（オンプレミスのみ）
- チームレベルでワークフロー失敗通知が有効になっている必要があります
- 受信者はワークフローのプロジェクトのメンバーである必要があります
アクセス要件
| アクション | 必要なアクセス権 |
|---|---|
| チームの通知を有効または無効にする | チーム管理者 |
| ワークフローの追加受信者を設定する | ワークフローへのアクセス + プロジェクトメンバーシップ |
セットアップ
ステップ 1 — チームの通知を有効にする
メールが送信される前に、チーム管理者がワークフロー失敗通知を有効にする必要があります。
- チーム設定を開く
My Account → Settings に移動します。
- 通知を有効にする
Enable Email Notification を見つけ、トグルをオンにします。
- 保存する
設定を保存します。
有効にすると、ワークフローのオーナーはワークフローが失敗した際に自動的にメール通知を受け取ります — 追加の設定は不要です。
ステップ 2 — 追加の受信者を設定する（オプション）
ワークフローのオーナーは、個々のワークフローに受信者を追加できます。
- ワークフローを開く
設定したいワークフローに移動します。
- 失敗通知を開く
ケバブメニュー（⋯） をクリックし、Failure Notifications を選択します。
- 受信者を追加する
受信者のドロップダウンを使用して追加ユーザーを選択し、設定を保存します。
失敗通知モーダル
Failure Notifications から開くモーダルには、以下のコンポーネントが含まれます：
| コンポーネント | 説明 |
|---|---|
| Notify Workflow Owner トグル | ワークフローのオーナーへの通知を有効または無効にする |
| Owner email | ワークフローのオーナーのメールアドレスを表示 |
| Additional recipients dropdown | 追加の受信者を追加するための複数選択ドロップダウン |
| Warning banner | チームレベルの通知が無効な場合に表示 |
受信者のルール
- プロジェクトメンバーのみを受信者として選択できます
- 重複通知を避けるため、ワークフローのオーナーはドロップダウンから自動的に除外されます
- 複数の受信者を同時に選択できます
- 受信者リストは現在のチームにスコープされます
モーダルに警告バナーが表示される場合は、チームレベルの通知が無効です。通知が送信される前に、チーム管理者が My Account → Settings → Enable Email Notification から有効にする必要があります。
通知の仕組み
ワークフローの実行が失敗した場合：
- システムが失敗を検知します
- 受信者が解決されます — ワークフローのオーナーと設定された追加の受信者
- 解決されたすべての受信者にメール通知が送信されます
ベストプラクティス
- 積極的に監視されているチームのみに通知を有効にする
- 関係する関係者のみを受信者として追加します — 受信者が多いとアラート疲れにつながります
- 特にチームのメンバーシップに変更があった後に、受信者リストを定期的に確認します
- 組織のスパムフィルターが通知メールをブロックしていないことを確認します
- SMTP の設定が引き続き有効であることを確認します
トラブルシューティング
ユーザーが受信者ドロップダウンに表示されない
そのユーザーはワークフローのプロジェクトのメンバーではありません。プロジェクトに追加して再試行してください。
モーダルに警告バナーが表示される
チームレベルの通知が無効です。チーム管理者が My Account → Settings → Enable Email Notification から有効にする必要があります。
失敗後にメールが届かない
以下を確認してください：
- SMTP が設定され、アクティブであること
- チームレベルの通知が有効であること
- 受信者のメールアドレスが有効であること
- アプリケーションログにメール配信エラーがないこと
- 組織のスパムフィルターが通知メールをブロックしていないこと