CloudWatch (Metrics & Alarms)

Amazon CloudWatch metrics, alarms, dashboards, anomaly detectors, insight rules, and metric streams. awsQuery protocol.

fakecloud implements Amazon CloudWatch's metrics-and-alarms surface (the monitoring SigV4 service, awsQuery protocol) — distinct from CloudWatch Logs, which is a separate service. All 46 operations are implemented with persisted in-memory state.

Status: full control plane. Metrics are stored in memory and do not persist across server restarts; alarm evaluation is driven by the metric data you publish, not by a background sampling loop.

Supported today

  • Metrics — PutMetricData, GetMetricData, GetMetricStatistics, ListMetrics, GetMetricWidgetImage (returns a deterministic PNG blob). Custom namespaces, dimensions, and statistics round-trip.
  • Alarms — PutMetricAlarm, PutCompositeAlarm, DescribeAlarms, DescribeAlarmsForMetric, DescribeAlarmHistory, DeleteAlarms, SetAlarmState, EnableAlarmActions, DisableAlarmActions, DescribeAlarmContributors. Threshold transitions trigger configured SNS / Application Auto Scaling / EC2 actions.
  • Dashboards — PutDashboard, GetDashboard, ListDashboards, DeleteDashboards.
  • Anomaly detectors — PutAnomalyDetector, DescribeAnomalyDetectors, DeleteAnomalyDetector (single-metric, metric-math, and metric-stat detectors).
  • Insight rules — PutInsightRule, DescribeInsightRules, EnableInsightRules, DisableInsightRules, DeleteInsightRules, GetInsightRuleReport, plus managed rules (PutManagedInsightRules, ListManagedInsightRules).
  • Metric streams — PutMetricStream, GetMetricStream, ListMetricStreams, StartMetricStreams, StopMetricStreams, DeleteMetricStream. State flips between running and stopped.
  • Alarm mute rules — PutAlarmMuteRule, GetAlarmMuteRule, ListAlarmMuteRules, DeleteAlarmMuteRule.
  • OTel enrichment — GetOTelEnrichment, StartOTelEnrichment, StopOTelEnrichment.
  • Tagging — TagResource, UntagResource, ListTagsForResource.

Introspection

Two IAM-bypass admin endpoints expose CloudWatch state so test assertions don't have to round-trip through the AWS SDK:

  • GET /_fakecloud/cloudwatch/alarms — every metric and composite alarm across all accounts and regions. Each entry carries accountId, region, name, type (metric or composite), state, stateReason, stateUpdatedTimestamp, actionsEnabled, and the alarmActions / okActions / insufficientDataActions lists. Metric alarms add namespace, metricName, threshold, comparisonOperator; composite alarms add alarmRule. Sorted by account, region, name.
  • GET /_fakecloud/cloudwatch/metrics — every unique metric series keyed by (account, region, namespace, metric, dimensions). Each entry carries dimensions ([{name, value}]), datapointCount, and latest ({timestamp, value, unit} or null). Sorted by account, region, namespace, metric.

All first-party SDKs ship a cloudwatch sub-client wrapping these endpoints (getAlarms(), getMetrics()). See reference/introspection for the full endpoint catalog.

Not implemented

  • No background metric sampling — alarms evaluate against the data points you publish via PutMetricData / SetAlarmState.
  • Metric data is in-memory only and is lost on restart.
  • Metric streams persist configuration and state but do not actually fan out data points to the configured Firehose.