AWS AmazonCloudWatch documentation change
Summary
Restructured metrics documentation to emphasize OpenTelemetry as the recommended approach, added comparison table between OpenTelemetry and classic CloudWatch metrics, and updated getting started guidance.
Security assessment
The changes focus on architectural improvements and feature promotion without addressing vulnerabilities or security mechanisms. No security-related terms or vulnerability fixes are present.
Diff
diff --git a/AmazonCloudWatch/latest/monitoring/working_with_metrics.md b/AmazonCloudWatch/latest/monitoring/working_with_metrics.md index 5a8151018..d73400fd0 100644 --- a//AmazonCloudWatch/latest/monitoring/working_with_metrics.md +++ b//AmazonCloudWatch/latest/monitoring/working_with_metrics.md @@ -7,7 +7 @@ -# Metrics in Amazon CloudWatch - -Metrics are data about the performance of your systems. Amazon CloudWatch collects metrics through two paths: AWS vended metrics from services such as Amazon EC2, Amazon EBS, and Amazon RDS, and custom metrics that you publish using the OpenTelemetry Protocol (OTLP) or the CloudWatch API. Many AWS services provide free metrics for resources by default. You can also enable detailed monitoring for some resources, such as Amazon EC2 instances. - -CloudWatch supports two query languages for metrics. The Prometheus Query Language (PromQL) provides flexible analytics for OpenTelemetry metrics and AWS vended metrics published in OpenTelemetry format. CloudWatch Metrics Insights provides a SQL-based query engine for traditional CloudWatch metrics. Both support graphing, dashboards, and alarms. - -Key Topics: +Overview @@ -15,7 +9 @@ Key Topics: - * [Metrics concepts](./cloudwatch_concepts.html) - - * [Basic monitoring and detailed monitoring in CloudWatch](./cloudwatch-metrics-basic-detailed.html) - - * [Publish custom metrics](./publishingMetrics.html) - - * [Send metrics using OpenTelemetry (new)](./CloudWatch-OpenTelemetry-Sections.html) +# Metrics in Amazon CloudWatch @@ -23 +11 @@ Key Topics: - * [Publish AWS vended metrics as OpenTelemetry metrics (new)](./publishingMetrics.html) +Metrics are data about the performance of your systems. Amazon CloudWatch collects metrics through two paths: AWS vended metrics from services such as Amazon EC2, Amazon EBS, and Amazon RDS, and custom metrics that you publish using the OpenTelemetry Protocol (OTLP) or the CloudWatch API. @@ -25 +13 @@ Key Topics: - * [Query metrics with PromQL (new)](./CloudWatch-PromQL.html) +## Overview @@ -27 +15 @@ Key Topics: - * [Query your CloudWatch metrics with CloudWatch Metrics Insights](./query_with_cloudwatch-metrics-insights.html) +### OpenTelemetry: open-source native metrics in CloudWatch @@ -29 +17 @@ Key Topics: - * [Use metrics explorer to monitor resources by their tags and properties](./CloudWatch-Metrics-Explorer.html) +CloudWatch supports OpenTelemetry as the recommended path for metric ingestion and querying. You can use vendor-agnostic, open-source instrumentation to send metrics to CloudWatch – the same OTel SDKs and collectors that work with Prometheus, Grafana, and other backends work with CloudWatch out of the box. @@ -31 +19 @@ Key Topics: - * [Use metric streams](./CloudWatch-Metric-Streams.html) +### Two metric models @@ -33 +21 @@ Key Topics: - * [View available metrics](./viewing_metrics_with_cloudwatch.html) +CloudWatch supports two metric models. Both are fully supported – choose based on your needs: @@ -35 +23,9 @@ Key Topics: - * [Graphing metrics](./graph_metrics.html) +| **[OpenTelemetry Metrics (Recommended)](./metrics-otel-recommended.html)** | **[CloudWatch Metrics (Classic)](./metrics-classic.html)** +---|---|--- +**Ingestion** | OTLP endpoint (OTel SDKs, collectors) | PutMetricData API, EMF +**Query language** | PromQL | CloudWatch Metrics Insights (SQL) +**Labels / Dimensions** | Up to 150 labels per data point | Up to 30 dimensions per metric +**Pricing model** | Per GB ingested | Per metric per month +**Storage** | Up to 15 months | Up to 15 months +**Metric names** | Open-source native | Proprietary (CloudWatch-format) +**Best for** | New workloads, containers, high-cardinality | Existing integrations, low-cardinality AWS service metrics @@ -37 +33 @@ Key Topics: - * [Using CloudWatch anomaly detection](./CloudWatch_Anomaly_Detection.html) +### Getting started @@ -39 +35 @@ Key Topics: - * [Using math expressions with CloudWatch metrics](./using-metric-math.html) + * **New to CloudWatch metrics?** Start with [OpenTelemetry Metrics (Recommended)](./metrics-otel-recommended.html). @@ -41 +37 @@ Key Topics: - * [Use search expressions in graphs](./using-search-expressions.html) + * **Already using PutMetricData or EMF?** See [CloudWatch Metrics (Classic)](./metrics-classic.html). @@ -43 +39 @@ Key Topics: - * [Get statistics for a metric](./getting-metric-statistics.html) + * **Want AWS service metrics in PromQL?** Enable [AWS vended metrics in OpenTelemetry format](./CloudWatch-OTelEnrichment.html). @@ -56 +52 @@ Dashboard Body Structure and Syntax -Concepts +OpenTelemetry Metrics (Recommended)