MetricDatum

Encapsulates the information sent to either create a metric or add new values to be aggregated into an existing metric.

AlarmsAwsDashboardsLogsMetricsMonitoringObservability

Properties

Name	Type	Description
MetricName	string	The name of the metric.
Dimensions	array	The dimensions associated with the metric.
Timestamp	string	The time the metric data was received, expressed as the number of milliseconds since Jan 1, 1970 00:00:00 UTC.
Value	number	The value for the metric. Although the parameter accepts numbers of type Double, CloudWatch rejects values that are either too small or too large.
StatisticValues	object
Values	array	Array of numbers representing the values for the metric during the period.
Counts	array	Array of numbers that is used along with the Values array.
Unit	object
StorageResolution	integer	Valid values are 1 and 60. Setting this to 1 specifies this metric as a high-resolution metric.

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "#/components/schemas/MetricDatum",
  "title": "MetricDatum",
  "type": "object",
  "description": "Encapsulates the information sent to either create a metric or add new values to be aggregated into an existing metric.",
  "required": [
    "MetricName"
  ],
  "properties": {
    "MetricName": {
      "type": "string",
      "minLength": 1,
      "maxLength": 255,
      "description": "The name of the metric.",
      "example": "example_value"
    },
    "Dimensions": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/Dimension"
      },
      "maxItems": 30,
      "description": "The dimensions associated with the metric.",
      "example": []
    },
    "Timestamp": {
      "type": "string",
      "format": "date-time",
      "description": "The time the metric data was received, expressed as the number of milliseconds since Jan 1, 1970 00:00:00 UTC.",
      "example": "2026-01-15T10:30:00Z"
    },
    "Value": {
      "type": "number",
      "format": "double",
      "description": "The value for the metric. Although the parameter accepts numbers of type Double, CloudWatch rejects values that are either too small or too large.",
      "example": 42.5
    },
    "StatisticValues": {
      "$ref": "#/components/schemas/StatisticSet"
    },
    "Values": {
      "type": "array",
      "items": {
        "type": "number",
        "format": "double"
      },
      "description": "Array of numbers representing the values for the metric during the period.",
      "example": []
    },
    "Counts": {
      "type": "array",
      "items": {
        "type": "number",
        "format": "double"
      },
      "description": "Array of numbers that is used along with the Values array.",
      "example": []
    },
    "Unit": {
      "$ref": "#/components/schemas/StandardUnit"
    },
    "StorageResolution": {
      "type": "integer",
      "minimum": 1,
      "description": "Valid values are 1 and 60. Setting this to 1 specifies this metric as a high-resolution metric.",
      "example": 10
    }
  }
}