View a markdown version of this page

アカウント間で AgentCore リソースをモニタリングする - Amazon Bedrock AgentCore

アカウント間で AgentCore リソースをモニタリングする

Amazon CloudWatch クロスアカウントオブザーバビリティを使用して、1 つのモニタリングアカウントから複数の AWS アカウントで Amazon Bedrock AgentCore リソースをモニタリングできます。これにより、アカウントを切り替えることなく、ソースアカウントのエージェントメトリクス、トレース、セッション、リソースデータを表示できます。

クロスアカウントオブザーバビリティを有効にすると、モニタリングアカウントの AgentCore Observability コンソールに、リンクされたすべてのソースアカウントのデータとローカルアカウントデータが自動的に表示されます。

前提条件

アカウント間で AgentCore リソースをモニタリングする前に、以下を完了する必要があります。

  • モニタリングアカウントの設定 – CloudWatch 設定でモニタリング AWS アカウントとして中央アカウントを設定します。手順については、CloudWatch クロスアカウントオブザーバビリティ」を参照してください。

  • ソースアカウントのリンク – AWS Organizations または個々のアカウントのリンクを使用して、1 つ以上のソースアカウントをモニタリングアカウントにリンクします。ソースアカウントは、必要なテレメトリタイプ (メトリクスとログ) を共有する必要があります。

  • AgentCore リソースのデプロイ – AgentCore エージェント、ゲートウェイ、メモリ、アイデンティティ、組み込みツールリソースが、オブザーバビリティが有効になっているソースアカウントにデプロイされていることを確認します。

クロスアカウントモニタリングを設定する方法

ステップ 1: モニタリングアカウントを設定する

  • CloudWatch コンソールを開きます。

  • 左側のナビゲーションペインで [設定] を選択します。

  • Monitoring account configuration セクションで、Configure を選択します。

  • 共有するテレメトリタイプを選択します。

    • 少なくとも、メトリクスログを選択して AgentCore クロスアカウントオブザーバビリティを有効にします。

  • モニタリングアカウントのセットアップウィザードを完了します。

ステップ 2: ソースアカウントをリンクする

次のいずれかの方法を使用して、ソースアカウントをモニタリングアカウントにリンクします。

  • AWS Organizations (推奨) – 組織または組織単位内のすべてのアカウントを自動的にリンクします。新しいアカウントは自動的にオンボーディングされます。

  • 個々のアカウントのリンク — CloudFormation テンプレートまたは URL を使用して、特定のアカウントをリンクします。

ソースアカウントを設定するときは、モニタリングアカウントで選択したのと同じテレメトリタイプがソースアカウントでも有効になっていることを確認してください。

詳細な手順については、「モニタリングアカウントとソースアカウントをリンクする」を参照してください。

ステップ 3: AgentCore Observability でクロスアカウントデータを表示する

  • モニタリングアカウントで AgentCore Observability コンソールを開きます。

  • コンソールには、リンクされたすべてのソースアカウントのデータが自動的に表示されます。

Infrastructure as Code を使用したクロスアカウントモニタリングの設定

AWS CloudFormation を使用して、CloudWatch Observability Access Manager (OAM) リソースを使用してクロスアカウントオブザーバビリティをプログラムで設定できます。

シンクとリンクを作成するために必要な IAM アクセス許可については、「必要なアクセス許可」を参照してください。

モニタリングアカウント: シンクを作成する

モニタリングアカウントで、ソースアカウントからのテレメトリを受け入れる OAM シンクを作成します。

シンクポリシーの範囲は、次のいずれかの方法で指定できます。

  • 組織別 (推奨) — Organizations AWS 組織内のすべてのアカウントを許可aws:PrincipalOrgIDするために使用します。これは最も簡単なアプローチであり、組織に追加された新しいアカウントが自動的に含まれます。

  • 個々のアカウント IDs 別 – 特定のソースアカウント IDsプリンシパルとして一覧表示します。このアプローチは、どのアカウントをリンクできるかをきめ細かく制御する必要がある場合に使用します。

オプション 1: 組織内のすべてのアカウントを許可する

を AWS Organizations 組織 ID ( などo-a1b2c3d4e5) <your-org-id>に置き換えます。

AWSTemplateFormatVersion: '2010-09-09' Description: OAM Sink for cross-account AgentCore Observability (organization-wide) Resources: ObservabilitySink: Type: AWS::Oam::Sink Properties: Name: AgentCoreObservabilitySink Policy: Version: '2012-10-17' Statement: - Effect: Allow Principal: '*' Action: - 'oam:CreateLink' - 'oam:UpdateLink' Resource: '*' Condition: StringEquals: aws:PrincipalOrgID: '<your-org-id>' ForAllValues:StringEquals: oam:ResourceTypes: - 'AWS::Logs::LogGroup' - 'AWS::CloudWatch::Metric' Tags: Purpose: AgentCoreObservability Outputs: SinkArn: Value: !GetAtt ObservabilitySink.Arn Description: Share this ARN with source accounts to create links

オプション 2: 特定のソースアカウントを許可する

<source-account-id-1> と をソース AWS アカウントのアカウント IDs<source-account-id-2>に置き換えます。

AWSTemplateFormatVersion: '2010-09-09' Description: OAM Sink for cross-account AgentCore Observability (specific accounts) Resources: ObservabilitySink: Type: AWS::Oam::Sink Properties: Name: AgentCoreObservabilitySink Policy: Version: '2012-10-17' Statement: - Effect: Allow Principal: AWS: - '<source-account-id-1>' - '<source-account-id-2>' Action: - 'oam:CreateLink' - 'oam:UpdateLink' Resource: '*' Condition: ForAllValues:StringEquals: oam:ResourceTypes: - 'AWS::Logs::LogGroup' - 'AWS::CloudWatch::Metric' Tags: Purpose: AgentCoreObservability Outputs: SinkArn: Value: !GetAtt ObservabilitySink.Arn Description: Share this ARN with source accounts to create links

ソースアカウント: リンクを作成する

各ソースアカウントで、モニタリングアカウントのシンクへの OAM リンクを作成します。を前のステップのシンク ARN <sink-arn-from-monitoring-account>に置き換えます。

AWSTemplateFormatVersion: '2010-09-09' Description: OAM Link for cross-account AgentCore Observability Resources: ObservabilityLink: Type: AWS::Oam::Link Properties: LabelTemplate: '$AccountName' ResourceTypes: - 'AWS::Logs::LogGroup' - 'AWS::CloudWatch::Metric' SinkIdentifier: '<sink-arn-from-monitoring-account>' Tags: Purpose: AgentCoreObservability

このリンクを組織内のすべてのメンバーアカウントにデプロイするには、 AWS CloudFormation StackSets を使用します。手順については、「モニタリングアカウントとソースアカウントをリンクする」を参照してください。

OAM リソースの詳細については、AWS CloudFormation OAM リソースリファレンス」を参照してください。

クロスアカウントデータのフィルタリング

セッションテーブルとトレーステーブルのアカウントごとにデータをフィルタリングできます。

  • テーブルで プロパティフィルターを使用します。

  • フィルタープロパティとしてアカウント ID を選択します。

  • ソースアカウント ID を入力して、結果を特定のアカウントにフィルタリングします。

制限事項

  • クロスアカウントリソースアクション – 一部のアクションは、リソースの詳細について Bedrock コンソールに移動するなど、クロスアカウントリソースでは使用できません。これらのアクションを実行するには、ソースアカウントに直接サインインする必要があります。

  • OAM リンクが必要 – クロスアカウントデータは、モニタリングアカウントとソースアカウント間の OAM リンクがアクティブな場合にのみ表示されます。リンクが削除されると、クロスアカウントデータは表示されなくなります。

  • テレメトリタイプ – モニタリングアカウントとソースアカウントの両方で、AgentCore の完全なオブザーバビリティのためにメトリクスとログが有効になっている必要があります。サブセットのみが共有されている場合、一部のデータが欠落している可能性があります。

  • リージョン – クロスアカウントオブザーバビリティは 1 つの AWS リージョン内で機能します。モニタリングアカウントとソースアカウントは同じリージョンに存在する必要があります。