Connect your OpenShift clusters to Dynatrace

To connect your OpenShift clusters to Dynatrace, follow the instructions provided below.

Set up OpenShift integration

1. Install an ActiveGate

Connecting your OpenShift clusters to Dynatrace to take advantage of the dedicated Kubernetes/OpenShift overview page requires that you run an ActiveGate in your environment (version 1.163+).

2. Create a Bearer token for authenticating against the Kubernetes API

  1. Create a namespace if one doesn't already exist.
$ oc adm new-project --node-selector="" dynatrace
  1. Create a service account and cluster role for accessing the Kubernetes API with the following snippet.
$ oc apply -f kubernetes-monitoring-service-account.yaml
  1. Get the Kubernetes API URL for later use.
$ oc config view --minify -o jsonpath='{.clusters[0].cluster.server}'
  1. Get the Bearer token for later use.

    $ oc get secret $(oc get sa dynatrace-monitoring -o jsonpath='{.secrets[0].name}' -n dynatrace) -o jsonpath='{.data.token}' -n dynatrace | base64 --decode

3. Connect your OpenShift cluster through the Dynatrace settings

You'll need the Bearer token and the Kubernetes API URL mentioned above to set up the connection to the Kubernetes API.

  1. Go to Settings > Cloud and virtualization > Kubernetes.
  2. Click Connect new cluster.
  3. Provide a Name, Kubernetes API URL, and the Bearer token for the OpenShift cluster.

Configure ActiveGate

If your environment uses proxies or self-signed certificates, you need to adapt your ActiveGate configuration as explained on the ActiveGate configuration page.

Monitor large OpenShift environments

Please contact us if you want to monitor environments larger than:

  • 50 OpenShift clusters per Dynatrace environment
  • 500 nodes per OpenShift cluster
  • 50,000 pods per OpenShift cluster