自託管環境參考

自託管執行器和協調器的完整參考：CLI 旗標、環境變數和 Prometheus 指標。

[!NOTE]

自託管環境在 Team 和 Enterprise 方案上處於公開測試版；擁有者可以在 Cloud environments 管理頁面上開啟 Allow self-hosted environments 來啟用它們。本頁面是旗標和指標參考；請參閱 快速入門以了解設定，以及 部署到生產環境以了解艦隊配方。

本頁面是您在自託管環境中執行的兩個程序的參考：執行器在您的主機上執行 Claude Code 雲端工作階段，以及可選的自動擴展協調器，它在工作階段佇列時啟動執行器。每個都有自己的旗標表。兩者都在 Linux 或 macOS 主機上執行，預設值如 /workspace 和 ~/.claude 假設。執行 claude self-hosted-runner --help 以取得您已安裝版本上的權威清單。

指標序列和一些 API 欄位仍然使用 pool 來表示這些頁面所稱的環境；兩個術語都命名相同的東西。環境 ID 是 pool_id 欄位，形式為 ccpool_...：無論這些頁面在何處顯示 pool 識別碼，它都命名環境。CLI 旗標和環境變數將其拼寫為 environment，例如 --environment-secret-file；已棄用的 pool 拼寫仍然有效，如 --environment-secret-file 列所述。

執行器 CLI 旗標

大多數旗標都有對應的環境變數。當兩者都設定時，旗標優先。持續時間旗標在 CLI 上採用分鐘或秒，但配對的環境變數始終以毫秒為單位，由 _MS 後綴表示，預設列顯示旗標的單位：--exit-if-unused-min 10 等同於 SELF_HOSTED_RUNNER_IDLE_SHUTDOWN_MS=600000，而 Helm 值如 SELF_HOSTED_RUNNER_STARTUP_TIMEOUT_MS: "15" 表示 15 毫秒，而不是 15 分鐘的預設值。

大多數持續時間旗標都有最大值，選擇以將每個逾時保持在執行時間的 32 位元計時器上限內，大約 24.85 天。--*-min 旗標上限為 10080 分鐘，7 天；--drain-grace-sec 為 604800 秒，也是 7 天；--drain-wait-sec 為 86400 秒，24 小時。--session-stop-grace-sec 和 --post-session-hook-timeout-sec 無上限。超過上限的行為因表面而異：

• 旗標：啟動失敗並出現錯誤。
• 環境變數：執行器將值夾住到計時器上限，而不是拒絕它。

工作階段啟動逾時

如果工作階段在 /code-review 等回合期間失去了其槽，請將執行器和子程序的二進位檔更新至 v2.1.309 或更新版本。從 v2.1.299 到 v2.1.308，一旦啟動逾時經過而沒有出現 user 或 assistant 訊息，執行器就會釋放工作階段，即使在回合進行中也是如此。

使用 --startup-timeout-min <n> 時，如果子程序在複製後 <n> 分鐘內尚未完成初始化，執行器會釋放工作階段的槽。在子程序完成初始化之前開始的回合期間，工作階段會保留其槽，直到子程序的活動頻道上經過 <n> 分鐘都沒有任何一行輸出為止。子程序完成初始化後，執行器會清除該計時，並改由 --release-idle-session-min 控制釋放。若要限制子程序仍存活但已卡住的工作階段，請設定 --kill-session-after-min。

自動模式規則清單

--server-auto-mode-lists 讓您決定哪些來自執行器外部的自動模式分類器規則可以送達您執行器上的工作階段。Anthropic 的控制平面可以隨工作階段傳送規則清單，並要求執行器套用它們。其中某些項目可能是您組織的管理員所撰寫的規則。這些清單為 environment、soft_deny 和 allow：

• environment：項目可以讓分類器允許更多，也可以允許更少。
• soft_deny：項目會封鎖某個動作，除非使用者明確要求該動作或適用某個 allow 例外。
• allow：soft_deny 項目的例外。

旗標的值決定執行器套用哪些清單：

• no-allow：預設值。套用 environment 和 soft_deny，並保留 allow 不套用。environment 項目仍然可以讓分類器允許更多，因此預設值並不會排除所有放寬。
• all：套用全部三個清單。
• none：一個都不套用。選擇 none 可排除來自這些清單的所有放寬。它也會捨棄 soft_deny 的限制。

沒有任何執行器設定能讓控制平面要求執行器套用這些清單。當控制平面未提出要求時，無論您如何設定，工作階段都不會收到任何清單。若要查看實際發生的情況，請使用 --log-level debug 啟動執行器。執行器接著會為每個工作階段記錄一行包含 the server asked this runner to apply 的日誌，或一行包含 the server did not ask this runner to apply the auto mode lists it sends 的日誌。

協調器 CLI 旗標

self-hosted-runner orchestrator 子命令（產生按需執行器）接受 --api-url、--environment-secret-file、--hooks-dir、--health-port 和 --log-level，具有與執行器相同的預設值，以及執行器旗標具有的相同環境變數，除了 --hooks-dir 是必需的且必須包含 spawn-runner 掛鉤。它也採用自己的旗標：

SCM 連接器旗標

SCM 連接器無法使用，因此請將本節中的旗標保持未設定。如果您設定 --scm-connector-host，連線不會開啟，協調器會持續重試。執行器仍會以工作階段佇列的形式啟動。

連接器是從協調器到 Anthropic 控制平面的常設 WebSocket 連線。它的設計目的是讓託管的預工作階段流程（例如存放庫選擇器和分支或參考解析器）能夠到達只能從您的網路內部路由的 GitHub Enterprise Server 主機。請參閱 GitHub Enterprise Server 頁面上的網路需求，了解這些流程需要什麼。

在每次連線嘗試時，協調器會發送其現有的環境祕密，並使用指數退避自動重試，上限為 30 秒加上抖動。

僅環境變數設定

這些執行器設定僅從環境讀取，涵蓋大多數部署保留在預設值的行為：

遙測

工作階段子程序將操作遙測傳送給 Anthropic，除非您將其關閉。不會傳送任何程式碼或存放庫內容。在執行器程序上設定遙測變數；執行器在應用伺服器提供的環境變數後重新聲稱它們，因此操作員的設定始終優先。

一個控制項特定於自託管環境：CLAUDE_CODE_BYOC_ENABLE_DATADOG=1 選擇加入 Datadog 操作指標，在自託管環境中預設為關閉。一般 Claude Code 遙測控制項 DISABLE_TELEMETRY、DO_NOT_TRACK、DISABLE_ERROR_REPORTING 和 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 適用於工作階段子程序，如環境變數參考中所述。CLAUDE_CODE_DISABLE_FEATURE_FLAGS 相關但不同：設定 CLAUDE_CODE_DISABLE_FEATURE_FLAGS=1 停用功能旗標提取，遙測保持開啟，除非也設定了 DISABLE_TELEMETRY。CLAUDE_CODE_DISABLE_FEATURE_FLAGS 需要 Claude Code v2.1.319 或更新版本。

CLAUDE_CODE_ENABLE_TELEMETRY 無關：它啟用 OpenTelemetry 匯出到您自己的收集器，如監控中所述，不控制 Anthropic 的分析。

健康端點

執行器在完成註冊並完成啟動檢查後，會在設定的健康連接埠上提供 GET /healthz。從那時起，只要程序活著，無論輪詢迴圈處於什麼狀態，回應都是 200 OK，因此此端點上的 HTTP 探測只檢測死程序。JSON 主體描述當前狀態：

{
  "status": "ok",
  "runner_id": "ccrunner_...",
  "active_sessions": 2,
  "last_poll_at": "2026-03-31T18:04:11.220Z",
  "last_poll_age_ms": 842
}

請針對 last_poll_age_ms 設定警報，但不要在存活探測中使用它；存活探測應維持以 HTTP 狀態碼為依據。此值是自上次成功輪詢以來經過的時間，因此當執行器無法連線至 Anthropic 時，它也會持續上升。last_poll_at 和 last_poll_age_ms 在第一次輪詢成功之前都是 null。若要偵測從一開始就失敗的輪詢，也請針對 claude_code_self_hosted_runner_poll_errors_total 設定警報，該指標列於 Prometheus 指標中。

協調器自己的 /healthz 位於其健康連接埠上，始終返回 200。主體攜帶報告最近一次輪詢是否成功的 connected 欄位，以及 queue_counts 中依狀態分類的產生佇列計數。若要了解 connected 為何是 false，請讀取頂層的 last_error 欄位，每次輪詢成功時都會將其重設為 null。請根據 connected 而非狀態碼來判斷就緒狀態與觸發警報。

當配置SCM 連接器時，協調器的 /healthz 主體也攜帶 scm_connector_connected 和一個 scm_connector 物件，其中包含 connected、last_connected_at、last_error、reconnects 和 requests_forwarded。當未設定 --scm-connector-host 時，兩個欄位都是 null。

Prometheus 指標

每個執行器都會在與 /healthz 相同的連接埠上，於 GET /metrics 提供 Prometheus 指標。主要序列如下：

協調器會在與其 /healthz 相同的連接埠上，於 GET /metrics 提供自己的序列：

對於自動擴展，請選擇符合您擴展方式的序列，並在其送入擴展器之前加上閘控：

• 佇列深度擴展：將 claude_code_self_hosted_orchestrator_pool_pending_sessions 送入您的 HPA 或 KEDA 擴展器，而非 queue_pending_sessions。
• 容量擴展：依執行器的 active_sessions 與 capacity 的比率進行擴展。
• 以 connected 閘控：針對每個執行個體以 claude_code_self_hosted_orchestrator_connected == 1 篩選查詢，讓已中斷連線的副本的過時值不會送入擴展器。

在完全無法輪詢的中斷期間（所有副本都已中斷連線），經閘控的查詢不會傳回任何資料。HPA 在指標缺失時會維持目前的副本數，但 KEDA 的 Prometheus 擴展器在預設的 ignoreNullValues: "true" 下會將空結果視為零並縮減；請在 ScaledObject 上設定 ignoreNullValues: "false"，並可選擇搭配 fallback 副本下限。

以下 Prometheus Operator PodMonitor 涵蓋這兩個程序。它依據 Kubernetes 範例所設定的 app.kubernetes.io/part-of: claude-code-self-hosted-runner 標籤與名為 health 的連接埠來選取 pod；請調整命名空間以符合您的部署：

# Claude Code 自架執行器 + 協調器的 Prometheus Operator PodMonitor 範例。
# 請調整命名空間與標籤選擇器以符合
# 您的部署。執行器與協調器都會在
# 各自的 --health-port（預設 8080）上提供 /metrics。
apiVersion: monitoring.coreos.com/v1
kind: PodMonitor
metadata:
  name: claude-code-self-hosted-runner
  namespace: monitoring
spec:
  namespaceSelector:
    matchNames:
      - claude-runners
  selector:
    matchExpressions:
      # 比對 Kubernetes 範例中的執行器 Deployment，以及任何
      # 您以相同方式加上標籤
      # 並提供名為 'health' 之 containerPort 的按需執行器 Job 與協調器 pod。
      - key: app.kubernetes.io/part-of
        operator: In
        values: [claude-code-self-hosted-runner]
  podMetricsEndpoints:
    - port: health
      path: /metrics
      interval: 30s

範例警示規則

這些範例警示規則僅是起點；請依您的機群規模調整閾值：

# Claude Code 自架執行器 + 協調器的 Prometheus 警示規則範例。
# 請依您的機群規模與 SLO 調整閾值。
groups:
  - name: claude-code-self-hosted-runner
    rules:
      - alert: ClaudeRunnerPollStale
        expr: claude_code_self_hosted_runner_last_poll_age_seconds > 60
        for: 2m
        labels: {severity: warning}
        annotations:
          summary: "Runner {{ $labels.pod }} has not polled in >60s"
      - alert: ClaudeRunnerVersionDrift
        expr: count(count by (version) (claude_code_self_hosted_runner_info)) > 1
        for: 30m
        labels: {severity: info}
        annotations:
          summary: "Runners are running mixed versions"
      - alert: ClaudeRunnerInitErrorsHigh
        expr: sum by (namespace) (increase(claude_code_self_hosted_runner_session_init_errors_total[10m])) > 3
        for: 5m
        labels: {severity: warning}
        annotations:
          summary: "Sessions are failing before init (checkout hook / git / token / pre-init crash)"
      - alert: ClaudeRunnerPollErrors
        expr: sum by (pod) (rate(claude_code_self_hosted_runner_poll_errors_total[5m])) > 0
        for: 2m
        labels: {severity: warning}
        annotations:
          summary: "Runner {{ $labels.pod }}: PollWork failing ({{ $value | humanize }}/s over 5m)"
      - alert: ClaudeRunnerSessionStartHookErrors
        expr: sum by (namespace) (increase(claude_code_self_hosted_runner_session_start_hook_errors_total[10m])) > 3
        for: 5m
        labels: {severity: warning}
        annotations:
          summary: "SessionStart hooks are failing"

  - name: claude-code-self-hosted-orchestrator
    rules:
      - alert: ClaudeOrchestratorDisconnected
        expr: claude_code_self_hosted_orchestrator_connected == 0
        for: 2m
        labels: {severity: critical}
        annotations:
          summary: "Orchestrator {{ $labels.pod }} cannot reach the Anthropic control plane"
      - alert: ClaudeOrchestratorPollStale
        expr: claude_code_self_hosted_orchestrator_last_poll_age_seconds > 90
        for: 2m
        labels: {severity: warning}
        annotations:
          summary: "Orchestrator {{ $labels.pod }} has not polled in >90s (poll loop waits on hook execution)"
      - alert: ClaudeOrchestratorCircuitBroken
        expr: max by (namespace) (claude_code_self_hosted_orchestrator_queue_circuit_broken_sessions and on (instance) max_over_time(claude_code_self_hosted_orchestrator_connected[2m]) == 1) > 0
        for: 1m
        labels: {severity: critical}
        annotations:
          summary: "Sessions blocked from spawning: {{ $value }}. Read each one's error in the Activity tab, fix the cause, then select Retry"
      - alert: ClaudeOrchestratorPollErrors
        expr: sum by (pod) (rate(claude_code_self_hosted_orchestrator_poll_errors_total[5m])) > 0
        for: 2m
        labels: {severity: warning}
        annotations:
          summary: "Orchestrator {{ $labels.pod }}: PollSpawnHints failing ({{ $value | humanize }}/s over 5m)"
      - alert: ClaudeOrchestratorSpawnHookFailing
        expr: sum by (pod) (increase(claude_code_self_hosted_orchestrator_spawn_hooks_total{result!="ok"}[5m])) > 3
        for: 5m
        labels: {severity: warning}
        annotations:
          summary: "Orchestrator {{ $labels.pod }}: >3 spawn-runner hook failures in 5m"

針對遺失的執行器與等待中的工作階段發出警示

若要在執行器遺失、工作階段等待或協調器停止運作時收到警示，請在範例警示規則旁一併載入以下 Prometheus 警示規則：

• 固定機群：ClaudeRunnersBelowFloor
• 按需執行器：ClaudeOrchestratorSessionsWaiting、ClaudeOrchestratorQueueWaitHigh 與 ClaudeOrchestratorAbsent

在固定機群遺失執行器時發出警示

當已註冊且已抓取的執行器少於下限並持續 10 分鐘時，ClaudeRunnersBelowFloor 會觸發：

groups:
  # 僅適用於固定機群。使用按需執行器時，數量會隨需求變化，
  # 因此每當需求低時 ClaudeRunnersBelowFloor 都會觸發。
  - name: claude-code-self-hosted-fixed-fleet-capacity
    rules:
      - alert: ClaudeRunnersBelowFloor
        expr: (count(claude_code_self_hosted_runner_info{namespace="claude-runners"}) or vector(0)) < 2
        for: 10m
        labels: {severity: critical, namespace: claude-runners}
        annotations:
          summary: "Runners registered and scraped: {{ $value }}, below the floor. Check the runner workloads first, then the scrape targets if all are running."

• 下限：將 expr 中的 2 設為副本數的一半左右（無條件進位）。若有三個副本，請保留 2，當只剩一個執行器或沒有執行器時，警示就會觸發。
• 命名空間：替換 matcher 與 labels 中的 claude-runners，並為每個額外的命名空間複製此警示。如果您的目標沒有 namespace 標籤，請移除 matcher 與該標籤，否則警示會讀到 0 並觸發。
• ClaudeRunnerPollStale 與 ClaudeRunnerPollErrors：請繼續從範例警示規則載入它們，因為 ClaudeRunnersBelowFloor 仍會計入無法輪詢的執行器

在工作階段等待按需執行器時發出警示

當等待執行器的工作階段數持續大於 0 達 10 分鐘時，ClaudeOrchestratorSessionsWaiting 會觸發。當過去 10 分鐘內超過 1% 的佇列等待超過 160 秒，且此情況持續 5 分鐘時，ClaudeOrchestratorQueueWaitHigh 會觸發：

groups:
  # 僅適用於按需執行器。不需要針對命名空間進行編輯。
  - name: claude-code-self-hosted-on-demand-capacity
    rules:
      - alert: ClaudeOrchestratorSessionsWaiting
        expr: |
          max by (namespace) (
            claude_code_self_hosted_orchestrator_pool_pending_sessions
            and on (instance)
            max_over_time(claude_code_self_hosted_orchestrator_connected[2m]) == 1
          ) > 0
        for: 10m
        labels: {severity: warning}
        annotations:
          summary: "Sessions waiting for a runner: {{ $value }}, above the threshold for 10 minutes. Check claude_code_self_hosted_orchestrator_spawn_hooks_total by result, then runner workloads that don't start."
      - alert: ClaudeOrchestratorQueueWaitHigh
        expr: |
          histogram_quantile(0.99, sum by (namespace, le) (
            rate(claude_code_self_hosted_orchestrator_session_queue_wait_seconds_bucket[10m])
          )) > 160
        for: 5m
        labels: {severity: warning}
        annotations:
          summary: "Over 1% of queue waits in the last 10 minutes exceeded 160 seconds. Check whether ClaudeOrchestratorDisconnected is firing, then claude_code_self_hosted_orchestrator_spawn_hooks_total by result and claude_code_self_hosted_orchestrator_spawn_hook_duration_seconds."

• 閾值：如果總是有某個工作階段在等待，請將 ClaudeOrchestratorSessionsWaiting 中的 > 0 提高到您平常看到的數量以上
• ClaudeOrchestratorDisconnected：請繼續從範例警示規則載入它，因為在命名空間中最後一個協調器中斷連線約 2 分鐘後，ClaudeOrchestratorSessionsWaiting 就會停止觸發

在協調器停止運作時發出警示

若要得知協調器本身已停止運作，請載入 ClaudeOrchestratorAbsent。當命名空間中沒有任何協調器被抓取達 5 分鐘時，它會觸發：

groups:
  # 僅適用於按需執行器。請將 claude-runners 替換為協調器的命名空間。
  - name: claude-code-self-hosted-on-demand-orchestrator
    rules:
      - alert: ClaudeOrchestratorAbsent
        expr: absent(claude_code_self_hosted_orchestrator_connected{namespace="claude-runners"})
        for: 5m
        labels: {severity: critical}
        annotations:
          summary: "No orchestrator has been scraped for 5 minutes. If it's down, no on-demand runner starts, and sessions wait. Check the orchestrator workload first, then its scrape target if it's running."

• 命名空間：將 claude-runners 替換為協調器的命名空間，並為每個額外執行協調器的命名空間複製此警示。如果您的目標沒有 namespace 標籤，請移除 matcher，否則警示會在 5 分鐘後觸發並持續不消失。
• 未抓取協調器的 Prometheus 伺服器：請勿將此警示放入其規則檔案，因為在這類伺服器上它會在 5 分鐘後觸發並持續不消失
• 請勿依賴協調器的其他警示：它們讀取的是協調器本身提供的指標。ClaudeOrchestratorSessionsWaiting、ClaudeOrchestratorQueueWaitHigh 以及協調器的範例警示規則，都會在協調器停止運作後約 10 分鐘內停止觸發。

傳遞工作階段子程序指標

每個工作階段都在自己的子程序中執行，並擁有自己的 OpenTelemetry 指標；當 --capacity 大於一時，執行器會改寫這些子程序指標的公開方式。在執行器主機上設定 OTEL_METRICS_EXPORTER=prometheus，並在工作階段的環境中設定 CLAUDE_CODE_ENABLE_TELEMETRY=1（例如透過您的包裝指令碼，或透過工作階段會繼承的執行器自身環境），即可在執行器自己的 /metrics 端點上，與執行器的序列一起重新公開每個子程序的計數器與量測儀器。執行器會改寫子程序的匯出器，使其透過 OTLP 推送至健康連接埠上僅限回送位址的接收器，為每個序列加上 session_id 與 client_platform 標籤，並在工作階段結束時移除該工作階段的序列。直方圖不會被傳遞，而名稱會與執行器自身前綴衝突的子程序指標會被捨棄。

在預設的 --capacity 1 下，此改寫不適用：工作階段的子程序會如常在連接埠 9464 上繫結自己的 Prometheus 端點。

將工作階段的指標與執行器的指標聯結

若要查看閒置工作階段的成本，請以 ccr_session_id 將執行器的 claude_code_self_hosted_runner_session_idle_seconds 與 Claude Code 的成本指標聯結。執行器的指標沒有該標籤，因此請使用 label_replace 為其加上，如以下查詢所示：

sum by (ccr_session_id) (claude_code_cost_usage_total)
and on (ccr_session_id)
label_replace(
  claude_code_self_hosted_runner_session_idle_seconds > 600,
  "ccr_session_id", "cse_$1", "session_id", "session_(.*)"
)

此查詢會為每個閒置超過十分鐘的工作階段傳回一個結果：其 Claude Code 程序到目前為止所計算的成本（美元）。若要聯結其他 Claude Code 指標，請替換查詢中的 claude_code_cost_usage_total。此查詢適用於任何 --capacity。

• session_id：在連接埠 9464 上，Claude Code 指標的此標籤保存的是 Claude Code 自己的 session.id，不會與任何執行器序列相符。以它聯結不會傳回任何結果，因此請以 ccr_session_id 聯結。
• Claude Code 指標沒有 ccr_session_id：請確認 OTEL_METRICS_INCLUDE_SESSION_ID 未設定為 false

工作階段生命週期計數器語意

sessions_started_total、sessions_completed_total、sessions_failed_total 與 sessions_interrupted_total 計數器會依每個工作階段的結束方式加以分類。每個產生的工作階段子程序都會在產生時遞增 sessions_started_total，並在結束時恰好遞增其他三者之一，因此 sessions_started_total 減去其他三者之和，即等於目前正在執行的工作階段子程序數。

• completed：工作階段正常結束。這涵蓋子程序自行以代碼 0 結束、在子程序仍連線時工作階段被封存或刪除，以及執行器正常交回槽位：在閒置逾時、退役時間或 --kill-session-after-min 限制時釋放工作階段；啟動逾時；或輪詢迴圈在子程序結束前注意到伺服器端取消指派。遞增 sessions_completed_total。
• failed：子程序自行以非零代碼結束，可能是當機或產生後的設定失敗。遞增 sessions_failed_total。
• interrupted：執行器因營運原因終止子程序，既非工作階段成功也非執行器故障，例如排空，或終止在 --kill-session-after-min 限制後的 SELF_HOSTED_RUNNER_MAX_LIFETIME_GRACE_MS 寬限期結束時仍在執行器上的工作階段。Kubernetes 滾動重新啟動傳送 SIGTERM 即為排空的一個例子。遞增 sessions_interrupted_total。

在 v2.1.260 之前，執行器會終止所有達到 --kill-session-after-min 限制的工作階段，並將其計入 sessions_interrupted_total。

post-session hook 的 CLAUDE_RUNNER_EXIT_REASON 對正常交回的分類方式不同。hook 會將以下情況回報為 interrupted，因為是執行器停止了子程序：釋放、啟動逾時、伺服器取消指派，以及輪詢先注意到的封存或刪除。這些計數器則將相同事件記錄為 completed，因為槽位已正常交回。

如果您直接將 hook 收據與 sessions_completed_total 對帳，會低估完成數。請使用 hook 取得每個工作階段的保證，並使用計數器取得彙總比率。

在一次性環境中（--capacity 1 搭配預設的 --drain-grace-sec 0），每個執行器程序會在其唯一的工作階段結束後隨即結束。sessions_completed_total、sessions_failed_total 與 sessions_interrupted_total 只在工作階段結束時、也就是在該程序結束前一刻才遞增，因此每 15 到 60 秒一次的 Prometheus 抓取很少能在執行器的序列消失前捕捉到遞增；這三個工作階段結束時的計數器，就是本節其餘部分所稱的終端計數器。sessions_started_total 在產生時遞增，並在工作階段的整個生命週期內保持可見，因此能可靠地出現，但在一次性環境中，它讀起來更接近「目前正在執行的工作階段」，而非累計計數。

請針對對應的目標使用此表中的序列，而非終端計數器：

orchestrator_* 列只存在於執行按需協調器的環境中。在執行器存活時間長於其工作階段的固定機群上（--drain-grace-sec 大於 0），請使用 sum(rate(claude_code_self_hosted_runner_sessions_started_total[5m])) 取得吞吐量；在一次性機群上，該序列與終端計數器有相同的抓取時間窗問題，因此請改為依賴排隊中工作階段的計數。請在 Cloud environments 管理頁面上環境的 Activity 分頁檢查積壓：執行器不會匯出佇列深度序列。

若要取得每個工作階段的結果報告，請改用 post-session hook：依據 hook 本身的約定，它會在每個已產生子程序的工作階段結束時觸發，但執行器被突然終止（例如 VM 被搶佔）的情況除外。

下一步

• 自託管環境：環境、執行器和工作階段模型；快速入門和部署到生產環境保持設定和操作
• 自訂工作階段：包裝指令碼、生命週期掛鉤和按需執行器
• 驗證工作階段身份：工作階段權杖、其聲稱以及如何驗證它