Registre e monitore com AWS CloudTrail - Amazon Location Service

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á.

Registre e monitore com AWS CloudTrail

AWS CloudTrail é um serviço que fornece um registro das ações realizadas por um usuário, função ou AWS serviço. CloudTrail grava todas as API chamadas como eventos. Você pode usar o Amazon Location Service com CloudTrail para monitorar suas API chamadas, que incluem chamadas do console do Amazon Location Service e AWS SDK chamadas para as API operações do Amazon Location Service.

Ao criar uma trilha, você pode habilitar a entrega contínua de CloudTrail eventos para um bucket do S3, incluindo eventos para o Amazon Location Service. Se você não configurar uma trilha, ainda poderá ver os eventos mais recentes no CloudTrail console no Histórico de eventos. Usando as informações coletadas por CloudTrail, você pode determinar a solicitação que foi feita ao Amazon Location Service, o endereço IP a partir do qual a solicitação foi feita, quem fez a solicitação, quando ela foi feita e detalhes adicionais.

Para obter mais informações sobre CloudTrail, consulte o Guia AWS CloudTrail do usuário.

Informações do Amazon Location Service em CloudTrail

CloudTrail é ativado em sua AWS conta quando você cria a conta. Quando a atividade ocorre no Amazon Location Service, essa atividade é registrada em um CloudTrail evento junto com outros eventos do AWS serviço no histórico de eventos. Você pode visualizar, pesquisar e baixar eventos recentes em sua AWS conta. Para obter mais informações, consulte Visualização de eventos com histórico de CloudTrail eventos.

Para um registro contínuo dos eventos em sua AWS conta, incluindo eventos do Amazon Location Service, crie uma trilha. Uma trilha permite CloudTrail entregar arquivos de log para um bucket do S3. Por padrão, ao criar uma trilha no console, ela é aplicada a todas as regiões da AWS . A trilha registra eventos de todas as regiões na AWS partição e entrega os arquivos de log ao bucket do S3 que você especificar. Além disso, você pode configurar outros AWS serviços para analisar e agir com base nos dados de eventos coletados nos CloudTrail registros.

Para obter mais informações, consulte as informações a seguir.

Todas as ações do Amazon Location Service são registradas CloudTrail e documentadas nas APIreferências do Amazon Location Service. Por exemplo, chamadas para o CreateTracker UpdateTracker e DescribeTracker as ações geram entradas nos arquivos de CloudTrail log.

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 root ou AWS Identity and Access Management (IAM).

  • Com credenciais de segurança temporárias para uma função ou um usuário federado.

  • Por outro AWS serviço.

Para obter mais informações, consulte o CloudTrail userIdentityElemento.

Saiba mais sobre as entradas do arquivo de log do Amazon Location Service

Uma trilha é uma configuração que permite a entrega de eventos como arquivos de log para um bucket do S3 que você especifica ou para o Amazon CloudWatch Logs. Para obter mais informações, consulte Como trabalhar com arquivos de CloudTrail log no Guia AWS CloudTrail do usuário.

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 operação solicitada, a data e a hora da operação, os parâmetros de solicitação etc.

nota

CloudTrail os arquivos de log não são um rastreamento de pilha ordenado das API chamadas públicas, portanto, eles não aparecem em nenhuma ordem específica. Para determinar a ordem das operações, use eventTime.

O exemplo a seguir mostra uma entrada de CloudTrail registro que demonstra a CreateTracker operação, que cria um recurso de rastreador.

{ "eventVersion": "1.05", "userIdentity": { "type": "AssumedRole", "principalId": "123456789012", "arn": "arn:aws:geo:us-east-1:123456789012:tracker/ExampleTracker" "accountId": "123456789012", "accessKeyId": "123456789012", "sessionContext": { "sessionIssuer": { "type": "Role", "principalId": "123456789012", "arn": "arn:aws:geo:us-east-1:123456789012:tracker/ExampleTracker", "accountId": "123456789012", "userName": "exampleUser", }, "webIdFederationData": {}, "attributes": { "mfaAuthenticated": "false", "creationDate": "2020-10-22T16:36:07Z" } } }, "eventTime": "2020-10-22T17:43:30Z", "eventSource": "geo.amazonaws.com", "eventName": "CreateTracker", "awsRegion": "us-east-1", "sourceIPAddress": "192.0.2.0/24—TEST-NET-1", "userAgent": "aws-internal/3 aws-sdk-java/1.11.864 Linux/4.14.193-110.317.amzn2.x86_64 OpenJDK_64-Bit_Server_VM/11.0.8+10-LTS java/11.0.8 kotlin/1.3.72 vendor/Amazon.com_Inc. exec-env/AWS_Lambda_java11", "requestParameters": { "TrackerName": "ExampleTracker", "Description": "Resource description" }, "responseElements": { "TrackerName": "ExampleTracker", "Description": "Resource description" "TrackerArn": "arn:partition:service:region:account-id:resource-id", "CreateTime": "2020-10-22T17:43:30.521Z" }, "requestID": "557ec619-0674-429d-8e2c-eba0d3f34413", "eventID": "3192bc9c-3d3d-4976-bbef-ac590fa34f2c", "readOnly": false, "eventType": "AwsApiCall", "recipientAccountId": "123456789012", }

Veja a seguir uma entrada de log da operação DescribeTracker, que retorna os detalhes de um recurso do rastreador.

{ "eventVersion": "1.05", "userIdentity": { "type": "AssumedRole", "principalId": "123456789012", "arn": "arn:partition:service:region:account-id:resource-id", "accountId": "123456789012", "accessKeyId": "123456789012", "sessionContext": { "sessionIssuer": { "type": "Role", "principalId": "123456789012", "arn": "arn:partition:service:region:account-id:resource-id", "accountId": "123456789012", "userName": "exampleUser", }, "webIdFederationData": {}, "attributes": { "mfaAuthenticated": "false", "creationDate": "2020-10-22T16:36:07Z" } } }, "eventTime": "2020-10-22T17:43:33Z", "eventSource": "geo.amazonaws.com", "eventName": "DescribeTracker", "awsRegion": "us-east-1", "sourceIPAddress": "192.0.2.0/24—TEST-NET-1", "userAgent": "aws-internal/3 aws-sdk-java/1.11.864 Linux/4.14.193-110.317.amzn2.x86_64 OpenJDK_64-Bit_Server_VM/11.0.8+10-LTS java/11.0.8 kotlin/1.3.72 vendor/Amazon.com_Inc. exec-env/AWS_Lambda_java11", "requestParameters": { "TrackerName": "ExampleTracker" }, "responseElements": null, "requestID": "997d5f93-cfef-429a-bbed-daab417ceab4", "eventID": "d9e0eebe-173c-477d-b0c9-d1d8292da103", "readOnly": true, "eventType": "AwsApiCall", "recipientAccountId": "123456789012", }