self_hosted Environment に接続された外部 worker によって使用されます。worker はキューに入った Session work をポーリングし、実行するアイテムを確認応答し、heartbeat でリースを維持し、work が完了または中断すべき時にアイテムを停止します。
Work item オブジェクト
list、poll、get、update metadata、acknowledge、stop の各エンドポイントによって返されます。| フィールド | 型 | 説明 |
|---|---|---|
id | string | work_ プレフィックス付きの Work item ID |
type | string | 常に "work" |
environment_id | string | env_ プレフィックス付きの Environment ID |
data | object | work ペイロードの記述子 |
data.type | string | 現在は常に "session" |
data.id | string | sess_ プレフィックス付きの Session ID |
state | string | Work item の状態。Work の状態 を参照 |
created_at | string | UTC での作成時刻 |
acknowledged_at | string|null | worker がアイテムを確認応答した時刻、ack 前は null |
started_at | string|null | 最初の heartbeat でアイテムが active へ移行した時刻、開始前は null |
latest_heartbeat_at | string|null | 最新の heartbeat タイムスタンプ、最初の heartbeat 前は null |
stop_requested_at | string|null | グレースフル停止がリクエストされた時刻、または null |
stopped_at | string|null | アイテムが stopped に到達した時刻、稼働中は null |
metadata | object | work item に関連付けられた文字列のみのメタデータ |
Work の状態
| 状態 | 説明 |
|---|---|
queued | work item がポーリング可能である、または配信されたがまだ確認応答されていない |
starting | worker がアイテムを確認応答し、実行を開始すべきである |
active | worker が heartbeat を送信し、現在のリースを所有している |
stopping | グレースフル停止がリクエストされた。worker はドレインして停止を確定すべきである |
stopped | アイテムは稼働しておらず、heartbeat できない |
Work メタデータ
Work メタデータは文字列のみのマップです。Session が work item を作成すると、Session のメタデータがこの文字列マップに投影されます。変更をマージするには Work item メタデータの更新 を使用します:- 文字列値はキーを upsert します。
nullはキーを削除します。metadataを省略すると、現在のメタデータは変更されません。
Work heartbeat オブジェクト
Work heartbeat の送信 によって返されます。| フィールド | 型 | 説明 |
|---|---|---|
type | string | 常に "work_heartbeat" |
last_heartbeat | string | 受理された heartbeat のサーバータイムスタンプ |
lease_extended | boolean | 成功した heartbeat では常に true |
state | string | heartbeat 後の現在の work item 状態 |
ttl_seconds | integer | 現在のリース TTL（秒） |
Work キュー統計オブジェクト
Work キュー統計の取得 によって返されます。| フィールド | 型 | 説明 |
|---|---|---|
type | string | 常に "work_queue_stats" |
depth | integer | 現在 worker が取得可能なキュー内アイテム |
pending | integer | 直近に配信されたがまだ確認応答されていないキュー内アイテム |
oldest_queued_at | string|null | 最も古いキュー内アイテムの作成時刻、キューが空の場合は null |
workers_polling | integer | 直近 30 秒間にこの environment をポーリングした一意の Worker-ID 値 |
関連
クラウド環境
Agent が実行されるコンテナ、ネットワーク、依存関係を選択する。