Solace: キュー内の新規メッセージバッチトリガー
キュー内の新規メッセージバッチトリガーは、新しいメッセージのバッチについてSolaceキューを監視します。トリガーは、指定したバッチサイズに達するかバッチタイムアウトが経過するまでメッセージをバッファリングし、先に満たされた条件で起動します。
オンプレミスエージェントのバージョン
このトリガーには、オンプレミスエージェントバージョン34以降が必要です。以前のバージョンからエージェントを更新するには、Upgrade your agentを参照してください。
入力
| 入力フィールド | 説明 |
|---|---|
| キュー名 | 監視するSolaceキューを選択します。 |
| メッセージ形式 | メッセージ形式を選択します。オプションにはBinaryとTextがあります。 |
| バッチサイズ | 任意。 1回のトリガーイベントにまとめるメッセージの最大数を入力します。最小値は1、最大値は1000です。デフォルトは10です。 |
| バッチタイムアウト (ms) | 任意。指定したバッチサイズより小さいバッチからトリガーするまで待機する最大ミリ秒数を入力します。最小値は1、最大値は300,000です。デフォルトは30,000です。 |
| 手動確認応答 | 任意。レシピがAcknowledge messageアクションでバッチ全体を確定するまで、ブローカー上でそのバッチ全体を未アクノリッジのまま保持するかどうかを選択します。このアクションは、バッチ内のすべてのメッセージを1つの単位として受理、失敗、または拒否します。デフォルトはNoで、この場合、バッチは自動的に受け入れられ、レシピジョブが後で失敗しても、キューからそのバッチ内のすべてのメッセージが完全に削除されます。ジョブは保持されており再実行できますが、ブローカーはそのバッチ内のメッセージを再配信しません。 |
| 確認応答タイムアウト(ms) | 任意。ブローカーがAcknowledge messageアクションによるバッチの確定をあきらめるまで待機するミリ秒数を入力します。レシピがこの時間内に確認を完了しない場合、Solaceはバッチ全体を失敗として扱い、その中のすべてのメッセージを再配信し、重複ジョブを生成し、元の確認試行を失敗としてマークします。デフォルトは60,000です。 |
| 保留中の確認の最大数 | 任意。エージェントがキューからのメッセージ取得を停止する前に、同時に未確認のまま保持できるバッチの最大数を入力します。 Manual acknowledgementモードでのみ有効です。レシピのConcurrency値と同じか、レシピがジョブの完了前にバッチを確認する場合はそれより小さい値を設定します。値を高くすると、スループットは増えない一方で、メモリ使用量と確認タイムアウト発生の可能性が高まります。デフォルトは5です。 |
| 追加サブスクリプションプロパティ | 任意。 Add parameterをクリックして、このサブスクリプション専用の追加Solaceセッションプロパティを渡します。これにより、コネクションのAdditional connection propertiesセクションで設定された同名の値が上書きされます。 |
出力
| 出力フィールド | 説明 |
|---|---|
| 確認応答ハンドル | バッチ全体を手動でアクノリッジするための、不透明な識別ハンドルです。バッチ内のすべてのメッセージを確定するために、このハンドルをAcknowledge messageアクションのAcknowledgement handleフィールドに渡します。 |
| 手動確認応答 | このトリガーで使用される手動確認応答設定。 |
| メッセージ数 | バッチ内のメッセージ数。 |
| メッセージ | バッチ内のメッセージ。各メッセージには、Messagesに記載されているフィールドが含まれます。 |
メッセージ
| 出力フィールド | 説明 |
|---|---|
| 確認応答ハンドル | トリガーのトップレベルフィールドと同じAcknowledgement handleであり、Messagesを反復処理するときに使いやすいようにここに再掲されています。 |
| | メッセージタイプ | 受信したメッセージペイロードの形式。例えば: text。 |
| | 配信モード | メッセージ送信時の配信モード。 PERSISTENT メッセージは、配信、確認応答、または有効期限切れになるまでブローカーに保存されます。 DIRECT メッセージは保存されず、サブスクライバーが受信できる状態でない場合は破棄されることがあります。 |
| | 優先度 | メッセージの配信優先度。これは、キューで優先度順の配信が有効になっている場合にのみ配信順序に影響します。 |
| | サービスクラス | メッセージのサービスクラス。宛先キューが輻輳している場合に、ブローカーがどの程度優先的にメッセージを破棄するかを決定します。 |
| | 宛先 | メッセージが配信されたキューまたはトピック。含まれる項目:
|
| | 返信先 | 送信側が指定している場合に、返信を送信する宛先。含まれる項目:
|
| | アプリケーションID | 送信側が設定した場合の、送信アプリケーションのID。 |
| | アプリケーションタイプ | 送信側が設定した場合の、送信アプリケーションのメッセージタイプ。 |
| | HTTPコンテンツタイプ | 送信側が設定した場合の、メッセージのHTTPコンテンツタイプ。 |
| | 相関ID | 送信側が設定した場合の、関連メッセージを追跡するための識別子。 |
| | 送信者ID | メッセージを送信したクライアントの識別子。送信側が設定した場合。 |
| | レプリケーショングループID | メッセージのレプリケーショングループID。Solace のデータレプリケーションに使用されます。 |
| | シーケンス番号 | 送信側が設定した場合の、メッセージのシーケンス番号。 |
| | 送信時刻 | 送信者側のタイムスタンプ, ミリ秒単位。送信側が設定した場合。 |
| | 受信時刻 | メッセージが受信された時刻のタイムスタンプ, ミリ秒単位。 |
| | 有効期間 | メッセージ送信時に設定された, ブローカーによって適用される有効期間, ミリ秒単位。これは実際にメッセージの有効期限を制御し、対象となる場合はメッセージをデッドメッセージキューへルーティングします。 0 はメッセージが有効期限切れにならないことを意味します。 |
| | 有効期限 | 情報提供用の有効期限タイムスタンプヘッダー, ミリ秒単位。設定されている場合。 Time to live と異なり、ブローカー上でメッセージの有効期限を切らせることはありません。 |
| | 配信回数 | このメッセージが配信された回数。 |
| | 返信フラグ | このメッセージが、Solace のリクエスト・リプライメッセージングパターンで、以前のリクエストに対する返信かどうか。 |
| | デッドメッセージキュー対象 | メッセージが配信不能となった場合に、デッドメッセージキューへルーティング可能かどうか。 |
| | 破棄インジケーター | 例えばバッファのフルなどにより, このメッセージの前に複数のメッセージが破棄されているかどうか。 |
| | 省略対象 | ブローカーが高速なトピック更新の連続を間引きして, 遅いサブスクライバーには最新の値のみを届ける「省略 (eliding)」の対象となるかどうか。ダイレクトメッセージにのみ適用されます。 |
| | ユーザーデータ | 送信側が設定した場合の、base64エンコードされた任意のユーザーデータ。 |
| | プロパティ | メッセージのカスタムプロパティ。含まれる項目:
|
| | Message | メッセージペイロード。 |
| | リストサイズ | バッチ内のメッセージ数。 |
| | リストインデックス | バッチ内でのメッセージの位置。 |
最終更新日: