From ae2b3e59be078d70aa440073d5e9f470ad859bbb Mon Sep 17 00:00:00 2001 From: Zac Dover Date: Mon, 10 May 2021 01:06:02 +1000 Subject: [PATCH] doc/cephadm: rewrite "deploy. mon. w/cephadm" 2/2 This is the second half of PR#41241. This PR creates a sub-subsection that explains a configuration step that is sometimes necessary when configuring monitoring in Ceph clusters. (The configuration step involves DNS zones.) Signed-off-by: Zac Dover (cherry picked from commit 808c91233c005ca7df8a7b43279915d6382ea26b) --- doc/cephadm/monitoring.rst | 30 +++++++++++++++++------------- 1 file changed, 17 insertions(+), 13 deletions(-) diff --git a/doc/cephadm/monitoring.rst b/doc/cephadm/monitoring.rst index e1532097e4b40..1c50cca5bb35a 100644 --- a/doc/cephadm/monitoring.rst +++ b/doc/cephadm/monitoring.rst @@ -89,23 +89,27 @@ steps below: ceph orch apply grafana 1 -Cephadm takes care of the configuration of Prometheus, Grafana, and Alertmanager -automatically. +Manually setting the Grafana URL +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Cephadm automatically configures Prometheus, Grafana, and Alertmanager in +all cases except one. + +In a some setups, the Dashboard user's browser might not be able to access the +Grafana URL that is configured in Ceph Dashboard. This can happen when the +cluster and the accessing user are in different DNS zones. -However, there is one exception to this rule. In a some setups, the Dashboard -user's browser might not be able to access the Grafana URL configured in Ceph -Dashboard. One such scenario is when the cluster and the accessing user are each -in a different DNS zone. +If this is the case, you can use a configuration option for Ceph Dashboard +to set the URL that the user's browser will use to access Grafana. This +value will never be altered by cephadm. To set this configuration option, +issue the following command: -For this case, there is an extra configuration option for Ceph Dashboard, which -can be used to configure the URL for accessing Grafana by the user's browser. -This value will never be altered by cephadm. To set this configuration option, -issue the following command:: + .. prompt:: bash $ - $ ceph dashboard set-grafana-frontend-api-url + ceph dashboard set-grafana-frontend-api-url -It may take a minute or two for services to be deployed. Once -completed, you should see something like this from ``ceph orch ls`` +It might take a minute or two for services to be deployed. After the +services have been deployed, you should see something like this when you issue the command ``ceph orch ls``: .. code-block:: console -- 2.39.5