AWS S3

Learn about other supported AWS services on our AWS docs.

Prerequisites

For Instana agent to be able to collect metrics from S3 instance, paid (request & data transfer) metrics need to be enabled. More on this topic.

Sensor (Data Collection)

Tracked Configuration

  • S3 Bucket Details
  • Bucket Name
  • Bucket Owner Id
  • Bucket Owner Name
  • Bucket Created At
  • Grouping zone (region)

Metrics

Requests

Metric Description
All (Request) The total number of HTTP requests made to an Amazon S3 bucket, regardless of type. If you’re using a metrics configuration with a filter, then this metric only returns the HTTP requests made to the objects in the bucket that meet the filter’s requirements.
Get (Request) The number of HTTP GET requests made for objects in an Amazon S3 bucket. This doesn’t include list operations.
Put (Request) The number of HTTP PUT requests made for objects in an Amazon S3 bucket.
Delete (Request) The number of HTTP DELETE requests made for objects in an Amazon S3 bucket. This also includes Delete Multiple Objects requests. This metric shows the number of requests, not the number of objects deleted.
Head (Request) The number of HTTP HEAD requests made to an Amazon S3 bucket.
Post (Request) The number of HTTP POST requests made to an Amazon S3 bucket.
List (Request) The number of HTTP requests that list the contents of a bucket.

Traffic

Metric Description
Bytes Downloaded The number bytes downloaded for requests made to an Amazon S3 bucket, where the response includes a body.
Bytes Uploaded The number bytes uploaded that contain a request body, made to an Amazon S3 bucket.

Errors

Metric Description
4xx Errors The number of HTTP 4xx client error status code requests made to an Amazon S3 bucket with a value of either 0 or 1. The average statistic shows the error rate, and the sum statistic shows the count of that type of error, during each period.
5xx Errors The number of HTTP 5xx server error status code requests made to an Amazon S3 bucket with a value of either 0 or 1. The average statistic shows the error rate, and the sum statistic shows the count of that type of error, during each period.

Latency

Metric Description
First Byte Latency The per-request time from the complete request being received by an Amazon S3 bucket to when the response starts to be returned.
Total Request Latency The elapsed per-request time from the first byte received to the last byte sent to an Amazon S3 bucket. This includes the time taken to receive the request body and send the response body, which is not included in FirstByteLatency.

Required Permissions

  • cloudwatch:GetMetricData
  • s3:GetBucketTagging
  • s3:ListAllMyBuckets
  • s3:GetBucketLocation

Configuration

Metrics for S3 are pulled every minute, this can be changed via agent configuration:

com.instana.plugin.aws.S3:
  s3_cloudwatch_period: 60

Tags

Please note that tags are currently only available in conjunction with the dedicated AWS Instana agent, described here AWS Agent Installation docs. More detail on using tags is described here.