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, Full-Stack observability, Log analytics with Fluent Bit, and Extensions are all enabled. If the selected distribution is GKE Autopilot or EKS on Bottlerocket, then Full-Stack observability is not available and Application observability will be the default option. Log analytics with Fluent Bit is disabled for GKE Autopilot.

    • Note: Extensions require Dynatrace Operator version 1.4.0+
    • 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 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.
    • recommended Network zone helps you to route the traffic efficiently, avoiding unnecessary traffic across data centers and network regions.
    • recommended Host group enables you to categorize and manage multiple hosts that share similar characteristics or purposes within your environment. This is only available for Full-Stack observability.

  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.