View a markdown version of this page

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

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

使用承載字符設定 Claude Code

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

重要

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

先決條件

  • 安裝在開發人員機器上的 Claude Code。

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

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

設定指標匯出工具

Claude Code 透過環境變數設定 OpenTelemetry。在 Shell 中設定下列變數，以啟動 Claude Code （或 shell 描述檔） 來啟用指標、選取 OTLP/HTTP 通訊協定，並在 Authorization標頭中使用承載字符將指標匯出器指向 CloudWatch 指標端點。包含完整/v1/metrics路徑。

export CLAUDE_CODE_ENABLE_TELEMETRY=1
export OTEL_METRICS_EXPORTER=otlp
export OTEL_EXPORTER_OTLP_PROTOCOL=http/protobuf
export OTEL_EXPORTER_OTLP_METRICS_ENDPOINT="https://monitoring.region.amazonaws.com/v1/metrics"
export OTEL_EXPORTER_OTLP_METRICS_HEADERS="Authorization=Bearer YOUR_API_KEY"
注意

將承載字符視為秘密。避免將其遞交至以不安全方式共用或備份的來源控制或 shell 設定檔。如中所述定期輪換金鑰設定指標的承載字符身分驗證。

新增身分和組織屬性

編碼 Agent Insights 儀表板會依開發人員、團隊、部門和其他組織維度將用量分組。透過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和類似的標籤分組。Claude Code 會自動在指標type上標記指標層級維度，例如 model和 。

驗證和檢視

執行 Claude Code 來產生指標，然後確認到達 CloudWatch 的資料。

驗證指標

  1. 執行執行一些工作的 Claude Code 工作階段。

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

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

如需完整、持續更新的指引，請參閱 GitHub 上搭配 Amazon Bedrock 的 Claude Code 指南。