Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Registro de llamadas a la API para desarrolladores de Amazon Q mediante AWS CloudTrail
Amazon Q Developer Pro está integrado con AWS CloudTrail un servicio que proporciona un registro de las acciones realizadas por un usuario, un rol o una persona Servicio de AWS en Amazon Q. que CloudTrail captura todas las llamadas a la API de Amazon Q como eventos. Las llamadas capturadas incluyen las llamadas desde la consola de Amazon Q y las llamadas de código hacia las operaciones de la API de Amazon Q. Si crea una ruta, puede habilitar la entrega continua de CloudTrail eventos a un bucket de Amazon S3, incluidos los eventos de Amazon Q. Si no configura una ruta, podrá seguir viendo los eventos más recientes en la CloudTrail consola en el **Historial de eventos**. Con la información recopilada por CloudTrail, puedes determinar la solicitud que se realizó a Amazon Q, la dirección IP desde la que se realizó la solicitud, quién la hizo, cuándo se realizó y detalles adicionales.
Para obtener más información al respecto CloudTrail, consulte la [Guía AWS CloudTrail del usuario](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/).
## Información para desarrolladores de Amazon Q en CloudTrail
CloudTrail está habilitada en tu cuenta Cuenta de AWS al crear la cuenta. Cuando se produce una actividad en Amazon Q Developer, esa actividad se registra en un CloudTrail evento junto con otros Servicio de AWS eventos del **historial** de eventos. Puede ver, buscar y descargar los eventos recientes en su Cuenta de AWS. Para obtener más información, consulte [Visualización de eventos con el historial de CloudTrail eventos](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/view-cloudtrail-events.html) en la *Guía del AWS CloudTrail usuario*.
Para tener un registro continuo de tus eventos Cuenta de AWS, incluidos los eventos de Amazon Q, crea una ruta. Un *rastro* permite CloudTrail entregar archivos de registro a un bucket de Amazon S3. De forma predeterminada, cuando se crea un registro de seguimiento en la consola, el registro de seguimiento se aplica a todas las Regiones de AWS. La ruta registra los eventos de todas las regiones de la AWS partición y envía los archivos de registro al bucket de Amazon S3 que especifique. Además, puede configurar otros Servicios de AWS para que analicen más a fondo los datos de eventos recopilados en los CloudTrail registros y actúen en función de ellos. Para obtener más información, consulte los siguientes temas en la *Guía del usuario de AWS CloudTrail *:
+ [Introducción a la creación de registros de seguimiento](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-create-and-update-a-trail.html)
+ [CloudTrail servicios e integraciones compatibles](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-aws-service-specific-topics.html#cloudtrail-aws-service-specific-topics-integrations)
+ [Configuración de las notificaciones de Amazon SNS para CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/getting_notifications_top_level.html)
+ [Recibir archivos de CloudTrail registro de varias regiones](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/receive-cloudtrail-log-files-from-multiple-regions.html)
+ [Recibir archivos de CloudTrail registro de varias cuentas](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-receive-logs-from-multiple-accounts.html)
Todas las acciones de los desarrolladores de Amazon Q se registran CloudTrail y generan entradas en los archivos de CloudTrail registro.
Cada entrada de registro o evento contiene información sobre quién generó la solicitud. La información de identidad del usuario le ayuda a determinar lo siguiente:
+ Si la solicitud se realizó con credenciales de usuario root o AWS Identity and Access Management (IAM)
+ si la solicitud se realizó con credenciales de seguridad temporales de un rol o fue un usuario federado
+ Si la solicitud la realizó otra persona Servicio de AWS
*Para obtener más información, consulte el elemento [CloudTrailUserIdentity en la Guía del usuario.](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-user-identity.html)AWS CloudTrail *
## Descripción de las entradas de archivos de registro de Amazon Q Developer
Un rastro es una configuración que permite la entrega de eventos como archivos de registro a un bucket de Amazon S3 que usted especifique. CloudTrail Los archivos de registro contienen una o más entradas de registro. Un evento representa una solicitud única de cualquier fuente e incluye información sobre la acción solicitada, la fecha y la hora de la acción, los parámetros de la solicitud, etc. CloudTrail Los archivos de registro no son un registro ordenado de las llamadas a la API pública, por lo que no aparecen en ningún orden específico.
Amazon Q Developer también realiza llamadas a la API con un parámetro `dryRun` para comprobar que tiene los permisos necesarios para la acción, sin realizar realmente la solicitud. Las llamadas a Amazon Q Developer APIs con el `dryRun` parámetro se capturan como eventos y se registran en un CloudTrail registro `"dryRun" : true` en el `requestParameters` campo.
En el siguiente ejemplo, se muestra una entrada de CloudTrail registro que demuestra la `SendMessage` acción.
```
{
"eventVersion": "1.08",
"userIdentity": {
"type": "AssumedRole",
"principalId": "AROAXD12ABCDEF3G4HI5J:aws-user",
"arn": "arn:aws:sts::123456789012:assumed-role/PowerUser/aws-user",
"accountId": "123456789012",
"accessKeyId": "ASIAAB12CDEFG34HIJK",
"sessionContext": {
"sessionIssuer": {
"type": "Role",
"principalId": "AROAXD12ABCDEF3G4HI5J",
"arn": "arn:aws:iam::123456789012:role/PowerUser",
"accountId": "123456789012",
"userName": "PowerUser"
},
"webIdFederationData": {},
"attributes": {
"creationDate": "2023-11-28T10:00:00Z",
"mfaAuthenticated": "false"
}
}
},
"eventTime": "2023-11-28T10:00:00Z",
"eventSource": "q.amazonaws.com",
"eventName": "SendMessage",
"awsRegion": "us-east-1",
"sourceIPAddress": "123.456.789.012",
"userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:109.0) Gecko/20100101 Firefox/115.0",
"requestParameters": {
"Origin": "https://conversational-experience-worker.widget.console.aws.amazon.com",
"conversationId": "a298ec0d-0a49-4d2e-92bd-7d6e629b4619",
"source": "CONSOLE",
"conversationToken": "***",
"utterance": "***"
},
"responseElements": {
"result": {
"content": {
"text": {
"body": "***",
"references": []
}
},
"format": "PLAINTEXT",
"intents": {},
"type": "TEXT"
},
"Access-Control-Expose-Headers": "x-amzn-RequestId,x-amzn-ErrorType,x-amzn-ErrorMessage,Date",
"metadata": {
"conversationExpirationTime": "2024-02-25T19:31:38Z",
"conversationId": "a298ec0d-0a49-4d2e-92bd-7d6e629b4619",
"conversationToken": "***",
"utteranceId": "3b87b46f-04a9-41ef-b8fe-8abf52d2c053"
},
"resultCode": "LLM"
},
"additionalEventData": {
"quickAction": "dev"
},
"requestID": "19b3c30e-906e-4b7f-b5c3-509f67248655",
"eventID": "a552c487-7d97-403a-8ec4-d49539c7a03d",
"readOnly": false,
"eventType": "AwsApiCall",
"managementEvent": true,
"recipientAccountId": "123456789012",
"eventCategory": "Management"
}
```
El siguiente ejemplo muestra una entrada de CloudTrail registro que demuestra la `PassRequest` acción.
```
{
"eventVersion": "1.09",
"userIdentity": {
"type": "AssumedRole",
"principalId": "AIDA6ON6E4XEGIEXAMPLE",
"arn": "arn:aws:iam::555555555555:user/Mary",
"accountId": "555555555555",
"accessKeyId": "AKIAIOSFODNN7EXAMPLE",
"sessionContext": {
"sessionIssuer": {
"type": "Role",
"principalId": "AIDA6ON6E4XEGIEXAMPLE",
"arn": "arn:aws:iam::555555555555:user/Mary",
"accountId": "555555555555",
"userName": "Mary"
},
"attributes": {
"creationDate": "2024-04-10T20:03:01Z",
"mfaAuthenticated": "false"
},
"invokedBy": "q.amazonaws.com"
},
"eventTime": "2024-04-10T20:04:42Z",
"eventSource": "q.amazonaws.com",
"eventName": "PassRequest",
"awsRegion": "us-east-1",
"sourceIPAddress": "q.amazonaws.com",
"userAgent": "q.amazonaws.com",
"requestParameters": null,
"responseElements": null,
"requestID": "2d528c76-329e-410b-9516-EXAMPLE565dc",
"eventID": "ba0801a1-87ec-4d26-be87-EXAMPLE75bbb",
"readOnly": false,
"eventType": "AwsApiCall",
"managementEvent": true,
"recipientAccountId": "555555555555",
"eventCategory": "Management"
}
```
El siguiente ejemplo muestra una entrada de CloudTrail registro que muestra a Amazon Q convocando la `s3:ListBuckets` acción en tu nombre.
```
{
"eventVersion": "1.09",
"userIdentity": {
"type": "AssumedRole",
"principalId": "AIDA6ON6E4XEGIEXAMPLE",
"arn": "arn:aws:iam::555555555555:user/Paulo",
"accountId": "555555555555",
"accessKeyId": "AKIAIOSFODNN7EXAMPLE",
"sessionContext": {
"sessionIssuer": {
"type": "Role",
"principalId": "AIDA6ON6E4XEGIEXAMPLE",
"arn": "arn:aws:iam::555555555555:user/Paulo",
"accountId": "555555555555",
"userName": "Paulo"
},
"attributes": {
"creationDate": "2024-04-10T14:06:08Z",
"mfaAuthenticated": "false"
}
},
"invokedBy": "q.amazonaws.com"
},
"eventTime": "2024-04-10T14:07:55Z",
"eventSource": "s3.amazonaws.com",
"eventName": "ListBuckets",
"awsRegion": "us-east-1",
"sourceIPAddress": "q.amazonaws.com",
"userAgent": "q.amazonaws.com",
"requestParameters": {
"Host": "s3.amazonaws.com"
},
"responseElements": null,
"additionalEventData": {
"SignatureVersion": "SigV4",
"CipherSuite": "ECDHE-RSA-AES128-GCM-SHA256",
"bytesTransferredIn": 0,
"AuthenticationMethod": "AuthHeader",
"x-amz-id-2": "ExampleRequestId123456789",
"bytesTransferredOut": 4054
},
"requestID": "ecd94349-b36f-44bf-b6f5-EXAMPLE9c463",
"eventID": "2939ba50-1d26-4a5a-83bd-EXAMPLE85850",
"readOnly": true,
"eventType": "AwsApiCall",
"managementEvent": true,
"recipientAccountId": "555555555555",
"vpcEndpointId": "vpce-EXAMPLE1234",
"eventCategory": "Management"
}
```