Registrar chamadas de API do Amazon Polly em log com o AWS CloudTrail

O Amazon Polly é integrado ao AWS CloudTrail, um serviço que fornece um registro das ações tomadas por um usuário, uma função ou um serviço da AWS no Amazon Polly. O CloudTrail captura todas as chamadas de API para o Amazon Polly como eventos. As chamadas capturadas incluem as chamadas do console do Amazon Polly e as chamadas de código para as operações da API do Amazon Polly. Se você criar uma trilha, poderá habilitar a entrega contínua de eventos do CloudTrail para um bucket do Amazon S3, incluindo eventos para o Amazon Polly. Se você não configurar uma trilha, ainda poderá visualizar os eventos mais recentes no console do CloudTrail em Histórico de eventos. Usando as informações coletadas pelo CloudTrail, é possível determinar a solicitação feita para o Amazon Polly, 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 o CloudTrail, incluindo como configurá-lo e ativá-lo, consulte o AWS CloudTrail Guia do usuário do.

Informações sobre o Amazon Polly no CloudTrail

O CloudTrail é habilitado em sua conta AWS ao criá-la. Quando a atividade do evento compatível ocorrer no Amazon Polly, ela será registrada em um evento do CloudTrail juntamente com outros eventos de serviços da AWS no Histórico de eventos. É possível visualizar, pesquisar e baixar eventos recentes em sua AWS conta. Para obter mais informações, consulte Visualização de eventos com o histórico de eventos do CloudTrail.

Para obter um registro contínuo de eventos da conta da AWS, incluindo eventos do Amazon Polly, crie uma trilha. Uma trilha permite que o CloudTrail entregue arquivos de log a um bucket do Amazon S3. Por padrão, quando uma trilha é criada no console, a mesma é aplicada a todas as regiões da AWS. A trilha registra logs de eventos de todas as Regiões na AWS divisória e entrega os arquivos do log para o bucket Amazon S3 especificado. Além disso, é possível configurar outros AWS serviços para melhor analisar e agir de acordo com dados coletados do evento nos logs CloudTrail. Para obter mais informações, consulte:

O Amazon Polly é compatível com as seguintes ações como eventos nos arquivos de log do CloudTrail:

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

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

Exemplo: entradas de arquivo de log do Amazon Polly

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

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

{
"Records": [
        {
"awsRegion": "us-east-2", 
            "eventID": "19bd70f7-5e60-4cdc-9825-936c552278ae", 
            "eventName": "SynthesizeSpeech", 
            "eventSource": "polly.amazonaws.com", 
            "eventTime": "2016-11-02T03:49:39Z", 
            "eventType": "AwsApiCall", 
            "eventVersion": "1.05", 
            "recipientAccountId": "123456789012", 
            "requestID": "414288c2-a1af-11e6-b17f-d7cfc06cb461", 
            "requestParameters": {
"lexiconNames": [
                    "SampleLexicon"
                ],
                "engine": "neural", 
                "outputFormat": "mp3", 
                "sampleRate": "22050", 
                "text": "**********", 
                "textType": "text", 
                "voiceId": "Kendra"
            }, 
            "responseElements": null,
            "sourceIPAddress": "1.2.3.4", 
            "userAgent": "Amazon CLI/Polly 1.10 API 2016-06-10",
            "userIdentity": {
"accessKeyId": "EXAMPLE_KEY_ID", 
                "accountId": "123456789012", 
                "arn": "arn:aws:iam::123456789012:user/Alice", 
                "principalId": "EX_PRINCIPAL_ID", 
                "type": "IAMUser", 
                "userName": "Alice"
            }
        }

    ]
}