diff --git a/actions.yaml b/actions.yaml
index 0551b129cec19d310d3999b8c6786a897ef055e0..5a3951a4b26c5e10c37438c806c7ea9e58bf46fc 100644
--- a/actions.yaml
+++ b/actions.yaml
@@ -4,7 +4,9 @@ resume:
   descrpition: Resume the Ceilometer unit.  This action will start Ceilometer services.
 ceilometer-upgrade:
   description: |
-    Perform ceilometer-upgrade. This action will upgrade Ceilometer data stores.
-    *Note* This action must be run post deployment when ceilometer is related to gnocchi.
+    Perform ceilometer-upgrade. This action will update Ceilometer data store configuration.
+    *Note* Existing mongodb data is not migrated to gnocchi. This action must be run post
+    deployment when ceilometer is related to gnocchi. If there are multiple clustered
+    ceilometer units, the action should only be run on one unit.
 openstack-upgrade:
   description: Perform openstack upgrades. Config option action-managed-upgrade must be set to True.