

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# CloudTrail を使用して `bedrock-mantle` API コールをモニタリングする
<a name="logging-cloudtrail-mantle"></a>

`bedrock-mantle.{{region}}.api.aws` エンドポイントは と統合されます AWS CloudTrail。CloudTrail は `bedrock-mantle` API オペレーションへの呼び出しをイベントとして記録します。これには、 AWS マネジメントコンソール、、OpenAI SDK AWS CLI、Anthropic SDK、および直接 HTTPS コールからの呼び出しが含まれます。イベントには `eventSource`の があります`bedrock-mantle.amazonaws.com`。

アプリケーションが を介して推論を呼び出す場合は`bedrock-runtime.{{region}}.amazonaws.com`、[Monitor Amazon Bedrock API calls using CloudTrail](logging-using-cloudtrail.md)代わりに「」を参照してください。

CloudTrail 自体の背景については、[AWS CloudTrail 「 ユーザーガイド](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-user-guide.html)」を参照してください。

## 管理イベント
<a name="mantle-cloudtrail-management-events"></a>

管理イベントは、デフォルトで追加コストなしで CloudTrail **イベント履歴**に記録されます。 は、以下のオペレーションを管理イベントとして`bedrock-mantle`記録します。各イベントの `requestParameters`フィールドには、各イベントのサービスによって追加される `callWithBearerToken` (および`bearerTokenType`該当する場合は) も含まれます。


**モデル**  

| イベント名 | HTTP ルート | 追加のリクエストパラメータ | 
| --- | --- | --- | 
| ListModels | GET /v1/models | なし | 
| GetModel | GET /v1/models/{model} | model | 


**ファインチューニング**  

| イベント名 | HTTP ルート | 追加のリクエストパラメータ | 
| --- | --- | --- | 
| ListFineTuningJobs | GET /v1/fine\_tuning/jobs | なし | 
| CreateFineTuningJob | POST /v1/fine\_tuning/jobs | model、trainingFile、validationFile、metadata、 method (強化実行の場合は typeおよび を含む構造化オブジェクト) grader.lambda.function | 
| GetFineTuningJob | GET /v1/fine\_tuning/jobs/{id}, /events, /checkpoints | fineTuningJob | 
| CancelFineTuningJob | POST /v1/fine\_tuning/jobs/{id}/cancel | fineTuningJob | 


**プロジェクト**  

| イベント名 | HTTP ルート | 追加のリクエストパラメータ | 
| --- | --- | --- | 
| ListProjects | GET /v1/organization/projects | なし | 
| CreateProject | POST /v1/organization/projects | name, tags | 
| GetProject | GET /v1/organization/projects/{project\_id} | project\_id | 
| UpdateProject | POST /v1/organization/projects/{project\_id} | project\_id, name, add\_tags, remove\_tag\_keys, tags | 
| ArchiveProject | POST /v1/organization/projects/{project\_id}/archive | project\_id | 

## データイベント
<a name="mantle-cloudtrail-data-events"></a>

データイベントはデフォルトではログに記録されず、追加の CloudTrail 料金が発生します。 は、次のオペレーションをデータイベントとして`bedrock-mantle`ログに記録します。これらをキャプチャするには、[「データイベントのログ記録](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-data-events-with-cloudtrail.html)」の説明に従って、証跡またはイベントデータストアで高度なイベントセレクタを設定します。


**推測**  

| イベント名 | HTTP ルート | 追加のリクエストパラメータ | 
| --- | --- | --- | 
| CreateInference | POST /v1/responses | model, previousResponse, stream, service\_tier, metadata | 
| CreateInference | POST /v1/responses/compact | model, previous\_response\_id | 
| CreateInference | POST /v1/chat/completions | model, stream, service\_tier, metadata | 
| CreateInference | POST /v1/embeddings | model | 
| CreateInference | POST /anthropic/v1/messages | model, stream, max\_tokens | 
| GetInference | GET /v1/responses/{response\_id} | response, stream | 
| CancelInference | POST /v1/responses/{response\_id}/cancel | response | 
| DeleteInference | DELETE /v1/responses/{response\_id} | response | 
| CountTokens | POST /anthropic/v1/messages/count\_tokens | model | 


**ファイル**  

| イベント名 | HTTP ルート | 追加のリクエストパラメータ | 
| --- | --- | --- | 
| ListFiles | GET /v1/files | limit, order, purpose, after | 
| CreateFile | POST /v1/files | purpose, filename, bytes | 
| GetFile | GET /v1/files/{file\_id}, /content | file | 
| DeleteFile | DELETE /v1/files/{file\_id} | file | 

**注記**  
お客様が指定した`metadata``CreateInference`呼び出しは CloudTrail に逐語的に記録されます。データイベントをキャプチャ`metadata`する場合は、シークレット、認証情報、またはその他の機密値を に含めないでください。

## データイベントキャプチャの設定
<a name="mantle-cloudtrail-configuring"></a>

次の例では、すべての`bedrock-mantle`推論イベントとファイルデータイベントをキャプチャするように証跡を設定します。

```
aws cloudtrail put-event-selectors \
    --trail-name <trailName> \
    --advanced-event-selectors '[
      {
        "Name": "Log Bedrock Mantle inference and file events",
        "FieldSelectors": [
          { "Field": "eventCategory", "Equals": ["Data"] },
          { "Field": "resources.type", "Equals": [
            "AWS::BedrockMantle::Project",
            "AWS::BedrockMantle::CustomizedModel",
            "AWS::BedrockMantle::Reservation"
          ]}
        ]
      }
    ]'
```

さらに、 `eventName`と でフィルタリングすることもできます`resources.ARN`。高度なイベントセレクタの詳細については、「[AdvancedFieldSelector](https://docs.aws.amazon.com/awscloudtrail/latest/APIReference/API_AdvancedFieldSelector.html)」を参照してください。

## リソースタイプ:
<a name="mantle-cloudtrail-resource-types"></a>

`bedrock-mantle` CloudTrail イベントは次のリソースタイプを参照します。
+ `AWS::BedrockMantle::Project`
+ `AWS::BedrockMantle::Reservation`
+ `AWS::BedrockMantle::CustomizedModel`
+ `AWS::BedrockMantle::Environment`
+ `AWS::BedrockMantle::Runtime`
+ `AWS::BedrockMantle::Skill`

## ログエントリの例
<a name="mantle-cloudtrail-example"></a>

```
{
    "eventVersion": "1.08",
    "userIdentity": {
        "type": "IAMUser",
        "principalId": "AROAICFHPEXAMPLE",
        "arn": "arn:aws:iam::111122223333:user/userxyz",
        "accountId": "111122223333",
        "accessKeyId": "AKIAIOSFODNN7EXAMPLE",
        "userName": "userxyz"
    },
    "eventTime": "2026-05-30T14:32:11Z",
    "eventSource": "bedrock-mantle.amazonaws.com",
    "eventName": "CreateInference",
    "awsRegion": "us-east-1",
    "sourceIPAddress": "192.0.2.0",
    "userAgent": "OpenAI/Python 1.50.0",
    "requestParameters": {
        "model": "anthropic.claude-opus-4-7",
        "stream": true,
        "service_tier": "default",
        "metadata": {"team": "platform"},
        "callWithBearerToken": true,
        "bearerTokenType": "ABSK"
    },
    "responseElements": null,
    "requestID": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
    "eventID": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
    "readOnly": false,
    "eventType": "AwsApiCall",
    "managementEvent": false,
    "recipientAccountId": "111122223333",
    "eventCategory": "Data",
    "resources": [
        {
            "accountId": "111122223333",
            "type": "AWS::BedrockMantle::Project",
            "ARN": "arn:aws:bedrock-mantle:us-east-1:111122223333:project/proj_abc123"
        }
    ],
    "tlsDetails": {
        "tlsVersion": "TLSv1.3",
        "cipherSuite": "TLS_AES_128_GCM_SHA256",
        "clientProvidedHostHeader": "bedrock-mantle.us-east-1.api.aws"
    }
}
```

## `bedrock-runtime` CloudTrail ログ記録との違い
<a name="mantle-cloudtrail-differences"></a>
+ **推論は、 上のデータイベントであり`bedrock-mantle`、 上の管理イベントです`bedrock-runtime`。**`bedrock-runtime` エンドポイントは、管理イベントとして [Converse](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_Converse.html)、[ConverseStream](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_ConverseStream.html)、[InvokeModel](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_InvokeModel.html)、[InvokeModelWithResponseStream](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_InvokeModelWithResponseStream.html) を追加料金なしでログに記録します。`bedrock-mantle` エンドポイントは`CreateInference`、CloudTrail データイベント料金が発生するデータイベントとして、 およびその他の推論オペレーションをログに記録します。で推論呼び出しの監査証跡が必要な場合は`bedrock-mantle`、証跡またはイベントデータストアでデータイベントキャプチャを明示的に有効にする必要があります。
+ **さまざまなイベントソースとリソースタイプ。** `bedrock-mantle`イベントは、 `eventSource` の `bedrock-mantle.amazonaws.com` とリファレンス`AWS::BedrockMantle::*`リソースタイプを使用します。CloudTrail Lake クエリ、Athena ビュー、および`bedrock-mantle`アクティビティをフィルタリング`bedrock.amazonaws.com`するかキャプチャ`bedrock-runtime.amazonaws.com`しない検出コントロール。