Files
pages/docs/design/ja/scheduler-resources.md
T
Anya Tokugawa c1175d389f Implement Knowledge City platform, organizer and DAV integration
Capture accumulated application, UI, CLI, regression tests and design documentation changes, including task project mapping and default CalDAV list naming.

Keep deployment data, backups, local credentials and build artifacts out of Git. Move the Compose enrollment token to an ignored local environment file.
2026-09-27 14:44:43 +09:00

41 lines
3.8 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 9. イベント・キュー・リソース監視
状態:永続ジョブ、定期実行、再試行・ログ、背景リソース監視あり。共通outboxの
永続 envelope(Domain sequence、idempotency、retry state、pending取得)は実装済み。
正本変更との同一transaction接続はPage/Revision/Path/Objectの初期経路で実装済み。
2026-09-25:consumerごとのcheckpointとイベント型別取得、タスク/プロジェクトの同一transaction接続、個別ONのタスク期限日/計画日Inbox通知も実装済み。汎用変更通知の配送、outbox保持ポリシー、分散leaseはTODO。
イベントログは生ログとトレンド用bucketを分離する。`event_log_policies`で
イベント種別ごとの保持時間、集約開始時間、bucket幅、最大生ログ件数を指定し、
`event_log_buckets`には件数と最初・最後の時刻だけを保持する。生ログの削除は
稼働中に安全な条件付きDELETEで行い、workerが書き込み中にテーブルをDROPしない。
物理partitionの導入時もrename→新規作成→切替を原子的に行う。
## 責務
`/_/api/v1/event/` は実行する処理とタイミング、`/_/api/v1/queue/` は実行要求と状態を扱います。予定、実行中、結果、ログ、キュー設定を区別します。イベントは安全な型付き処理であり、ユーザー入力をそのままshell commandへ変換しません。
## 前景を優先する
サムネイル・PDF・archive解析等は背景処理へ送ります。ジョブの同時数、入力・出力、時間、再試行を制限し、通常要求の活動を見ながらclaimします。長い接続だけで背景処理が永久停止しないよう、最低限の進行枠も必要です。
今後はジョブ件数だけでなくCPU/メモリ重みを管理します。native decoderのhard memory limit、プロセス分離、cancel時の子プロセス停止は別の安全条件です。
## outboxの実装と残り
正本変更と `activity_outbox` を同一transactionで記録します。Domain sequence、event UUID、型と版、actor、対象UUID、idempotency keyを含めます。本文や秘密をすべて複写しません。[購読・移行・復旧契約](outbox-delivery.md)を参照してください。
配送はat-least-onceを前提に、consumerごとのcheckpointと重複排除を使います。処理成功後にcheckpointを進め、途中停止から再試行します。City、通知、検索、集計が個別のHTTP handler callbackへ散らばらないようにします。既存の個別journalがあるだけではこの配送契約の完成ではありません。
## 運用画面とリソース
実行モニタはリソースグラフ4列と現在実行中のジョブ。設定は歯車、手動更新はアイコン。完了ジョブは履歴・ログへ統合し、ログは選択時に読みます。履歴期間の既定は1時間で選択を保持します。
現在値の表示更新、グラフの表示更新、背景の保存間隔は異なる設定です。1秒表示にしても1秒ごとの永続化や精密な瞬間使用率を意味しません。ブラウザを閉じても保存イベントは続きます。以前の「60秒既定」という原資料だけを最新設定の根拠にしません。
I/Oはプロセスの累積read/write bytes差分を時間で割った値です。再起動・欠測・counter減少は0に補間しません。ホスト全体のIOPS、latency、コンテナ合算と混同しません。
## TODOと検証
重み付き予算、dead-letterと安全な再投入、分散lease/fencing、outbox、SNMPv3読取collector。停止中の欠測、長いViewer接続、重いPDF連発、ジョブ再送、log大量化でも閲覧を優先できることを測定します。