Como registrar em log de chamadas de APIs do Amazon Lex V2 comAWS CloudTrail

O Amazon Lex V2 é integrado aoAWS CloudTrail, um serviço que fornece um registro das ações tomadas por um usuário, uma função ou umAWS serviço da no Amazon Lex V2. CloudTrail O captura as chamadas de API para o Amazon Lex V2 como eventos. As chamadas capturadas incluem chamadas do console do Amazon Lex V2 e chamadas de código para as operações da API Amazon Lex V2. Se você criar uma trilha, poderá habilitar a entrega contínua de CloudTrail eventos para um bucket do Amazon S3, incluindo eventos para o Amazon Lex V2. Se não configurar uma trilha, você ainda poderá visualizar os eventos mais recentes no console do CloudTrail em Event history. Usando as informações coletadas pelo CloudTrail, é possível determinar a solicitação feita ap Amazon Lex V2, o endereço IP do qual a solicitação foi feita, quem fez a solicitação, quando ela foi feita e detalhes adicionais.

Para saber mais sobre isso CloudTrail, consulte o GuiaAWS CloudTrail do usuário.

Informações sobre o Amazon Lex V2 em CloudTrail

CloudTrail O está habilitado na suaAWS conta da ao criá-la. Quando ocorre uma atividade no Amazon Lex V2, essa atividade é registrada em um CloudTrail evento junto com outros eventos deAWS serviços da no Event history (Histórico de eventos). Você pode visualizar, pesquisar e baixar eventos recentes em sua conta da AWS. Para obter mais informações, consulte Visualização de eventos com o histórico de CloudTrail eventos.

Para obter um registro de eventos em andamento na suaAWS conta da, incluindo eventos do Amazon Lex V2, crie uma trilha. Uma trilha permite CloudTrail entregar arquivos de log a um bucket do Amazon S3. Por padrão, quando você cria uma trilha no console, ela é aplicada a todas as regiões da AWS. A trilha registra em log eventos de todas as regiões na partição da AWS e entrega os arquivos de log para o bucket do Amazon S3 especificado por você. Além disso, é possível configurar outros serviços da AWS para analisar mais profundamente e agir sobre os dados de evento coletados nos logs do CloudTrail . Para obter mais informações, consulte as informações a seguir.

• Visão geral da criação de uma trilha

• CloudTrail serviços e integrações suportados

• Configurar notificações do Amazon SNS para o CloudTrail

• CloudTrail Receiving log files from multiple regions e CloudTrail Receiving log files from multiple accounts

O Amazon Lex V2 oferece suporte ao registro de todas as ações listadas na API de construção de modelos V2.

Cada entrada de log ou evento contém informações sobre quem gerou a solicitação. As informações de identidade ajudam a determinar:

• Se a solicitação foi feita com credenciais de usuário raiz ou do AWS Identity and Access Management (IAM).

• Se a solicitação foi feita com credenciais de segurança temporárias de uma função ou de um usuário federado.

• Se a solicitação foi feita por outro serviço da AWS.

Para obter mais informações, consulte Elemento userIdentity do CloudTrail .

Entendendo as entradas de arquivo de log do Amazon Lex V2

Uma trilha é uma configuração que permite a entrega de eventos como arquivos de log a um bucket do Amazon S3 especificado. CloudTrail Os arquivos de log contêm uma ou mais entradas de log. Um evento representa uma única solicitação de qualquer origem e inclui informações sobre a ação solicitada, a data e a hora da ação, os parâmetros de solicitação e assim por diante. CloudTrail Os arquivos de log não são um rastreamento de pilha ordenada de chamadas de API pública.

O exemplo a seguir mostra uma entrada de CloudTrail log que demonstra a CreateBotAliasação.

{
    "eventVersion": "1.05",
    "userIdentity": {
        "type": "AssumedRole",
        "principalId": "ID of caller:temporary credentials",
        "arn": "arn:aws:sts::111122223333:assumed-role/role name/role ARN",
        "accountId": "111122223333",
        "accessKeyId": "AKIAIOSFODNN7EXAMPLE",
        "sessionContext": {
            "sessionIssuer": {
                "type": "Role",
                "principalId": "ID of caller",
                "arn": "arn:aws:iam::111122223333:role/role name",
                "accountId": "111122223333",
                "userName": "role name"
            },
            "webIdFederationData": {},
            "attributes": {
                "mfaAuthenticated": "false",
                "creationDate": "creation date"
            }
        }
    },
    "eventTime": "event timestamp",
    "eventSource": "lex.amazonaws.com",
    "eventName": "CreateBotAlias",
    "awsRegion": "Region",
    "sourceIPAddress": "192.0.2.0",
    "userAgent": "user agent",
    "requestParameters": {
        "botAliasLocaleSettingsMap": {
            "en_US": {
                "enabled": true
            }
        },
        "botId": "bot ID",
        "botAliasName": "bot aliase name",
        "botVersion": "1"
    },
    "responseElements": {
        "botAliasLocaleSettingsMap": {
            "en_US": {
                "enabled": true
            }
        },
        "botAliasId": "bot alias ID",
        "botAliasName": "bot alias name",
        "botId": "bot ID",
        "botVersion": "1",
        "creationDateTime": creation timestamp
    },
    "requestID": "unique request ID",
    "eventID": "unique event ID",
    "readOnly": false,
    "eventType": "AwsApiCall",
    "recipientAccountId": "111122223333"
}