[FLINK-36192][log] instruct how to change log level dynamically (#911)

Author: showuon

docs/content.zh/docs/operations/helm.md

@@ -56,6 +56,10 @@ To override single parameters you can use `--set`, for example:
 ```
 helm install --set image.repository=apache/flink-kubernetes-operator --set image.tag={{< stable >}}{{< version >}}{{< /stable >}}{{< unstable >}}latest{{< /unstable >}} flink-kubernetes-operator helm/flink-kubernetes-operator
 ```
+Note, you should escape special characters in your `--set` lines, for example:
+```
+helm install --set defaultConfiguration."log4j-operator\.properties"=rootLogger.level\=DEBUG flink-kubernetes-operator helm/flink-kubernetes-operator
+```
 
 You can also provide your custom values file by using the `-f` flag:
 ```

docs/content.zh/docs/operations/metrics-logging.md

@@ -193,9 +193,13 @@ defaultConfiguration:
   log4j-operator.properties: |+
     # Flink Operator Logging Overrides
     # rootLogger.level = DEBUG
+    # The monitor interval in seconds to enable log4j automatic reconfiguration
+    # monitorInterval = 30
   log4j-console.properties: |+
     # Flink Deployment Logging Overrides
     # rootLogger.level = DEBUG
+    # The monitor interval in seconds to enable log4j automatic reconfiguration
+    # monitorInterval = 30
 ```
 
 {{< hint info >}}

docs/content/docs/operations/helm.md

@@ -56,6 +56,10 @@ To override single parameters you can use `--set`, for example:
 ```
 helm install --set image.repository=apache/flink-kubernetes-operator --set image.tag={{< stable >}}{{< version >}}{{< /stable >}}{{< unstable >}}latest{{< /unstable >}} flink-kubernetes-operator helm/flink-kubernetes-operator
 ```
+Note, you should escape special characters in your `--set` lines, for example:
+```
+helm install --set defaultConfiguration."log4j-operator\.properties"=rootLogger.level\=DEBUG flink-kubernetes-operator helm/flink-kubernetes-operator
+```
 
 You can also provide your custom values file by using the `-f` flag:
 ```

docs/content/docs/operations/metrics-logging.md

@@ -193,9 +193,13 @@ defaultConfiguration:
   log4j-operator.properties: |+
     # Flink Operator Logging Overrides
     # rootLogger.level = DEBUG
+    # The monitor interval in seconds to enable log4j automatic reconfiguration
+    # monitorInterval = 30
   log4j-console.properties: |+
     # Flink Deployment Logging Overrides
     # rootLogger.level = DEBUG
+    # The monitor interval in seconds to enable log4j automatic reconfiguration
+    # monitorInterval = 30
 ```
 
 {{< hint info >}}

helm/flink-kubernetes-operator/conf/log4j-console.properties

@@ -60,3 +60,6 @@ appender.rolling.strategy.max = 10
 # Suppress the irrelevant (wrong) warnings from the Netty channel handler
 logger.netty.name = org.apache.flink.shaded.akka.org.jboss.netty.channel.DefaultChannelPipeline
 logger.netty.level = OFF
+
+# The monitor interval in seconds to enable log4j automatic reconfiguration
+# monitorInterval = 30

helm/flink-kubernetes-operator/conf/log4j-operator.properties

@@ -32,3 +32,6 @@ logger.conf.level = WARN
 # Avoid logging fallback key INFO messages
 logger.conf.name = org.apache.flink.configuration.Configuration
 logger.conf.level = WARN
+
+# The monitor interval in seconds to enable log4j automatic reconfiguration
+# monitorInterval = 30