

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# CloudTrail을 사용하여 `bedrock-mantle` API 호출 모니터링
<a name="logging-cloudtrail-mantle"></a>

`bedrock-mantle.{{region}}.api.aws` 엔드포인트는와 통합됩니다 AWS CloudTrail. CloudTrail은 `bedrock-mantle` API 작업에 대한 호출을 이벤트로 기록합니다. 여기에는 , AWS Management Console, AWS CLI OpenAI SDK, Anthropic SDK 및 직접 HTTPS 호출의 호출이 포함됩니다. 이벤트`eventSource`의는 입니다`bedrock-mantle.amazonaws.com`.

애플리케이션이를 통해 추론을 호출하는 경우 [CloudTrail을 사용하여 Amazon Bedrock API 직접 호출 모니터링](logging-using-cloudtrail.md) 대신 단원을 `bedrock-runtime.{{region}}.amazonaws.com`참조하십시오.

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 | 


**Projects**  

| 이벤트 이름 | 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) 선택기를 구성합니다.


**Inference**  

| 이벤트 이름 | 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 | 

**참고**  
`CreateInference` 통화 `metadata` 시 고객이 제공하는는 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::*` 리소스 유형의를 사용합니다. `bedrock-mantle` 활동을 필터링`bedrock.amazonaws.com`하거나 캡처`bedrock-runtime.amazonaws.com`하지 않는 CloudTrail Lake 쿼리, Athena 뷰 및 탐지 제어.