Skip to content

AWS Integration - S3

Mackerel supports obtaining and monitoring Amazon Simple Storage Service (S3) metrics in AWS Integration. When integrating with AWS Integration, billable targets are determined using the conversion 1 bucket = 1 Micro Host.

Please refer to the following page for AWS Integration configuration methods and a list of supported AWS services.
AWS Integration

Additionally, in order to integrate, bucket request metrics must be configured in S3. Refer to Creating a CloudWatch metrics configuration for all the objects in your bucket regarding configuration methods.

  • Set the filter name to EntireBucket.

Obtaining metrics

The metrics obtainable with AWS Integration's support for S3 are as follows. For Metric explanations, refer to the AWS help page.

The maximum number of obtainable metrics can be calculated using the formula 21 + 1 × (Number of storage types)

Enter the storage class in place of STORAGE_TYPE in the metric name.

Graph nameMetricMetric name in MackerelUnitStatistics
RequestsAllRequests
GetRequests
PutRequests
DeleteRequests
HeadRequests
PostRequests
SelectRequests
ListRequests
s3.requests.all_requests
s3.requests.get_requests
s3.requests.put_requests
s3.requests.delete_requests
s3.requests.head_requests
s3.requests.post_requests
s3.requests.select_requests
s3.requests.list_requests
integerSum
SelectBytesSelectBytesScanned
SelectBytesReturned
s3.select_bytes.scanned
s3.select_bytes.returned
bytesSum
BytesBytesDownloaded
BytesUploaded
s3.bytes.downloaded
s3.bytes.uploaded
bytesSum
Errors4xxErrors
5xxErrors
s3.errors.4xx
s3.errors.5xx
integerSum
LatencyFirstByteLatency
TotalRequestLatency
s3.latency.#.minimum
s3.latency.#.average
s3.latency.#.maximum
floatMinimum
Average
Maximum
Bucket SizeBucketSizeBytess3.bucket_size.STORAGE_TYPEbytesAverage
Number Of ObjectsNumberOfObjectss3.number_of_objects.countfloatAverage
  • Either "FirstByte" or "TotalRequest" goes in for the # under "Metric name in Mackerel".

Notes

- Since S3 is a global service, integration with S3 is possible regardless of the region selected. - Filters can be defined for request metrics, however metrics for the entire bucket are retrieved in AWS Integration. - Of the graphs/metrics obtainable with AWS integration, metrics included in following graphs will be retrieved at a daily interval. - Bucket Size - Number Of Objects