AWS Security ChangesHomeSearch

AWS AmazonCloudWatch: JMX password_file now required for non-localhost endpoints

Service: AmazonCloudWatch · 2026-11-21 · Documentation medium

File: AmazonCloudWatch/latest/monitoring/CloudWatch-Agent-JMX-metrics.md · Type: authz

Summary

Clarifies JMX agent config docs: renames 'process metrics'/'processes metrics' wording to 'JMX metrics' in the append_dimensions and metrics_collection_interval descriptions, changes password_file from 'Optional' to 'Required if endpoint isn't localhost' (with the read-only/restricted-file and keystore/truststore password guidance retained), adds a "password_file": "/path/to/password-file" line to the jmx config example, and renames a nav link from 'Collect metrics and traces with OpenTelemetry' to 'OTLP source (Classic, legacy)'.

Security assessment

The changed line strengthens guidance by making the credential-bearing password_file mandatory whenever the JMX endpoint is not localhost, and reiterates that the file must be read-only and restricted to the agent user, plus keystore/truststore password handling for SSL. This is security best-practice documentation for remote JMX authentication rather than a fix for a specific vulnerability or incident, so it is not security_issue_related; the remaining edits are terminology/nav wording with no security impact.

Evidence

  * `password_file` – Required if `endpoint` isn't localhost. Specifies a Java properties file of keys to passwords. The file must be read-only and restricted to the user running the CloudWatch agent. If password authentication is enabled, this requires the same username and password pair as the entry in the JMX password file provided in the `com.sun.management.jmxremote.password.file` property. If SSL is enabled, it requires entries for `keystore` and `truststore` and corresponds to the `javax.net.ssl.keyStorePassword` and `javax.net.ssl.trustStorePassword` respectively.

Diff

diff --git a/AmazonCloudWatch/latest/monitoring/CloudWatch-Agent-JMX-metrics.md b/AmazonCloudWatch/latest/monitoring/CloudWatch-Agent-JMX-metrics.md
index 57b454c..3c99d5f 100644
--- a//AmazonCloudWatch/latest/monitoring/CloudWatch-Agent-JMX-metrics.md
+++ b//AmazonCloudWatch/latest/monitoring/CloudWatch-Agent-JMX-metrics.md
@@ -131 +131 @@ The `jmx` section can also include the optional `append_dimensions` field:
-  * `append_dimensions` – Optional. Additional dimensions to use for only the process metrics. If you specify this field, it's used in addition to dimensions specified in the `append_dimensions` field that is used for all types of metrics collected by the agent.
+  * `append_dimensions` – Optional. Additional dimensions to use for only the JMX metrics. If you specify this field, it's used in addition to dimensions specified in the `append_dimensions` field that is used for all types of metrics collected by the agent.
@@ -142 +142 @@ The following fields apply only when running the CloudWatch agent on Amazon EC2
-  * `metrics_collection_interval` – Optional. Specifies how often to collect the processes metrics, overriding the global `metrics_collection_interval` specified in the `agent` section of the configuration file.
+  * `metrics_collection_interval` – Optional. Specifies how often to collect the JMX metrics, overriding the global `metrics_collection_interval` specified in the `agent` section of the configuration file.
@@ -153 +153 @@ If JMX was enabled with password authentication or SSL for remote access, you ca
-  * `password_file` – Optional. Specifies a Java properties file of keys to passwords. The file must be read-only and restricted to the user running the CloudWatch agent. If password authentication is enabled, this requires the same username and password pair as the entry in the JMX password file provided in the `com.sun.management.jmxremote.password.file` property. If SSL is enabled, it requires entries for `keystore` and `truststore` and corresponds to the `javax.net.ssl.keyStorePassword` and `javax.net.ssl.trustStorePassword` respectively.
+  * `password_file` – Required if `endpoint` isn't localhost. Specifies a Java properties file of keys to passwords. The file must be read-only and restricted to the user running the CloudWatch agent. If password authentication is enabled, this requires the same username and password pair as the entry in the JMX password file provided in the `com.sun.management.jmxremote.password.file` property. If SSL is enabled, it requires entries for `keystore` and `truststore` and corresponds to the `javax.net.ssl.keyStorePassword` and `javax.net.ssl.trustStorePassword` respectively.
@@ -201,0 +202 @@ The following is an example of the `jmx` section of the CloudWatch agent configu
+              "password_file": "/path/to/password-file",
@@ -385 +386 @@ Collect EFA metrics
-Collect metrics and traces with OpenTelemetry
+OTLP source (Classic, legacy)