Add new clusters

This guide walks you through the process of adding new clusters to Dynatrace.

Onboard a new cluster

Dynatrace Operator version 0.15.0+

To start monitoring a new Kubernetes cluster with Dynatrace, go to Kubernetes, select Add cluster in the upper-right corner, and follow the on-screen steps as outlined below.

Kubernetes app - enable new clusters

  1. Select your distribution.

  2. Select your observability options. By default, Kubernetes observability, Application observability, and Log analytics with Fluent Bit are all enabled. If the selected distribution is GKE Autopilot, Log analytics with Fluent Bit will be disabled by default.

    • optional If you want to deploy Application observability to certain namespaces only, select Restrict Application observability to certain namespaces and provide a Kubernetes namespace selector.
    • optional If you want to deploy Fluent Bit Log monitoring to certain resources only, select Restrict Log monitoring to certain resources and provide the Namespaces and/or Pod Annotation to select the pods you want to monitor. If both filters are set, logs will only be ingested for pods in the specified namespaces that also have the specified pod annotation.

  3. In Configure cluster, provide the following information.

    • required Cluster name is used as display name in the Kubernetes app. You can change it later.
    • recommended Network zone helps you to route the traffic efficiently, avoiding unnecessary traffic across data centers and network regions.

  4. In Install Dynatrace Operator, provide your Dynatrace Operator token, and, optionally, data ingest token.

    1. Select Download dynakube.yaml.
    2. Execute the commands provided in Install Dynatrace Operator.
    3. optional Verify the deployment's success. The status should be Running.
    kubectl get dynakubes -n dynatrace

    For more information, see Set up Dynatrace on Kubernetes.

  5. The Install Fluent Bit step is only available when Log analytics with Fluent Bit is selected.

    1. Generate a token or enter an existing token with the Ingest logs scope enabled.
    2. Download the fluent-bit-values.yaml file. The download button is enabled when at least Cluster name and Fluent Bit token are set.
    3. Execute the provided commands to complete the installation. The commands will install a fresh Fluent Bit installation (DaemonSet) on your cluster to stream enriched logs to Dynatrace.
    4. optional View the ingested logs. For workload enrichment, Dynatrace Operator version 1.1.0+ is required.

  6. optional Wait to get successful connection signal from your cluster. Once a signal from the ActiveGate installed on your cluster is received, you can go to the cluster by selecting Go to new cluster.

Learn more