実行ログ

ワークフローの実行履歴を確認し、問題が発生した場合のデバッグに活用できます。

ログの確認

ワークフローエディター上部の「実行ログ」ボタンをクリックすると、過去の実行履歴がパネルに一覧表示されます。ログは 5 秒間隔で自動更新されます。

実行ステータス

各ワークフロー実行には以下のステータスがあります:

ステータス	説明
running	実行中
completed	正常完了
failed	エラーで失敗

ステップの詳細

各実行ログを展開すると、ノードごとの実行結果 (ステップ) を確認できます。

ステップ結果	説明	例
success	正常に実行	pass (14.5 >= -14) / ok
failed	実行失敗	rate limit exceeded
skipped	フィルターによりスキップ	stop (8.2 < -14)

ステップをクリックすると詳細ダイアログが表示され、以下の情報を確認できます:

• ステータス — success / failed / skipped
• 結果メッセージ — ノードの実行結果の詳細
• 開始時刻・終了時刻 — ステップの実行時間
• エラーメッセージ — 失敗時の原因 (日本語に翻訳済み)

よくあるエラーと対処法

Discord 通知の失敗

エラー	原因	対処法
Webhook URL が未設定	Discord Webhook URL が空	アクション設定で URL を入力
Discord API エラー (4xx)	URL が無効または Webhook が削除済み	Discord 側で Webhook を再作成し URL を更新
タイムアウト	Discord サーバーの応答遅延	時間を置いて再実行

メール通知の失敗

エラー	原因	対処法
RESEND_API_KEY が未設定	サーバー側の設定不足	管理者に連絡
宛先メールアドレスが不正	メールアドレスの形式エラー	アクション設定で正しいアドレスを入力

Webhook 送信の失敗

エラー	原因	対処法
URL が不正	https 以外の URL	https:// で始まる URL を指定
タイムアウト (15秒)	送信先サーバーの応答遅延	送信先の稼働状況を確認
HTTP エラー (4xx/5xx)	送信先サーバーのエラー	レスポンス内容を確認し、ボディ形式を修正

レート制限

エラー	原因	対処法
rate limit exceeded	1 日の実行回数上限に到達	翌日にリセットされるのを待つ。ワークフローの発火条件を見直して実行回数を削減

条件ノードのスキップ

条件ノードが skipped になっている場合、条件を満たさなかったことを意味します。これはエラーではなく、正常な動作です。

• 結果メッセージを確認 — stop (8.2 < -14) のように、実際の値と基準値が表示されます
• 意図した動作か確認 — 条件の閾値が正しいか、演算子の方向 (≧/≦) が正しいか確認してください

ラウドネス値が取得できない

トラックのアップロード直後はラウドネス解析が完了していない場合があります。ワークフローエンジンは最大 120 秒待機しますが、それでも取得できない場合はエラーになります。

ヒント

実行ログでエラーの原因を特定したら、ワークフローエディターでノードの設定を修正し、保存してください。次回のトリガー発火から修正された設定で実行されます。

ログの活用

ワークフローのデバッグ

1. 実行ログを開き、失敗した実行をクリック
2. 各ステップの結果を確認し、どのノードで失敗・スキップしたかを特定
3. 結果メッセージの実際の値を参考に、設定を修正

実行パターンの確認

定期的にログを確認し、以下を把握しましょう:

• レート制限の消費状況 — 1 日の上限に近づいていないか
• 条件ノードのスキップ率 — 条件の閾値が適切か
• IF 分岐の Yes/No 比率 — 分岐条件が期待通りに動作しているか