As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Monitore as `chamadas de API Bedrock-mantle usando` CloudTrail
<a name="logging-cloudtrail-mantle"></a>

O `bedrock-mantle.{{region}}.api.aws` endpoint se integra com o. AWS CloudTrail CloudTrail registra chamadas para as operações da `bedrock-mantle` API como eventos, incluindo chamadas do Console de gerenciamento da AWS, do AWS CLI, do OpenAI SDK, do Anthropic SDK e chamadas HTTPS diretas. Os eventos têm um `eventSource` de`bedrock-mantle.amazonaws.com`.

Se seu aplicativo chama a inferência`bedrock-runtime.{{region}}.amazonaws.com`, consulte [Monitore as chamadas da API Amazon Bedrock usando CloudTrail](logging-using-cloudtrail.md) em vez disso.

Para obter informações sobre CloudTrail si mesmo, consulte o [Guia AWS CloudTrail do usuário](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-user-guide.html).

## Eventos de gerenciamento
<a name="mantle-cloudtrail-management-events"></a>

Os eventos de gerenciamento são registrados por padrão em seu **histórico de CloudTrail eventos** sem custo adicional. `bedrock-mantle`registra as seguintes operações como eventos de gerenciamento. O `requestParameters` campo de cada evento também contém `callWithBearerToken` (e `bearerTokenType` quando aplicável), que são adicionados pelo serviço para cada evento.


**Modelos da**  

| Nome do evento | Rota HTTP | Parâmetros adicionais de solicitação | 
| --- | --- | --- | 
| ListModels | GET /v1/models | nenhuma | 
| GetModel | GET /v1/models/{model} | model | 


**Fine-tuning**  

| Nome do evento | Rota HTTP | Parâmetros adicionais de solicitação | 
| --- | --- | --- | 
| ListFineTuningJobs | GET /v1/fine\_tuning/jobs | nenhuma | 
| CreateFineTuningJob | POST /v1/fine\_tuning/jobs | model,trainingFile,validationFile,metadata, method (objeto estruturado incluindo type e, para aplicações de reforço,grader.lambda.function) | 
| GetFineTuningJob | GET /v1/fine\_tuning/jobs/{id}, /events, /checkpoints | fineTuningJob | 
| CancelFineTuningJob | POST /v1/fine\_tuning/jobs/{id}/cancel | fineTuningJob | 


**Projetos**  

| Nome do evento | Rota HTTP | Parâmetros adicionais de solicitação | 
| --- | --- | --- | 
| ListProjects | GET /v1/organization/projects | nenhuma | 
| 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 | 

## Eventos de dados
<a name="mantle-cloudtrail-data-events"></a>

Os eventos de dados não são registrados por padrão e incorrem em cobranças adicionais CloudTrail . `bedrock-mantle`registra as seguintes operações como eventos de dados. Para capturá-los, configure seletores de eventos avançados em sua trilha ou armazenamento de dados de eventos, conforme descrito em [Registro de eventos de dados](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-data-events-with-cloudtrail.html).


**Inferência**  

| Nome do evento | Rota HTTP | Parâmetros adicionais de solicitação | 
| --- | --- | --- | 
| 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 | 


**Arquivos**  

| Nome do evento | Rota HTTP | Parâmetros adicionais de solicitação | 
| --- | --- | --- | 
| 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 | 

**nota**  
Customer-supplied `metadata`on `CreateInference` calls é logado literalmente. CloudTrail Não inclua segredos, credenciais ou outros valores confidenciais `metadata` se estiver capturando eventos de dados.

## Configurando a captura de eventos de dados
<a name="mantle-cloudtrail-configuring"></a>

O exemplo a seguir configura uma trilha para capturar todos os eventos de `bedrock-mantle` inferência e dados de arquivo:

```
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"
          ]}
        ]
      }
    ]'
```

Além disso, você pode filtrar por `eventName` `resources.ARN` e. Para obter detalhes sobre seletores de eventos avançados, consulte [AdvancedFieldSelector](https://docs.aws.amazon.com/awscloudtrail/latest/APIReference/API_AdvancedFieldSelector.html).

## Resource types
<a name="mantle-cloudtrail-resource-types"></a>

`bedrock-mantle` CloudTrail os eventos fazem referência aos seguintes tipos de recursos:
+ `AWS::BedrockMantle::Project`
+ `AWS::BedrockMantle::Reservation`
+ `AWS::BedrockMantle::CustomizedModel`
+ `AWS::BedrockMantle::Environment`
+ `AWS::BedrockMantle::Runtime`
+ `AWS::BedrockMantle::Skill`

## Exemplo de entrada de log
<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"
    }
}
```

## Diferenças do registro em `tempo de execução básico` CloudTrail
<a name="mantle-cloudtrail-differences"></a>
+ **A inferência é um evento de dados ativado`bedrock-mantle`, um evento de gerenciamento ativado`bedrock-runtime`.** O `bedrock-runtime` endpoint registra [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), e [InvokeModelWithResponseStream](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_InvokeModelWithResponseStream.html)como eventos de gerenciamento sem custo adicional. Os registros do `bedrock-mantle` endpoint `CreateInference` e as outras operações de inferência como eventos de dados, que incorrem em cobranças de eventos de CloudTrail dados. Se você precisar de uma trilha de auditoria de chamadas de inferência ativadas`bedrock-mantle`, deverá habilitar explicitamente a captura de eventos de dados em sua trilha ou armazenamento de dados de eventos.
+ **Fontes de eventos e tipos de recursos diferentes.** `bedrock-mantle`os eventos usam um `eventSource` dos tipos de `AWS::BedrockMantle::*` recursos `bedrock-mantle.amazonaws.com` e de referência. CloudTrail Consultas do Lake, visualizações do Athena e controles de detetive que filtram `bedrock-runtime.amazonaws.com` ou não `bedrock.amazonaws.com` capturam a atividade. `bedrock-mantle`