AWS Security ChangesHomeSearch

AWS documentdb: Add CloudWatch TLS handshake metrics (classical and post-quantum)

Service: documentdb · 2026-11-11 · Documentation medium

File: documentdb/latest/devguide/cloud_watch.md · Type: encryption

Summary

Adds two new instance-level CloudWatch metrics, TLSHandshakesClassical and TLSHandshakesPostQuantum, that count successful TLS handshakes using classical versus hybrid post-quantum key exchange, with guidance on computing the post-quantum percentage; also softens the scope statement for the metric tables to 'Unless otherwise noted'.

Security assessment

The added metrics expose TLS key-exchange posture (classical vs ML-KEM hybrid) so operators can verify that connections are using post-quantum key exchange; this is monitoring of transport encryption rather than a fix for a specific vulnerability.

Evidence

+`TLSHandshakesPostQuantum` | The number of successful TLS handshakes that used hybrid post-quantum key exchange on an instance in a 1-minute period. This metric applies to instance-based clusters that run Amazon DocumentDB 8.0.3 or later. For more information about post-quantum key exchange, see [Amazon DocumentDB post-quantum key exchange](./security.encryption.ssl.html#security.encryption.ssl.pq).

Diff

diff --git a/documentdb/latest/devguide/cloud_watch.md b/documentdb/latest/devguide/cloud_watch.md
index 793365d..66c8684 100644
--- a//documentdb/latest/devguide/cloud_watch.md
+++ b//documentdb/latest/devguide/cloud_watch.md
@@ -36 +36 @@ To monitor the health and performance of your Amazon DocumentDB cluster and inst
-Metrics in the following tables apply to both instance-based and elastic clusters.
+Unless otherwise noted, metrics in the following tables apply to both instance-based and elastic clusters.
@@ -80,0 +81,2 @@ Metric | Description
+`TLSHandshakesClassical` | The number of successful TLS handshakes that didn't use post-quantum key exchange on an instance in a 1-minute period. The sum of `TLSHandshakesClassical` and `TLSHandshakesPostQuantum` is the total number of successful TLS handshakes. To calculate the percentage of handshakes that used post-quantum key exchange, divide the `TLSHandshakesPostQuantum` value by this sum, and then multiply the result by 100. This metric applies to instance-based clusters that run Amazon DocumentDB 8.0.3 or later.  
+`TLSHandshakesPostQuantum` | The number of successful TLS handshakes that used hybrid post-quantum key exchange on an instance in a 1-minute period. This metric applies to instance-based clusters that run Amazon DocumentDB 8.0.3 or later. For more information about post-quantum key exchange, see [Amazon DocumentDB post-quantum key exchange](./security.encryption.ssl.html#security.encryption.ssl.pq).