[chore] Update clusterName requirements comment (#1719)

* [chore] Update clusterName requirements comment

* Update helm-charts/splunk-otel-collector/values.yaml

Co-authored-by: Curtis Robert <[email protected]>

* Update helm-charts/splunk-otel-collector/values.yaml

Co-authored-by: Curtis Robert <[email protected]>

* Added a suggested note for EKS permissions

* fix linter

---------

Co-authored-by: Curtis Robert <[email protected]>

Author: dmitryax

helm-charts/splunk-otel-collector/values.yaml

@@ -12,10 +12,17 @@ fullnameOverride: ""
 namespaceOverride: ""
 
 ################################################################################
-# clusterName is an optional parameter. It can be set to an arbitrary value that identifies
-# your K8s cluster. The value will be associated with every trace, metric and
-# log as "k8s.cluster.name" attribute. It's optional on EKS and GKE, but required
-# on all other Kubernetes services.
+# clusterName is an optional parameter that is used as the "k8s.cluster.name" attribute
+# for all traces, metrics, and logs.
+#
+# For EKS and GKE clusters:
+#   - Do NOT set this field if you have 'distribution' set to values starting with 'eks' or 'gke'.
+#     The cluster name is auto-discovered from the cloud provider.
+#     Note: In EKS, the collector should be able to assume the node's IAM role, as it requires
+#     the EC2:DescribeInstances permission, which is available by default unless disabled manually.
+#
+# For other distributions:
+#   - It MUST be set so that telemetry can be tagged with "k8s.cluster.name".
 ################################################################################
 
 clusterName: ""