本文へ移動
ドキュメント一覧

検出の種類

各シグナルの意味と、最初に見るところ。

検出結果はどう作られるか

判定はすべて、そのワークフロー自身の実行履歴から学習した基準に照らして行います。ほかのワークフローや、ほかのお客様のデータと比べることはありません。検出結果には次の 5 つが付きます。シグナルの種類、根拠の行、時刻、0〜1 の確信度、そして 1 文の理由です。

統計的な判定に必要な実行回数が足りないワークフローは「データ不足」と報告します。これは判定の抜けではなく、1 つの答えです。データ 2 件で出した異常はただの雑音で、雑音が続くと人は監視を見なくなります。

はっきりした障害

FAILED
実行がエラー、クラッシュ、キャンセルで終わりました。根拠は実行の ID、失敗したノード、秘密情報を取り除いたエラーメッセージです。まず根拠に出ているノードを確認してください。
AUTH_ERROR
認証情報が拒否されました。OAuth トークンの期限切れ、API キーの失効、パスワード変更などです。コネクタが HTTP ステータスを受け取っていれば、根拠に含めます。n8n 側で認証情報を再認証してください。
DOWNSTREAM_ERROR
ワークフローが頼っている外部サービスが失敗したか、リクエストを拒否しました。一時的なことが多く、繰り返す場合は利用上限、仕様変更、IP 制限が原因になりやすいです。

静かな障害

SILENT_FAILURE
エラーなし、仕事もなし。定期的に動いていたトリガーが静かになった場合、または成功した実行がいつもより手前のノードで終わるようになった場合に出します。根拠の最後のノードと、本来仕事を終えるノードを見比べてください。
MISSED_RUN
予定された実行が行われていません。cron と間隔指定はタイムゾーン込みで読み、猶予時間をおいてから判定します。根拠には想定時刻と実際の最終実行が入ります。ワークフローが有効か、タイムゾーンと cron 式が一致しているかを確認してください。
EMPTY_OUTPUT
成功したのに 0 件でした。普段は件数が出ているワークフローに限って出します。実行をたどり、件数が 0 になるノードを探してください。フィルタ、クエリのパラメータ、変わったフィールド名が原因になりやすいです。
STALE_OUTPUT
届け先の確認で、Outcome Contract で許容した時間を超えて連携先が更新されていないことが分かりました。ワークフローは正常に動いたまま、別の場所へ書き込んでいる可能性があります。

統計的な異常

VOLUME_ANOMALY
実行回数、または 1 回あたりの件数が、そのワークフローの普段の範囲から大きく外れています。半分しか入っていない取り込みを拾います。空よりも気づきにくい障害です。
LATENCY_ANOMALY
所要時間が普段から大きく外れています。長すぎる場合は連携先の応答が遅くなっていることが多く、短すぎる場合は何も運んでいないことが多いです。

どちらも、普段の範囲を決められるだけの履歴が必要です。それまでは出さず、ワークフローは「データ不足」の一覧に並びます。

設定と可用性

CONFIG_DRIFT
ワークフローの定義が変わった、または非アクティブになりました。根拠に変更前後の定義のハッシュと、有効かどうかが入ります。「前は動いていた」の多くはここから始まります。
OUTCOME_FAILED
実行はされましたが、Outcome Contract のルールを 1 つ以上満たしていません。根拠には満たさなかったルールごとの理由が入るので、期限、件数、所要時間、届け先の確認のどれだったかが分かります。
UNKNOWN
インスタンスに接続できないため、そのワークフローは判定していません。応答がないことを正常とはみなしません。

重大度と自動対応

シグナルには重大度(情報・警告・重大)と、OutcomeGuard が自分でどこまでやってよいかを示す区分が付きます。

AUTO_SAFE
確認せずに実行してよい範囲。当社側のチェックのやり直し、通知の再送、検証の再実行。
AUTO_WITH_GUARD
自動で対応できますが、条件を満たすときだけ実行し、設定した試行回数を超えません。
DO_NOT_AUTO
人の判断が必要です。OutcomeGuard は報告してそこで止まります。

どの区分でも、ワークフロー、認証情報、設定を OutcomeGuard が変更することは許していません。この線は変えません。