はじめに
この記事は「n8n学習シリーズ」のSTEP 08（エラー）です。失敗を想定し、検知・通知・再試行・隔離をフローに組み込みます。
学習の目標
- 再試行、バックオフ、デッドレターの考え方を説明できる
- ノード単位とワークフロー単位の失敗捕捉を使い分けられる
- 運用者が見るべきログとアラート粒度を決められる
前提知識
- STEP 03〜07（実フローを一度は本番相当で回したこと）
- HTTPステータスコードの4xx/5xxの違いをざっくり理解していること
用語ミニ辞典
- リトライ: 一時障害を想定した再実行
- デッドレター: 処理不能なメッセージを隔離して保管する先
- サーキットブレーカー: 連続失敗時に呼び出しを止めて被害を限定する考え方
ステップバイステップで進める
- 外部依存ごとに「一時障害／恒常障害」を分類し、リトライ回数と間隔を決める
- Error Triggerまたはノードの「On Error」で別経路へ分岐し、最低限の文脈を添えて通知する
- 通知文に実行ID、トリガー種別、直近ノード名を必ず含める
- 再実行が危険な処理（課金・二重登録）には冪等キーやロックの設計を検討する
- 週次でエラーログをレビューし、ノイズ通知の閾値を調整する
ミニ課題
意図的にHTTP 500を返すモックURLへRequestノードを向け、指数バックオフ付きで3回リトライ→失敗ならSlackへ詳細送付、というフローを紙面または下書きで設計してください。再試行ログを残すフィールド名も決めます。
理解度チェックリスト
- [ ] どの失敗がリトライ対象か説明できる
- [ ] 人が見る通知に十分な文脈がある
- [ ] 二重実行リスクを口頭で指摘できる
よくある落とし穴
- 無限リトライ: 相手サービスを攻撃しているのと同じになる
- 沈黙の失敗: 通知が多すぎて無視され、本番障害に気づかない
- 部分成功: 途中まで成功した状態を追跡しない
もう一歩掘り下げる
エラー設計は障害の心理学にも触れます。夜中に鳴るが不要なアラートは、やがて本当のアラートも見逃します。ビジネス影響度に応じて重大度を分け、週次で閾値を見直すループを回しましょう。
学びを固める（追補）
アラート疲労は「重大度の設計ミス」です。すべてをP1にすると、本当のP1が埋もれます。実行ID・トリガー種別・失敗ノード名の三点セットは通知の最低ラインとして固定しましょう。
シナリオ演習（15分）
過去の障害ログを1つ思い出し、「その時に欲しかった情報」を箇条書きで10個出して、現在のフローに盛り込めるか判定します。
今日の振り返り（3問）
- リトライ対象と非対象は言語化できたか。
- 再実行で二重課金／二重登録のリスクはないか。
- 週次のノイズ削減レビューを誰がするか。
深読みメモ（現場向け）
リトライ設計では、相手が冪等でない操作（課金、在庫引当など）を再実行していないかが最大の論点です。ここを曖昧にすると夜間ジョブが一番怖くなります。エラー通知にはスタックだけでなく、直前の入力サマリーと実行IDを添付し、朝のトリアージを楽にします。週次で「同じエラーが3回以上」集計し、根治チケット化する習慣があるチームが強いです。
自習リフレクション（読了後5分）
過去1ヶ月の障害を思い出し、「再試行すべきでなかった操作」を書き留めます。通知テンプレに足りないプレースホルダを3つ追加し、次回リリースで反映します。週次のノイズレビューをカレンダーに30分ブロックし、参加者を決めます。
クイック参照（紙に写す用）
冪等でない操作は安易にリトライしない。通知に実行ID・入力要約・ノード名。
週次ノイズレビュー。重大度を色分け。根治チケット化。
スタックだけ送らない。
読了後の一行メモ
この回の学びを140字以内で要約し、翌週の業務で一度だけ実践してみてください。音声メモに3分解説を録音し、未来の自分への手紙として残すと抜けが見えます。勉強会に使う場合はチェックリストを印刷して自己採点してから終えると定着します。公式ドキュメント・料金・UIは更新されるため、手順と数値は必ず最新情報で再確認してください。改善アクションは1つに絞ると実行率がもっとも高くなります。
連載を順に進めるときは「前章のチェックリストが緑になるまで次へ進まない」ペースが安全です。分からない用語はその場で検索せず、一度記録だけして後で3語に圧縮すると記憶に残ります。業務と学習の境目で迷ったら、公開情報とダミーデータだけで試すセーフティゾーンを先に決めてから触れてください。
次にやること
- STEP 09でバックアップ・監視・権限と合わせた運用Runbookを作る
- ステージング環境でカオス演習（意図的障害）を四半期1回入れる
ツール情報
- 公式サイト: n8n
- ツール概要: ノード設定とワークフロー設定の両方でエラー制御が可能（バージョンによりUI差異に注意）
権利表記
n8nは各社の商標または登録商標です。本記事は公式提供ではなく、一般的な情報提供を目的としています。
画像クレジット
サムネイル画像はUnsplashのライセンスに基づき使用しています。
お問い合わせ
AIツールの導入・活用支援のご相談はお気軽にどうぞ
📞 090-6262-3842