# AgentCore オブザーバビリティデータで AgentCore が生成したポリシー
<a name="observability-policy-metrics"></a>

ポリシーおよびポリシーエンジンリソースタイプの場合、Amazon Bedrock AgentCore はデフォルトで CloudWatch に呼び出しメトリクスを発行します。追加のスパンデータは、アタッチされた AgentCore Gateway リソースのトレースが有効になっている場合に使用できます。これにより、AgentCore 関連オペレーションのポリシーのスパンが出力されます。有効化の詳細については[、AgentCore ランタイム、メモリ、ゲートウェイ、組み込みツール、アイデンティティリソースのオブザーバビリティ](observability-configure.md#observability-configure-cloudwatch)の有効化」を参照してください。

**Topics**
+ [提供されたメトリクスデータ](#observability-policy-metrics-provided)
+ [提供されたスパンデータ](#observability-policy-spans)

## 提供されたメトリクスデータ
<a name="observability-policy-metrics-provided"></a>

Amazon Bedrock AgentCore は、デフォルトで以下の呼び出しメトリクスを `AWS/Bedrock-AgentCore` CloudWatch 名前空間に発行します。これらのメトリクスを使用して、ポリシーの評価と全体的なパフォーマンスを監視およびモニタリングできます。


| メトリクス | 説明 | Unit | 
| --- | --- | --- | 
| 呼び出し | サービスに対して行われたリクエストの数 | カウント | 
| SystemErrors | サーバー側のエラーの数 (5xx) | カウント | 
| UserErrors | クライアント側のエラーの数 (4xx) | カウント | 
| レイテンシー | リクエストの送信からレスポンスの受信までの合計経過時間 | ミリ秒 | 
| AllowDecisions | ALLOW になった決定の数 | カウント | 
| DenyDecisions | DENY になった決定の数 | カウント | 
| TotalMismatchedPolicies | 属性またはタイプの不一致のいずれかにより、特定のリクエストで失敗したポリシーの数 | カウント | 
| PolicyMismatch | 属性またはタイプの不一致の欠落によって引き起こされた特定のポリシーの失敗の数 | カウント | 
| MismatchErrors | ポリシーが少なくとも 1 つ一致しないために失敗したリクエストの数 | カウント | 
| DeterminingPolicies | リクエストの決定ポリシーの数 | カウント | 
| NoDeterminingPolicies | 決定ポリシーがないために拒否されたリクエストの数 | カウント | 

### メトリクスディメンション
<a name="observability-policy-metrics-dimensions"></a>

上記のメトリクスでは、次のディメンションを使用できます。これらのディメンションを使用すると、メトリクスデータをより詳細なレベルでフィルタリングおよび分析できます。


| ディメンション | 説明 | 
| --- | --- | 
| OperationName | API オペレーションの名前。有効な値は `AuthorizeAction`および です。 `PartiallyAuthorizeActions` | 
| PolicyEngine | メトリクスに関連付けられたポリシーエンジン識別子 | 
| ポリシー | メトリクスに関連付けられたポリシー識別子 | 
| TargetResource | リクエストに関連付けられた AgentCore Gateway リソース識別子 | 
| ToolName | メトリクスが適用されるツールの名前 | 
| モード | AgentCore Gateway で設定されたエンフォースメントモード。有効な値は `LOG_ONLY`および です。 `ENFORCE` | 

## 提供されたスパンデータ
<a name="observability-policy-spans"></a>

Amazon Bedrock AgentCore はAgentCore Gateway オブザーバビリティを通じて追加の構造化スパンデータを提供し、API 呼び出しに関するより深いインサイトを提供します。AgentCore スパンデータのポリシーは、AgentCore Gateway リソースのトレースを有効にした後に使用でき、CloudWatch `aws/spans`ロググループにあります。


| 運用 | スパン属性 | 説明 | 
| --- | --- | --- | 
| AuthorizeAction | aws.agentcore.policy.authorization\_decision | ポリシーを評価した後の認可の決定。有効な値は `ALLOW`および です。 `DENY` | 
|  | aws.agentcore.policy.authorization\_reason | 認可決定の理由 | 
|  | aws.agentcore.policy.determining\_policies | 決定結果を決定したポリシー識別子のリスト | 
|  | aws.agentcore.policy.mismatched\_policies | 属性の欠落またはタイプの不一致により失敗したポリシー識別子のリスト | 
|  | aws.agentcore.policy.target\_resource.id | リクエストが適用される AgentCore Gateway リソース識別子 | 
|  | aws.agentcore.gateway.policy.arn | AgentCore Gateway で設定されたポリシーエンジン Amazon リソースネーム (ARN) | 
|  | aws.agentcore.gateway.policy.mode | AgentCore Gateway で設定されたポリシーエンジンの適用モード。有効な値は `LOG_ONLY`および です。 `ENFORCE` | 
| PartiallyAuthorizeActions | aws.agentcore.policy.allowed\_tools | `ALLOW` 決定に対して評価されたツール名のリスト | 
|  | aws.agentcore.policy.denied\_tools | が`DENY`決定に対して評価したツール名のリスト | 
|  | aws.agentcore.policy.target\_resource.id | リクエストが適用される AgentCore Gateway リソース識別子 | 
|  | aws.agentcore.gateway.policy.arn | AgentCore Gateway で設定されたポリシーエンジン Amazon リソースネーム (ARN) | 
|  | aws.agentcore.gateway.policy.mode | AgentCore Gateway で設定されたポリシーエンジンの適用モード。有効な値は `LOG_ONLY`および です。 `ENFORCE` |