diff --git a/docs/guides/observability/partials/jgrp_metrics.adoc b/docs/guides/observability/partials/jgrp_metrics.adoc
index dd0879aa373..8265b33e8be 100644
--- a/docs/guides/observability/partials/jgrp_metrics.adoc
+++ b/docs/guides/observability/partials/jgrp_metrics.adoc
@@ -7,6 +7,13 @@ If metrics from multiple clusters are being collected, this tag helps identify w
 `node=<node>`:: The name of the node reporting the metric.
 ====
 
+[WARNING]
+====
+All metric names prefixed with `vendor_jgroups_` are provided for troubleshooting and debugging purposes only.
+The metric names can change in upcoming releases of {project_name} without further notice.
+Therefore, we advise not using them in dashboards or in monitoring and alerting.
+====
+
 == Response Time
 
 The following metrics expose the response time for the remote requests.