AWS Data Stream Parameters

The AWS plugin provides configurable data streams to fetch cost data and service metrics.

Each configurable data stream exposes a set of parameters that lets you filter the data you retrieve. The following information describes the available configurable data streams and their parameters in detail.

Account Cost (Configurable)

Parameter
Description
Metric
Specify the metric name from the AWS Cost Explorer.
Granularity
Select the time interval for the data. Choose from Daily, Monthly, or Hourly.
Group by
Optionally, specify a GroupBy clause group your cost data by Dimension, Tag, or Cost Category to break down costs with more granularity. For example: 
[
  {
    "Type": "TAG",
    "Key": "Environment"
  }
]
Filter by
Optionally, specify a filter expression to refine your cost data. For example: 
"Dimensions": {
      "Key": "SERVICE",
      "Values": ["Amazon Elastic Compute Cloud - Compute"]
    }

Example

Metric: Amortized Cost | Granularity: Monthly | Group by: {"Key": "SERVICE", "Type": "DIMENSION"}

Cost (Global - Configurable).

Parameter
Description
Metric
Enter the metric name from the Cost Explorer.
Granularity
Select the data granularity.
Group By
Add grouping for the cost request by DIMENSION, TAG, or COST.
Filter By
Add filtering for the cost request using an expression.

CloudWatch Logs

Parameter
Description
Region
Specify the AWS region where your CloudWatch logs are located.
Log groups
Specify the name or ARN of each log group you want to query. Press Enter after each entry to add it to the list.
Limit
Enter the maximum number of results to return per query.
Query
Enter a CloudWatch Logs Insights query. Use the syntax supported on the CloudWatch > Logs Insights page in the AWS console. See the documentation on CloudWatch Logs Insights queries for reference.

CloudWatch Metrics by Query

Parameter
Description
Region
Specify the AWS region where your CloudWatch metrics are located.
Query type
Select how to supply the metrics query. Choose from:
  • Standard: Use the query builder fields that display when this option is selected.
  • Advanced: Enter a CloudWatch Metric Insights SQL Query in the Query field that displays. Alternatively you can copy the Enter a CloudWatch Metric Insights SQL Query (or copy the JSON from CloudWatch Metrics source tab.
Cross-account observability
Choose which AWS account to read data from. Linked accounts can only be used if CloudWatch Cross-account observability is enabled for the AWS account. Choose from:
  • Primary AWS account: Uses the account same account used to authenticate AWS when configuring the data source.
  • Linked AWS account: Enables querying of metrics from the account you specify in the Linked account field.
Metric namespace
Specify a metric namespace. Standard AWS namespaces are listed and custom namespaces must be entered manually.
Metric name
Specify the name of the CloudWatch metric you want to query.
Statistic
Specify statistics to aggregate data by. You can enter a CloudWatch statistic even if it is not available in the list. See CloudWatch statistics definitions for a description of each of the statistics.

Which statistics are valid can vary depending on the metric. Refer to the AWS documentation page for clarification.

Dimension name / Dimension value
Some metrics require dimensions to categorize, filter, or group metrics. Specify up to four Dimension name and Dimension value fields as needed.
The order of the dimensions does not matter, but not all combinations of dimensions return data.
Period
Enter the aggregation period for the metric query, optionally using a unit suffix: s for seconds (default), m for minutes, h for hours.
For example 15m or 2h.

CloudWatch Metrics by Resource

Parameter
Description
Metric
Specify the name of the CloudWatch metric you want to query.
Statistic
Specify statistics to aggregate data by. You can enter a CloudWatch statistic even if it is not available in the list. See CloudWatch statistics definitions for a description of each of the statistics.

Which statistics are valid can vary depending on the metric. Refer to the AWS documentation page for clarification.

Period
Enter the aggregation period for the metric query, optionally using a unit suffix: s for seconds (default), m for minutes, h for hours.
For example 15m or 2h.

DynamoDB Metric

Parameter
Description
Metric
Specify the name of the CloudWatch metric you want to query.
Statistic
Specify statistics to aggregate data by. See CloudWatch statistics definitions for a description of each of the statistics.

Which statistics are valid can vary depending on the metric. Refer to the AWS documentation page for clarification.

Operation
Optionally, enter a DynamoDB table operation name (such as GetItem, UpdateItem, DeleteItem etc.) Only required for Table Operation metrics.

S3 Metric

Parameter
Description
Metric
Specify the name of the CloudWatch metric you want to query.
Statistic
Specify statistics to aggregate data by. See CloudWatch statistics definitions for a description of each of the statistics.

Which statistics are valid can vary depending on the metric. Refer to the AWS documentation page for clarification.

Storage type
Select which storage type you want to use as a dimension in your CloudWatch query. Choose from:
  • Standardstorage: The amount of data (in bytes) stored in the S3 Standard storage class.
  • Allstoragetypes: The total bytes stored across all storage classes in the bucket.
  • Other: Depends on the storage class you specify in the Other storage type field.
Other storage type
If Other is selected from the Storage type field, enter the storage type to sue as a dimension.

Timestream Query

Parameter
Description
Region
Specify the AWS region to target.
Query
Enter a Timestream query. Queries must follow Timestream’s SQL syntax, including database, table, measure, and time range references.

Examples

Retrieve CPU utilization over the past hour

SELECT time, measure_value::double AS cpu_utilization
FROM "MetricsDB"."SystemMetrics"
WHERE measure_name = 'cpu_utilization'
  AND time > ago(1h)
ORDER BY time DESC

Aggregate average temperature by device for the last 24 hours

SELECT device_id,
       AVG(measure_value::double) AS avg_temperature
FROM "IoTDB"."SensorReadings"
WHERE measure_name = 'temperature'
  AND time BETWEEN ago(24h) AND now()
GROUP BY device_id

Was this article helpful?

Have more questions or facing an issue?
Submit a ticket