Monitoring AWS Abuse Signal API
You can monitor API activity for AWS Abuse Signal API using AWS CloudTrail, which records the API calls made in your AWS account. CloudTrail captures these calls as events that you can view, search, and deliver to storage for an ongoing record. Use this record to understand which requests were made, who made them, and when.
AWS Abuse Signal API does not publish Amazon CloudWatch metrics to your AWS account. AWS CloudTrail provides monitoring for AWS Abuse Signal API.
Logging AWS Abuse Signal API calls using AWS CloudTrail
AWS Abuse Signal API is integrated with AWS CloudTrail, a service that provides a record of actions taken by a user, role, or an AWS service. CloudTrail captures API calls for AWS Abuse Signal API as events. For more information, see the AWS CloudTrail User Guide.
CloudTrail is enabled on your AWS account when you create the account. With Event history, you can view recent management events for your account with no additional setup. For an ongoing record of activity, create a trail to deliver events to an Amazon S3 bucket that you specify. Using the information that CloudTrail collects, you can determine the request that was made to AWS Abuse Signal API, the source IP address from which the request was made, who made the request, and when it was made.
AWS Abuse Signal API management events in CloudTrail
Management events provide information about management operations that are performed in your AWS account. CloudTrail logs management events by default, and they appear in Event history with no additional configuration and no additional charge.
AWS Abuse Signal API logs ListAbuseReportStatuses as a management event.
For more information, see Logging management events in the AWS CloudTrail User Guide.
AWS Abuse Signal API data events in CloudTrail
Data events provide information about the resource operations performed on or in a resource. CloudTrail does not log data events by default. To record them, configure advanced event selectors on a trail or event data store that include the resource type AWS::Abuse::Report.
AWS Abuse Signal API logs CreateAbuseReport and GetAbuseReportStatus as data events.
Additional charges apply for logging data events. For more information, see AWS CloudTrail Pricing
For more information about enabling data events, see Logging data events in the AWS CloudTrail User Guide.
To protect the privacy of report content, the report field is redacted in the logged CreateAbuseReport event and appears as "*".
CloudTrail records each event in the AWS Region that served the request, which is the Regional endpoint you called or the Region that the global endpoint routed to.
AWS Abuse Signal API event examples
A CloudTrail event represents a single request from any source and includes information about the requested operation, the date and time of the operation, request parameters, and so on. CloudTrail events are not an ordered stack trace of the public API calls, so they don’t appear in any specific order.
The following example shows a CloudTrail data event for the CreateAbuseReport operation. The report field in requestParameters is redacted to protect report content.
{ "eventVersion": "1.09", "userIdentity": { "type": "IAMUser", "principalId": "AIDACKCEVSQ6C2EXAMPLE", "arn": "arn:aws:iam::111122223333:user/Mary_Major", "accountId": "111122223333", "userName": "Mary_Major" }, "eventTime": "2024-11-18T15:04:21Z", "eventSource": "abuse.amazonaws.com", "eventName": "CreateAbuseReport", "awsRegion": "us-east-1", "sourceIPAddress": "192.0.2.1", "userAgent": "aws-sdk-java/2.25.0", "requestParameters": { "report": "***" }, "responseElements": { "reportId": "EXAMPLE11-2222-3333-4444-555566667777" }, "resources": [ { "type": "AWS::Abuse::Report", "ARN": "arn:aws:abuse:us-east-1:111122223333:report/EXAMPLE11-2222-3333-4444-555566667777" } ], "requestID": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "eventID": "b2c3d4e5-6789-01ab-cdef-EXAMPLE22222", "readOnly": false, "eventType": "AwsApiCall", "managementEvent": false, "eventCategory": "Data", "recipientAccountId": "111122223333" }
The following example shows a CloudTrail management event for the ListAbuseReportStatuses operation. Because the operation is read-only, responseElements is null.
{ "eventVersion": "1.09", "userIdentity": { "type": "IAMUser", "principalId": "AIDACKCEVSQ6C2EXAMPLE", "arn": "arn:aws:iam::111122223333:user/Mary_Major", "accountId": "111122223333", "userName": "Mary_Major" }, "eventTime": "2024-11-18T15:06:48Z", "eventSource": "abuse.amazonaws.com", "eventName": "ListAbuseReportStatuses", "awsRegion": "us-east-1", "sourceIPAddress": "192.0.2.1", "userAgent": "aws-sdk-java/2.25.0", "requestParameters": null, "responseElements": null, "requestID": "c3d4e5f6-7890-12ab-cdef-EXAMPLE33333", "eventID": "d4e5f6a7-8901-23ab-cdef-EXAMPLE44444", "readOnly": true, "eventType": "AwsApiCall", "managementEvent": true, "eventCategory": "Management", "recipientAccountId": "111122223333" }