Up-to-date reference of API arguments for CES metric data v1 you can get at documentation portal

opentelekomcloud_ces_metric_data_v1

Get details about CES metric data within OpenTelekomCloud.

Example Usage

data "opentelekomcloud_ces_metric_data_v1" "metric_data_1" {
  namespace   = "TEST.TF_ACC"
  metric_name = "cpu_util"
  from        = "1257892000000"
  to          = "1257895000000"
  period      = 1
  filter      = "average"
  dim0        = "instance_id,72d1377e-09e4-47bd-8ea4-71a815d4815d"
}

Argument Reference

The following arguments are supported:

  • namespace - (Required, String) Specifies the namespace of a service.

  • metric_name - (Required, String) Specifies the metric name.

  • from - (Required, String) Specifies the start time of the query. The time is a UNIX timestamp and the unit is ms. Rollup aggregates the raw data generated within a period to the start time of the period. If from and to are within a period, the query result will be empty due to the rollup failure. Set from to at least one period earlier than the current time. Take the 5-minute period as an example. If it is 10:35 now, the raw data generated between 10:30 and 10:35 will be aggregated to 10:30. In this example, if period is 5 minutes, from should be 10:30.

  • to - (Required, String) Specifies the end time of the query. The time is a UNIX timestamp and the unit is ms. from must be earlier than to.

  • period - (Required, Integer) Specifies how often Cloud Eye aggregates data. Possible values are:

    • 1: Cloud Eye performs no aggregation and displays raw data.

    • 300: Cloud Eye aggregates data every 5 minutes.

    • 1200: Cloud Eye aggregates data every 20 minutes.

    • 3600: Cloud Eye aggregates data every hour.

    • 14400: Cloud Eye aggregates data every 4 hours.

    • 86400: Cloud Eye aggregates data every 24 hours.

  • filter - (Required, String) Specifies the data rollup method. Possible values are:

    • average: Cloud Eye calculates the average value of metric data within a rollup period.

    • max: Cloud Eye calculates the maximum value of metric data within a rollup period.

    • min: Cloud Eye calculates the minimum value of metric data within a rollup period.

    • sum: Cloud Eye calculates the sum of metric data within a rollup period.

    • variance: Cloud Eye calculates the variance value of metric data within a rollup period.

    -> NOTE: Rollup uses a rollup method to aggregate raw data generated within a specific period. Take the 5-minute period as an example. If it is 10:35 now, the raw data generated between 10:30 and 10:35 will be aggregated to 10:30.

  • dim0 - (Required, String) Specifies the metric dimension. The format is key,value. key cannot exceed 32 characters and value cannot exceed 256 characters. For example: instance_id,72d1377e-09e4-47bd-8ea4-71a815d4815d

  • dim1 - (Optional, String) Specifies the additional metric dimension. The format is same as dim0.

Attributes Reference

In addition to the arguments mentioned above, the following attributes are exported:

  • datapoints - Specifies the metric data list. Since Cloud Eye rounds up from based on the level of granularity for data query, datapoints may contain more data points than expected. The structure is described below.

    • average - Specifies the average value of metric data within a rollup period.

    • max - Specifies the maximum value of metric data within a rollup period.

    • min - Specifies the minimum value of metric data within a rollup period.

    • sum - Specifies the sum of metric data within a rollup period.

    • variance - Specifies the variance of metric data within a rollup period.

    • timestamp - Specifies when the metric is collected. It is a UNIX timestamp in milliseconds.

    • unit - Specifies the metric unit.

last updated: UTC - commit: