AWS documentdb: Add CloudWatch TLS handshake metrics (classical and post-quantum)
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).