View a markdown version of this page

使用承載字符設定 OpenAI Codex - Amazon CloudWatch
先決條件設定指標匯出工具新增身分和組織屬性驗證和檢視

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

使用承載字符設定 OpenAI Codex

在此路徑上，OpenAI Codex 會將 OpenTelemetry (OTel) 指標直接傳送至 Amazon CloudWatch 原生 OTLP 指標端點，並使用承載字符 (CloudWatch 指標 API 金鑰） 進行驗證。不需要 OpenTelemetry 收集器。這是個別開發人員或小型團隊在編碼客服人員洞見儀表板中取得 Codex 指標的最快方式。

重要

承載字符是長期憑證。我們建議僅在短期 AWS 登入資料不可行的情況下使用，例如外部的開發人員筆記型電腦 AWS。如需安全權衡和金鑰輪換指引，請參閱 設定指標的承載字符身分驗證。透過企業 SSO 聯合身分的組織應該改用企業推展。請參閱 為企業推展設定 OpenAI Codex。

先決條件

  • OpenAI Codex 安裝在開發人員的機器上。

  • Codex 呼叫模型以進行推論的工作方式。此遙測設定與推論無關，因此您可以使用 OpenAI 帳戶 （預設 Codex 供應商） 或 Amazon Bedrock。若要使用 Amazon Bedrock 進行推論，請參閱 OpenAI Codex 文件中的 Amazon Bedrock。

  • CloudWatch 指標 API 金鑰 （承載字符），從具有 CloudWatch 指標許可的 IAM 使用者建立。如需建立 IAM 使用者並產生金鑰的程序，請參閱 設定指標的承載字符身分驗證。

設定指標匯出工具

Codex 會從 讀取其組態~/.codex/config.toml。新增指向 CloudWatch 指標 OTLP 端點的[otel.metrics_exporter]區段，並在 Authorization標頭中傳送承載字符。包含完整/v1/metrics路徑；Codex 不會為您附加。

[otel]
environment = "production"

[otel.metrics_exporter]
otlp-http = { endpoint = "https://monitoring.region.amazonaws.com/v1/metrics", protocol = "binary", headers = { "Authorization" = "Bearer YOUR_API_KEY" } }
注意

有些 Codex 版本不會在標頭值內展開環境變數，因此 API 金鑰會內嵌顯示。config.toml 視為秘密：限制其檔案許可 （例如 chmod 600 ~/.codex/config.toml)，並且不將其遞交至來源控制。

新增身分和組織屬性

編碼 Agent Insights 儀表板會依開發人員、團隊、部門和其他組織維度將用量分組。透過啟動 Codex 的 Shell 中的OTEL_RESOURCE_ATTRIBUTES環境變數，將這些屬性提供為 OTel 資源屬性。從開發人員的身分和組織的結構設定值。

export OTEL_RESOURCE_ATTRIBUTES="\
user.id=alias,\
user.email=developer@example.com,\
user.name=Jane Doe,\
department=engineering,\
team.id=platform,\
cost_center=cc-1234,\
organization=example-corp,\
location=us-seattle,\
role=software-engineer,\
manager=manager@example.com"
注意

將這些設定為資源屬性 （而不是每個資料點屬性） 符合儀表板預期的形狀，因此您可以依 @resource.team.id、 @resource.department和類似的標籤分組。Codex 會自動在指標token_type上標記指標層級維度，例如 model和 。

驗證和檢視

執行 Codex 幾圈以產生指標，然後確認到達 CloudWatch 的資料。

驗證指標

  1. 執行執行一些工作的 Codex 工作階段 （例如，要求它執行命令並編輯檔案）。

  2. 在 CloudWatch 主控台中，選擇 GenAI 可觀測性、編碼客服人員洞見，然後選擇 Codex 標籤。指標通常會在幾分鐘內顯示。

  3. 或者，直接使用 PromQL 查詢指標。如需詳細資訊，請參閱PromQL 查詢。

如需完整、持續更新的指引，請參閱 GitHub 上 Amazon Bedrock 上的 Codex 指引。