anchor.diff:  ifdef::openshift-origin[]
   [WARNING]
   ====
  -If your OpenShift installation was originally performed on a version previous to
  -v1.0.8, even if it has since been updated to a newer version, you will need to
  -follow the instructions for node certificates outlined in
  +If your {product-title} installation was originally performed on a version
  +previous to v1.0.8, even if it has since been updated to a newer version, you
  +will need to follow the instructions for node certificates outlined in
   link:../install_config/upgrading/manual_upgrades.html#manual-updating-master-and-node-certificates[Updating
   Master and Node Certificates]. If the node certificate does not contain the IP
   address of the node, then Heapster will fail to retrieve any metrics.
  
positive.code: [NOTE]
  ====
  Depending on your installation method, the template may not be present in your
  OpenShift installation. If so, the template can be found at the following GitHub
  location:
  
  https://github.com/openshift/openshift-ansible/blob/master/roles/openshift_examples/files/examples/v1.1/infrastructure-templates/origin/metrics-deployer.yaml
  
negative.code: ifdef::openshift-origin[]
  == Accessing Hawkular Metrics Directly
  
  If you wish to access and manage metrics more directly, you can do so via the
  Hawkular Metrics API.
  
  The link:http://www.hawkular.org/docs/rest/rest-metrics.html[Hawkular Metrics
  documentation] covers how to use the API, but there are a few differences when
  dealing with the version of Hawkular Metrics configured for use on
  {product-title}:
  
  === OpenShift Projects & Hawkular Tenants
  
  Hawkular Metrics is a multi-tenanted application. The way its been configured is
  that a project in {product-title} corresponds to a tenant in Hawkular Metrics.
  
  As such, when accessing metrics for a project named `MyProject` you will need to
  set the
  link:http://www.hawkular.org/docs/rest/rest-metrics.html#_tenant_header[Hawkular-tenant]
  header to `MyProject`
  
  There is also a special tenant named `_system` which contains system level
  metrics. This will require either a `cluster-reader` or `cluster-admin` level
  privileges to access.
  
  === Authorization
  
  The Hawkular Metrics service will authenticate the user against {product-title}
  to determine if the user has access to the project it is trying to access.
  
  When accessing the Hawkular Metrics API, you will need to pass a bearer token in
  the `Authorization` header.
  
  For more information how how to access the Hawkular Metrics in {product-title},
  please see the
  link:https://github.com/openshift/origin-metrics/blob/master/docs/hawkular_metrics.adoc[Origin
  Metrics documentation]
  
  == Accessing Heapster Directly
  
  Heapster has been configured to be only accessible via the
  link:../rest_api/kubernetes_v1.html#proxy-get-requests-to-service[API proxy].
  Accessing it will required either a cluster-reader or cluster-admin privileges.
  
  For example, to access the Heapster `validate` page, you would need to access it
  using something similar to:
  
  ----
  $ curl -H "Authorization: Bearer XXXXXXXXXXXXXXXXX" \
  