diff --git a/config/thirdparty/prometheus.md b/config/thirdparty/prometheus.md
index bfce2007bf..e636863be7 100644
--- a/config/thirdparty/prometheus.md
+++ b/config/thirdparty/prometheus.md
@@ -4,8 +4,13 @@ keywords: prometheus, metrics
 title: Collect Docker metrics with Prometheus
 redirect_from:
 - /engine/admin/prometheus/
+- /config/thirdparty/prometheus/
 ---
 
+> Beta disclaimer
+>
+> This is beta content. It is not yet complete and should be considered a work in progress. This content is subject to change without notice.
+
 [Prometheus](https://prometheus.io/) is an open-source systems monitoring and
 alerting toolkit. You can configure Docker as a Prometheus target. This topic
 shows you how to configure Docker, set up Prometheus to run as a Docker
@@ -17,6 +22,15 @@ container, and monitor your Docker instance using Prometheus.
 Currently, you can only monitor Docker itself. You cannot currently monitor your
 application using the Docker target.
 
+In UCP 3.0,  Prometheus servers were standard containers. In UCP 3.1, Prometheus runs as a Kubernetes deployment. By default, this will be a daemonset that runs on every manager node. One benefit of this change is you can set the daemonset to not schedule on any nodes, which effectively disables Prometheus if you don’t use the UCP web interface.
+
+The data is stored locally on disk for each Prometheus server, so data is not replicated on new managers or if you schedule Prometheus to run on a new node. Metrics are not kept longer than 24 hours.
+
+> Note
+>
+> Upgrading UCP from 3.0.x to 3.1.x causes loss of metrics data.
+
+
 ## Configure Docker
 
 To configure the Docker daemon as a Prometheus target, you need to specify the