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 name | Metric | Metric name in Mackerel | Unit | Statistics |
|---|---|---|---|---|
| Requests | AllRequests 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 |
integer | Sum |
| SelectBytes | SelectBytesScanned SelectBytesReturned |
s3.select_bytes.scanned s3.select_bytes.returned |
bytes | Sum |
| Bytes | BytesDownloaded BytesUploaded |
s3.bytes.downloaded s3.bytes.uploaded |
bytes | Sum |
| Errors | 4xxErrors 5xxErrors |
s3.errors.4xx s3.errors.5xx |
integer | Sum |
| Latency | FirstByteLatency TotalRequestLatency |
s3.latency.#.minimum s3.latency.#.average s3.latency.#.maximum |
float | Minimum Average Maximum |
| Bucket Size | BucketSizeBytes | s3.bucket_size.STORAGE_TYPE | bytes | Average |
| Number Of Objects | NumberOfObjects | s3.number_of_objects.count | float | Average |
- 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
