From: Zac Dover Date: Sun, 9 May 2021 15:06:02 +0000 (+1000) Subject: doc/cephadm: rewrite "deploy. mon. w/cephadm" 2/2 X-Git-Tag: v17.1.0~1681^2 X-Git-Url: http://git.apps.os.sepia.ceph.com/?a=commitdiff_plain;h=808c91233c005ca7df8a7b43279915d6382ea26b;p=ceph.git 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 --- diff --git a/doc/cephadm/monitoring.rst b/doc/cephadm/monitoring.rst index e2e180c22bfcb..c6c54a4f92201 100644 --- a/doc/cephadm/monitoring.rst +++ b/doc/cephadm/monitoring.rst @@ -77,23 +77,27 @@ monitoring by following the 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