履歴

Semaphore の履歴画面では、プロジェクト内のすべてのタスク実行を包括的に確認できます。この機能により、タスクの実行履歴を追跡・分析し、自動化ワークフローに関する有益な知見を得ることができます。

概要

履歴ページには、次を含むすべてのタスク実行が時系列で一覧表示されます。

• 使用されたタスクテンプレート
• 実行ステータス (成功、失敗、実行中)
• 開始時刻と終了時刻
• 所要時間
• タスクを開始したユーザー
• タスクの出力とログ

タスク履歴の表示

履歴へのアクセス

1. Semaphore でプロジェクトに移動します
2. 「履歴」タブをクリックします
3. すべてのタスク実行の一覧を確認します

タスクの詳細

履歴一覧のタスクをクリックすると、次の情報を示す詳細ビューが開きます。

1. タスク情報

   • タスク ID
   • 使用されたテンプレート
   • 開始時刻と終了時刻
   • 所要時間
   • ステータス
   • タスクを実行したユーザー

2. 実行の詳細

   • タスクの完全な出力
   • エラーメッセージ (ある場合)
   • 使用された環境変数
   • インベントリ情報
   • リポジトリの詳細

3. タスクログ

   • リアルタイムのログ表示
   • ログのダウンロードオプション
   • ログ検索機能
   • エラーのハイライト表示

統計

プロジェクトには、選択した期間のタスク結果を要約する統計ページがあり、ユーザーによるフィルタリングが可能です。

タスク管理

利用可能な操作

履歴ビューからは、次の操作が可能です。

• タスクの完全なログへのアクセス
• タスク出力のダウンロード
• ログ内の検索

タスクの保持

Semaphore では、タスク履歴を保持する期間を設定できます。

1. デフォルトの動作

   • すべてのタスクがデータベースに保存されます
   • デフォルトでは自動削除されません

2. 保持の設定

   • テンプレートごとのタスクの最大数を設定します
   • 環境変数で設定する場合:

     SEMAPHORE_MAX_TASKS_PER_TEMPLATE=30
   • または config.json で設定する場合:

     {
       "max_tasks_per_template": 30
     }

3. 保持ルール

   • 上限に達すると、最も古いタスクが自動的に削除されます
   • 削除はテンプレートごとに行われます
   • タスクログはタスクレコードとともに削除されます