doc/admin/management-token.html.textile.liquid

   1 ---
   2 layout: default
   3 navsection: admin
   4 title: Management token
   5 ...
   6
   7 {% comment %}
   8 Copyright (C) The Arvados Authors. All rights reserved.
   9
  10 SPDX-License-Identifier: CC-BY-SA-3.0
  11 {% endcomment %}
  12
  13 To enable and collect health checks and metrics, services must be configured with a "management token".
  14
  15 Services must have ManagementToken configured.  This is used to authorize access monitoring endpoints.  If ManagementToken is not configured, monitoring endpoints will return the error @404 disabled@.
  16
  17 To access a monitoring endpoint, the requester must provide the HTTP header @Authorization: Bearer (ManagementToken)@.
  18
  19 h2. API server and other services
  20
  21 The following services also support monitoring.
  22
  23 * API server
  24 * arv-git-httpd
  25 * controller
  26 * keep-balance
  27 * keepproxy
  28 * keepstore
  29 * keep-web
  30 * arvados-ws
  31
  32 Set @ManagementToken@ in the appropriate section of @/etc/arvados/config.yml@.
  33
  34 <notextile>
  35 <pre><code>Clusters:
  36   <span class="userinput">ClusterID</span>:
  37     # Token to be included in all healthcheck requests. Disabled by default.
  38     # Server expects request header of the format "Authorization: Bearer xxx"
  39     ManagementToken: xxx
  40 </code></pre>
  41 </notextile>