自動化ルールが実行されるたびに、Mateflow は実行ログ(自動化の履歴、実行履歴)に記録します。テストとログを使って、ルールが期待どおりに動くかを確認し、実行が失敗またはスキップされた理由を調べ、もう一度実行できます。
対象者:オーナーと管理者。モデレーターには自動化は表示されません。 · 場所:ウェブ(管理画面)。 · プラン:自動化を使えるかどうかは、プラットフォームプランによって異なります。
有効にする前に自動化ルールをテストする
新しいルールはオフの状態で保存されるため、先にテストできます。ルールのページ、または保存前のフォームでルールをテストをクリックします。テストはドライランです。トリガーと条件をチェックしてテキストを生成しますが、アクションは一切実行しません。
- トリガーデータで、サンプルデータか、コミュニティの直近の実際のイベントを選びます。
- 必要に応じてメンバー(任意) を選びます。ポイント、タグ、参加からの日数などのメンバーの条件は、その人に対してチェックされます。サンプルデータでメンバーを選ばない場合、これらの条件は成立しません。
- ルールをテストをクリックします。
結果はルールの図に表示されます。各条件に成立または不成立が表示され、実行されないアクションには実行されませんと表示されます。テストでは実行頻度は無視されるため、すでにルールが実行されたメンバーでもテストは成立することがあります。この理由で実際のイベントではルールが実行されない場合は、結果の上部にその旨と、ルールが実行された日時が表示されます。
自動化ルールを今すぐ実行する
ルールのページの今すぐ実行は、ルールを実際に実行します。メンバーを選ぶとその人がトリガーしたものとして実行され、空欄のままにするとサンプルデータが使われます。通知、ポイント、タグ、スペースの変更、Webhook が実際に発生します。
メンバーを選ばない場合は、実行前にトリガーデータのJSONを確認します。{}などのオブジェクトが必要で、配列、null、単一の値は使えません。実行がキューに入ると、利用可能であればログが開きます。イベントのライフサイクルトリガーは即時実行できません。
自動化の実行ログを開く
管理画面 → 自動化 → 実行ログに移動します。このページには、すべてのルールの実行が新しい順に表示されます。各行には、日時、ルール、メンバー、実行を開始したトリガー、ステータスが表示されます。1 つのルールの実行だけを見るには、管理画面 → 自動化 → ルールからそのルールを開きます。
上部の概要には、過去 24 時間、過去 7 日間、過去 30 日間の実行数、成功率、所要時間と、実行数の推移、失敗、種類別のエラーが表示されます。実行の多いルールやエラーの多いルールの下にあるルールをクリックすると、そのルールが開きます。
実行ログは 30 日間保持されます。実行中の実行と、遅延アクションを待っている実行は削除されません。
自動化の実行ログを絞り込む
- ルール名またはトリガーで検索。
- すべてのルール:1 つのルールを選びます。
- すべてのメンバー:メンバーを選びます。たとえば、ある人にウェルカム通知が届かなかった理由を調べるときに使います。
- ステータスと日付の範囲。
- テストのログを含める:テストの実行は、これをオンにしない限り表示されません。テストの実行にはテストのラベルが付きます。
クリアをクリックすると、すべての一覧に戻ります。古い実行を見るには、下部のさらに読み込むをクリックします。
自動化の実行ステータスの意味
| ステータス | 意味 |
|---|---|
| 成功 | すべてのアクションが実行されました。 |
| 一部失敗 | 一部のアクションは実行されましたが、少なくとも 1 つが失敗しました。 |
| 失敗 | 実行が失敗しました。 |
| スキップ | 条件を満たさなかったなどの理由で、ルールが何も実行しませんでした。 |
| 保留中 | 実行はキューに入っています。 |
| 実行中 | 実行中です。遅延アクションを含む実行は、最後のアクションが実行されるまでこの状態のままです。 |
スキップの実行では、ログの詳細にスキップの理由(条件を満たしていません、ご利用のプランに自動化が含まれていないため、ルールは一時停止中ですなど)が表示されます。スマートフォンのブラウザでは、行にも表示されます。
イベントが自動化ログに記録されない理由
Mateflow は、ルールが無視したイベントをすべて記録するわけではありません。そのため、ルールがオンでも、メンバーがログに表示されないことがあります。次の場合は記録が残りません。
- イベントが、スペース、イベント、ポイントのしきい値など、ルールのトリガー設定に一致しない場合。
- イベントがトリガーのスペースまたはコンテンツの種類の条件を満たさない場合。
- ルールがメンバーごとに 1 回または1 回のみに設定されていて、その実行をすでに使っている場合。以前の成功の実行を探すか、そのメンバーでルールをテストしてください。
タグ、ポイント、参加からの日数など、メンバーに関する条件では、スキップの実行が記録されます。
自動化の実行の詳細を見る
行をクリックすると、ログの詳細が開きます。表示される内容は次のとおりです。
- メンバーと、実行の対象になったもの(投稿、イベント、コースなど)。
- 次の場合のみ(条件):各条件と、成立または不成立、実際の値。1 つが不成立になると、残りの条件には判定していません(前の条件が不成立) と表示されます。
- トリガーのデータとアクションの結果。送信した人数(「N 人に送信」)と、遅延アクションの実行予定(「日時 に実行予定」)も表示されます。
- 所要時間と、失敗した実行の場合はエラーメッセージ、失敗した段階、失敗した各アクションのエラーコード。
よくあるエラーコードには、タイムアウト、リクエストが拒否されました(4xx)、サーバーエラー(5xx)、対象が見つかりません、対象のメンバーがいません、このコミュニティではポイントがオフになっています、コースが満員ですがあります。遅延アクションの待機中にルールが変更された場合は、待機中にルールが編集されましたと表示されます。
失敗した自動化を再実行する
失敗したアクションは自動では再試行されないため、失敗と一部失敗の実行はログの詳細から再実行できます。テストの実行は再実行できません。
- 失敗したアクションを再実行:失敗したアクションだけを、遅延なしですぐにもう一度実行します。
- ルール全体を再実行:元のトリガーのデータで、すべてのアクションをもう一度実行します。通知と Webhook は再送されますが、すでに付与したポイントが二重に付与されることはありません。
「この実行を再実行しますか?」で確定します。再実行をキューに追加しましたと表示され、新しい実行には以前の実行の再実行の印が付きます。先に、ルールの設定や Webhook のアドレスなど、原因を修正してください。ルールが 5 回連続で失敗すると、オーナーと管理者に通知が届きます。ルールは、オフにするまでオンのままです。ルールでタスクを自動化するを参照してください。
ルールが変更された場合や、古いログに必要なアクション履歴がない場合、一部のみの再実行は拒否されることがあります。メッセージを再送する可能性があるため、全体を再実行する前に現在のルールを確認します。日付フィルターはUTCの日境界です。所要時間には遅延待機を含み、時間とエラーの内訳は件数制限付きのサンプルに基づく場合があります。
スキップされた自動化の実行を後追いで実行する
プランや条件のためにスキップされた実行は、あとから実行できます。たとえば、アップグレードしたあとや、メンバーに足りなかったタグを追加したあとです。実行をクリックしてログの詳細を開き、後追い実行をクリックして、この実行を後追いで実行しますか? で確定します。テスト実行は後追いできません。
イベントは元のトリガーデータで今すぐ実行されます。条件がもう一度確認され、満たしていればアクションが実行されます。実行頻度は引き続き適用されるため、ルールがその実行をすでに使っている場合は、エラーが表示され、何も送信されません。
イベントのライフサイクル実行を補完するときは、現在の予定、ルール、アクセス権、対象者、通知設定を再確認します。期限切れの通知を強制送信したり、同時刻の個人リマインダーを無視したりはできません。
自動化ログでメール配信を確認する
メールアクションにはルールの実行結果とは別に配信状態があります。サービス受付済みは配信完了ではありません。詳細で宛先、試行回数、結果を確認し、待機中や結果不明の場合は更新します。再実行でも受付済みメールは再送信されません。サービスが再試行可能と確認した場合だけ復旧操作が表示されます。先に原因を解決してください。自動化でマーケティングメールを送信するを参照してください。
関連記事
このガイドは役に立ちましたか?