About some configure parameters's meaning? #1695

collector/src/main/resources/pinpoint-collector.properties

@@ -40,7 +40,19 @@ collector.agentEventWorker.queueSize=1024
 
 statistics.flushPeriod=1000
 
-# enable cluster in socket manager.
+# -------------------------------------------------------------------------------------------------
+# The cluster related options are used to establish connections between the agent, collector, and web in order to send/receive data between them in real time.
+# You may enable additional features using this option (Ex : RealTime Active Thread Chart).
+# -------------------------------------------------------------------------------------------------
+# Usage : Set the following options for collector/web components that reside in the same cluster in order to enable this feature.
+# 1. cluster.enable (pinpoint-web.properties, pinpoint-collector.properties) - "true" to enable
+# 2. cluster.zookeeper.address (pinpoint-web.properties, pinpoint-collector.properties) - address of the ZooKeeper instance that will be used to manage the cluster
+# 3. cluster.web.tcp.port (pinpoint-web.properties) - any available port number (used to establish connection between web and collector)
+# -------------------------------------------------------------------------------------------------
+# Please be aware of the following:
+#1. If the network between web, collector, and the agents are not stable, it is advisable not to use this feature.
+#2. We recommend using the cluster.web.tcp.port option. However, in cases where the collector is unable to establish connection to the web, you may reverse this and make the web establish connection to the collector.
+#   In this case, you must set cluster.connect.address (pinpoint-web.properties); and cluster.listen.ip, cluster.listen.port (pinpoint-collector.properties) accordingly.
 cluster.enable=true
 cluster.zookeeper.address=localhost
 cluster.zookeeper.sessiontimeout=30000

quickstart/collector/src/main/resources/pinpoint-collector.properties

@@ -25,6 +25,19 @@ collector.udpSpanSocketReceiveBufferSize=4194304
 
 statistics.flushPeriod=1000
 
+# -------------------------------------------------------------------------------------------------
+# The cluster related options are used to establish connections between the agent, collector, and web in order to send/receive data between them in real time.
+# You may enable additional features using this option (Ex : RealTime Active Thread Chart).
+# -------------------------------------------------------------------------------------------------
+# Usage : Set the following options for collector/web components that reside in the same cluster in order to enable this feature.
+# 1. cluster.enable (pinpoint-web.properties, pinpoint-collector.properties) - "true" to enable
+# 2. cluster.zookeeper.address (pinpoint-web.properties, pinpoint-collector.properties) - address of the ZooKeeper instance that will be used to manage the cluster
+# 3. cluster.web.tcp.port (pinpoint-web.properties) - any available port number (used to establish connection between web and collector)
+# -------------------------------------------------------------------------------------------------
+# Please be aware of the following:
+#1. If the network between web, collector, and the agents are not stable, it is advisable not to use this feature.
+#2. We recommend using the cluster.web.tcp.port option. However, in cases where the collector is unable to establish connection to the web, you may reverse this and make the web establish connection to the collector.
+#   In this case, you must set cluster.connect.address (pinpoint-web.properties); and cluster.listen.ip, cluster.listen.port (pinpoint-collector.properties) accordingly.
 cluster.enable=true
 cluster.zookeeper.address=localhost
 cluster.zookeeper.sessiontimeout=30000

quickstart/web/src/main/resources/pinpoint-web.properties

@@ -1,4 +1,16 @@
-# local
+# -------------------------------------------------------------------------------------------------
+# The cluster related options are used to establish connections between the agent, collector, and web in order to send/receive data between them in real time.
+# You may enable additional features using this option (Ex : RealTime Active Thread Chart).
+# -------------------------------------------------------------------------------------------------
+# Usage : Set the following options for collector/web components that reside in the same cluster in order to enable this feature.
+# 1. cluster.enable (pinpoint-web.properties, pinpoint-collector.properties) - "true" to enable
+# 2. cluster.zookeeper.address (pinpoint-web.properties, pinpoint-collector.properties) - address of the ZooKeeper instance that will be used to manage the cluster
+# 3. cluster.web.tcp.port (pinpoint-web.properties) - any available port number (used to establish connection between web and collector)
+# -------------------------------------------------------------------------------------------------
+# Please be aware of the following:
+#1. If the network between web, collector, and the agents are not stable, it is advisable not to use this feature.
+#2. We recommend using the cluster.web.tcp.port option. However, in cases where the collector is unable to establish connection to the web, you may reverse this and make the web establish connection to the collector.
+#   In this case, you must set cluster.connect.address (pinpoint-web.properties); and cluster.listen.ip, cluster.listen.port (pinpoint-collector.properties) accordingly.
 cluster.enable=true
 cluster.web.tcp.port=29997
 cluster.zookeeper.address=localhost

web/src/main/resources/pinpoint-web.properties

@@ -1,4 +1,16 @@
-#local
+# -------------------------------------------------------------------------------------------------
+# The cluster related options are used to establish connections between the agent, collector, and web in order to send/receive data between them in real time.
+# You may enable additional features using this option (Ex : RealTime Active Thread Chart).
+# -------------------------------------------------------------------------------------------------
+# Usage : Set the following options for collector/web components that reside in the same cluster in order to enable this feature.
+# 1. cluster.enable (pinpoint-web.properties, pinpoint-collector.properties) - "true" to enable
+# 2. cluster.zookeeper.address (pinpoint-web.properties, pinpoint-collector.properties) - address of the ZooKeeper instance that will be used to manage the cluster
+# 3. cluster.web.tcp.port (pinpoint-web.properties) - any available port number (used to establish connection between web and collector)
+# -------------------------------------------------------------------------------------------------
+# Please be aware of the following:
+#1. If the network between web, collector, and the agents are not stable, it is advisable not to use this feature.
+#2. We recommend using the cluster.web.tcp.port option. However, in cases where the collector is unable to establish connection to the web, you may reverse this and make the web establish connection to the collector.
+#   In this case, you must set cluster.connect.address (pinpoint-web.properties); and cluster.listen.ip, cluster.listen.port (pinpoint-collector.properties) accordingly.
 cluster.enable=true
 cluster.web.tcp.port=9997
 cluster.zookeeper.address=localhost