View a markdown version of this page

エンタープライズロールアウトに対する OpenAI Codex のセットアップ - Amazon CloudWatch

エンタープライズロールアウトに対する OpenAI Codex のセットアップ

このパスは、開発者フリート全体で Codex を運用し、自動的に属性付けされた一貫性のあるテレメトリを必要とし、長期的な認証情報を配布しない場合に使用します。開発者はコーポレート ID プロバイダー (IdP) を介して認証されるため、ID と組織の属性は手動で入力されるのではなく、ディレクトリから取得されます。メトリクスは引き続き Amazon CloudWatch に到達し、アイデンティティデータと組織データが OTel リソース属性として送信されるため、同じ Coding Agent Insights ダッシュボードにデータが表示されます。

このパスは、Okta、Microsoft Entra ID (Azure AD)、Auth0、AWS IAM Identity Center などのコーポレートシングルサインオン (SSO) プロバイダーをサポートします。

仕組み

エンタープライズロールアウトでは、開発者の ID は IdP から CloudWatch に到達するテレメトリに流れます。一般的なデプロイには以下のコンポーネントが含まれます。

  • ID フェデレーション — 開発者は IdP (Okta、Microsoft Entra ID、Auth0、または AWS IAM Identity Center) を通じてサインインします。IdP は、開発者の E メールと組織属性 (部門、チーム、コストセンターなど) を提供します。

  • 一元化された Amazon Bedrock アクセス — フェデレーションk開発者は、推論のために Amazon Bedrock へのアクセスを許可するロールを引き受けるため、静的モデル認証情報は配布しません。

  • ローカルコレクター — 開発者ごとの OpenTelemetry コレクターは、localhost 上の Codex からメトリクスを受け取り、アイデンティティと組織のリソース属性をスタンプし、AWS Signature Version 4 (SigV4) でリクエストに署名して、CloudWatch ネイティブ OTLP エンドポイントに転送します。コレクターは開発者のフェデレーション認証情報で署名するため、ベアラートークンは配布されません。

フリートにロールアウトする

一般的なエンドツーエンドのロールアウトは、これらのステージに従います。

組織全体で Codex テレメトリをロールアウトするには
  1. ID フェデレーションを設定します。IdP を AWS IAM Identity Center に接続し (または OIDC フェデレーションを直接設定し)、部門、チーム、コストセンターなど、使用状況を属性付けするディレクトリ属性をマッピングして、ロールアウトできるようにします。

  2. Amazon Bedrock アクセスを一元化します。フェデレーション開発者に、Codex が必要とする Amazon Bedrock モデルの呼び出しを許可するロールを付与します。このロールは、許可した AWS リージョンとモデルに限定されます。

  3. インフラストラクチャをデプロイします。提供された AWS CloudFormation テンプレートをデプロイして、フリートのロール、ポリシー、サポートリソースを作成します。

  4. 開発者設定を生成して配布します。提供されたセットアップスクリプトを使用して、各開発者のコレクター設定を生成します。このスクリプトは、フェデレーションセッションから user.emailuser.id を取得し、IdP から組織のリソース属性 (部門、チーム、コストセンター、組織など) を入力します。次に、レンダリングされたコレクター設定と、ローカルコレクターを指す Codex [otel] ブロックを書き込みます。

  5. 開発者が Codex を実行します。各開発者は SSO を通じてサインインし、ローカルコレクターを起動して Codex を実行します。メトリクスは Codex からローカルコレクターを経由して CloudWatch に流れ、開発者とその組織に自動的に帰属します。

注記

このパスでは、アイデンティティ属性と組織属性が OTel リソース属性として出力されます。これは、ベアラートークンパスが生成するのと同じ形です。その結果、同じ Coding Agent Insights ダッシュボードに追加設定なしでデータが表示されます。

完全なガイダンス

CloudFormation テンプレート、ID フェデレーションセットアップ、フリートセットアップスクリプトなど、継続的に更新される完全なガイダンスについては、GitHub の「Codex on Amazon Bedrock のガイダンス」を参照してください。フリートがメトリクスを送信したら、ダッシュボードの表示 の説明に従ってダッシュボードを表示します。