[Perses] Document url_format (#920)

josunect · web-flow · commit 94ab8c9e38cd · 2025-10-22T08:43:29.000-04:00
diff --git a/content/en/docs/Configuration/p8s-jaeger-grafana/perses.md b/content/en/docs/Configuration/p8s-jaeger-grafana/perses.md
@@ -63,6 +63,19 @@ spec:
 The described configuration is done in the Kiali CR when Kiali is installed using the Kiali Operator. If Kiali is installed with the Helm chart then the correct way to configure this is via regular --set flags.
 {{% /alert %}}
 
+When running Perses with the cluster observability operator in OpenShift, it requires an additional configuration item (Available from Kiali >2.17), so the url format can be compatible with the plugin UI URL:
+
+```yaml
+spec:
+  external_services:
+    perses:
+      ...
+      url_format: "openshift"
+```
+
+The internal URL shouldn't be set to avoid an internal validation of the Dashboards. 
+The external URL should be set to the OpenShift cluster, without the additional path.
+
 ### Perses authentication configuration
 
 The Kiali CR provides authentication configuration that will be used to connect to your perses instance and for detecting your perses version in the Mesh graph.
