catalyst-signals

前提条件

Signals を使用する前に、コンソールでプロジェクトごとに一度だけ有効化してください。

コンソール → 対象のプロジェクト → Signals（左サイドバー）→ **「Start Exploring」**をクリック

この手順を省略すると、パブリッシャー、Webhook、ルール、ログにアクセスできません。プロジェクトごとに一度だけ有効化が必要です。

---

仕組み

1. コンソール専用サービス — ユーザーが SDK／API を想定している場合は、必ず利用を中止してください。 Catalyst Signals は Catalyst コンソールからのみ設定できます。パブリッシャー、ルール、Webhook を作成するための SDK、REST API、プログラムインターフェースはありません。すべての設定はコンソール UI から行います。

   • パブリッシャー、イベント、Webhook、ルールは「コンソール → Signals」で作成します
   • Functions と Circuits は「コンソール → Serverless」で別途作成し、Signals のルールでターゲットとして選択します
   • コードレベルで行う操作は、ターゲットの Functions／Circuits でイベントを受信することだけです

2. フローを理解する — パブリッシャー → イベント → ルール（フィルター／変換を含む）→ ターゲット（Webhook／Function／Circuit）

3. references/signals-basics.md を読み込む — パブリッシャー（Zoho／Catalyst／Custom）、イベント、ルール、ターゲット、ディスパッチポリシー、イベントステータス、デプロイ時の注意事項について説明しています

4. 主要な概念：

   • パブリッシャーは、アクションが発生するとイベントを送信します（3 種類：Zoho、Catalyst CloudScale、Custom）
   • イベントは、自動生成されるスキーマを持つ JSON ペイロードです（Zoho は最大 100KB、Custom は最大 64KB）
   • ルールは、オプションのフィルターやペイロード変換を使用して、パブリッシャーをターゲットに接続します
   • ターゲットは、Webhook、Functions、または Circuits 経由でイベントを受信します
   • ディスパッチポリシーはイベントの配信方法を制御します：Instant（デフォルト、即時）または Batch（件数／サイズ／スケジュール／属性ごと。TTL は 24h に固定）。「One-Time Dispatch」はポリシーではありません。Batch の条件が TTL の期限切れまでに満たされなかった場合に実行される、再試行なしのフォールバック配信です

5. デプロイに関する警告 — 本番環境ではルールがロックされ（有効化／無効化のみ可能）、すべてのルール変更は Development で行ってデプロイする必要があります。1 回のデプロイにつき、パブリッシャーは最大 25 個です。

セキュリティチェックリスト

• Custom パブリッシャーの REST API レート制限：1 分あたり 500 リクエストです。超過すると、API URL が 60 秒間ロックされます。
• 環境ごとに異なる REST API URL：Custom イベントの REST API URL は Development と Production で異なるため、デプロイ時に URL を更新してください。
• Function／Circuit のターゲットは、それぞれの権限を引き継ぎます：Function がターゲットの場合、設定されたスコープ（ユーザーまたは管理者）で実行されます。Signals が Function レベルの権限を上書きすることはありません。
• イベントペイロードのサイズ制限：Zoho パブリッシャーはイベントごとに最大 100KB（複数イベントのバッチでは 5MB）、Custom パブリッシャーはイベントごとに最大 64KB（最大 25 件のイベントでは 256KB）です。

トリガー

次のような内容には、このスキルを使用してください：「Signals」、「Catalyst event bus」、「event-driven architecture」、「publisher」、「Zoho publisher」、「Catalyst publisher」、「custom publisher」、「event schema」、「rule」、「event filter」、「event transformation」、「webhook target」、「dispatch policy」、「instant dispatch」、「one-time dispatch」、「scheduled dispatch」、「batch dispatch」、「event ordering」、「retry policy」、「TTL」、「event status」、「Signals logs」、「Signals dashboard」、「deploy Signals」、「Signals console」。

参考資料

参考資料	クエリが次の内容に関する場合に読み込む…
references/signals-basics.md	パブリッシャー（Zoho／Catalyst／Custom）、イベントとスキーマ、Custom イベントの REST API、ルールとフィルター、ターゲット（webhook／function／circuit）、ディスパッチポリシー（One-Time／Scheduled／Batching）、イベント変換、再試行ポリシー、イベントの順序、イベントステータス、ログ、ダッシュボード、デプロイ制限、本番環境での制限