Get started with Full observability (classic full stack deployment)
This page provides instructions for deploying the Dynatrace Operator in classic full stack configuration to a Kubernetes cluster.
Installation options
Choose one of the installation methods that best suits your needs.
Guided (Dynatrace UI)
recommended
Manifest
Helm
Guided (Dynatrace UI)
-
In the Dynatrace menu go to Kubernetes.
-
Select Connect automatically via Dynatrace Operator in the header of the Kubernetes cluster page.
-
Enter the following details.
-
Name: Defines the display name of your Kubernetes cluster within Dynatrace. Additionally, this name will be used as a prefix for naming Dynatrace-specific resources inside your Kubernetes cluster, such as DynaKube (custom resource), ActiveGate (pod), OneAgents (pods), and as a name for the secret holding your tokens.
-
recommended Group: Defines a group used by various Dynatrace settings, including network zone, ActiveGate group, and host group. If not set, defaults or empty values are used.
-
Dynatrace Operator token: Select Create token or enter the API token you previously created. For more information, see Access tokens and permissions.
-
Data ingest token: not applicable for this deployment option
-
-
optional Decide whether you want the Dynatrace Operator to disable the verification of the Dynatrace SSL certificate.
This is relevant if you are using Dynatrace Managed with self-signed certificates.
-
Turn on Enable volume storage if you deploy on one of the following Kubernetes distributions: Google Kubernetes Engine (GKE), SUSE Container as a Service (CaaS), VMware Tanzu Kubernetes Grid Integrated Edition (TGKI) or IBM Kubernetes Service (IKS).
-
Select Download dynakube.yaml. Copy the code block created by Dynatrace created and run it in your terminal. Ensure you execute the commands in the same directory where you downloaded the YAML or adapt the command to link to the location of the YAML manifest.
The downloaded YAML file is a basic version of the DynaKube custom resource definition. To adjust values to your specific needs, refer to the DynaKube custom resource samples from GitHub. For more information about all configuration options, see DynaKube parameters for Dynatrace Operator.
-
optional Verify that your DynaKube is running and all pods in your Dynatrace namespace are running and ready.
> kubectl get dynakube -n dynatrace NAME APIURL STATUS AGE dynakube https://<ENVIRONMENTID>.live.dynatrace.com/api Running 45s
In a default DynaKube configuration, you should see the following pods:
> kubectl get pods -n dynatrace NAME READY STATUS RESTARTS AGE dynakube-activegate-0 1/1 Running 0 50s dynakube-oneagent-2wnbb 1/1 Running 0 50s dynakube-oneagent-wp2bt 1/1 Running 0 50s dynakube-oneagent-pxdv4 1/1 Running 0 50s dynatrace-operator-8445c87f87-qhc5t 1/1 Running 0 3m02s dynatrace-webhook-56644487df-ws7gg 1/1 Running 0 3m02s dynatrace-webhook-56644487df-xkxkd 1/1 Running 0 3m02s
As OneAgent is deployed as DaemonSet, you should have a OneAgent pod on each node.
Manifest
-
Create a
dynatrace
namespacekubectl create namespace dynatrace
-
Install Dynatrace Operator
kubectl apply -f https://github.com/Dynatrace/dynatrace-operator/releases/download/v0.13.0/kubernetes.yaml
Run the following command to see when Dynatrace Operator components finish initialization:
kubectl -n dynatrace wait pod --for=condition=ready --selector=app.kubernetes.io/name=dynatrace-operator,app.kubernetes.io/component=webhook --timeout=300s
-
Create secret for API token
Create a secret named
dynakube
for the API token obtained in Tokens and permissions required.kubectl -n dynatrace create secret generic dynakube --from-literal="apiToken=<API_TOKEN>"
-
Apply the DynaKube custom resource
Download the DynaKube custom resource sample for classic full stack from GitHub. In addition, you can review the available parameters or how-to-guides, and adapt the DynaKube custom resource according to your requirements.
Run the command below to apply the DynaKube custom resource, making sure to replace
<your-DynaKube-CR>
with your actual DynaKube custom resource file name. A validation webhook will provide helpful error messages if there's a problem.kubectl apply -f <your-DynaKube-CR>.yaml
-
optional Verify deployment
Verify that your DynaKube is running and all pods in your Dynatrace namespace are running and ready.
> kubectl get dynakube -n dynatrace NAME APIURL STATUS AGE dynakube https://<ENVIRONMENTID>.live.dynatrace.com/api Running 45s
In a default DynaKube configuration, you should see the following pods:
> kubectl get pods -n dynatrace NAME READY STATUS RESTARTS AGE dynakube-activegate-0 1/1 Running 0 50s dynakube-oneagent-2wnbb 1/1 Running 0 50s dynakube-oneagent-wp2bt 1/1 Running 0 50s dynakube-oneagent-pxdv4 1/1 Running 0 50s dynatrace-operator-8445c87f87-qhc5t 1/1 Running 0 3m02s dynatrace-webhook-56644487df-ws7gg 1/1 Running 0 3m02s dynatrace-webhook-56644487df-xkxkd 1/1 Running 0 3m02s
As OneAgent is deployed as DaemonSet, you should have a OneAgent pod on each node.
-
Add a
dynatrace
projectoc adm new-project --node-selector="" dynatrace
-
Install Dynatrace Operator
oc apply -f https://github.com/Dynatrace/dynatrace-operator/releases/download/v0.13.0/openshift.yaml
Run the following command to see when Dynatrace Operator components finish initialization:
oc -n dynatrace wait pod --for=condition=ready --selector=app.kubernetes.io/name=dynatrace-operator,app.kubernetes.io/component=webhook --timeout=300s
-
Create secret for API token
Create a secret named
dynakube
for the API token obtained in Tokens and permissions required.oc -n dynatrace create secret generic dynakube --from-literal="apiToken=<API_TOKEN>"
-
Apply the DynaKube custom resource
Download the DynaKube custom resource sample for classic full stack from GitHub. In addition, you can review the available parameters or how-to-guides, and adapt the DynaKube custom resource according to your requirements.
Run the command below to apply the DynaKube custom resource, making sure to replace
<your-DynaKube-CR>
with your actual DynaKube custom resource file name. A validation webhook will provide helpful error messages if there's a problem.oc apply -f <your-DynaKube-CR>.yaml
-
optional Verify deployment
Verify that your DynaKube is running and all pods in your Dynatrace project are running and ready.
> oc get dynakube -n dynatrace NAME APIURL STATUS AGE dynakube https://<ENVIRONMENTID>.live.dynatrace.com/api Running 45s
In a default DynaKube configuration, you should see the following pods:
> oc get pods -n dynatrace NAME READY STATUS RESTARTS AGE dynakube-activegate-0 1/1 Running 0 50s dynakube-oneagent-2wnbb 1/1 Running 0 50s dynakube-oneagent-wp2bt 1/1 Running 0 50s dynakube-oneagent-pxdv4 1/1 Running 0 50s dynatrace-operator-8445c87f87-qhc5t 1/1 Running 0 3m02s dynatrace-webhook-56644487df-ws7gg 1/1 Running 0 3m02s dynatrace-webhook-56644487df-xkxkd 1/1 Running 0 3m02s
As OneAgent is deployed as DaemonSet, you should have a OneAgent pod on each node.
Helm
Dynatrace Operator version 0.8.0+
-
Add the Dynatrace Helm repository
helm repo add dynatrace \ https://raw.githubusercontent.com/Dynatrace/dynatrace-operator/main/config/helm/repos/stable
Note that attempting to access the above URL will result in a 404 error page as it is only used internally by the Helm client.
-
Install Dynatrace Operator
You have two options:
Option 1: Install Dynatrace Operator using the default values:
helm install dynatrace-operator dynatrace/dynatrace-operator \ --set "installCRD=true" \ --atomic \ --create-namespace --namespace dynatrace
Option 2: For additional configuration to the Helm chart, edit the
values.yaml
sample from GitHub, then run the install command passing the YAML file as an argument:helm install dynatrace-operator dynatrace/dynatrace-operator \ -f values.yaml \ --atomic \ --create-namespace --namespace dynatrace
If
installCRD
is set tofalse
, you need to create the custom resource definition manually before starting the Helm installation:kubectl apply -f https://github.com/Dynatrace/dynatrace-operator/releases/download/v0.13.0/dynatrace-operator-crd.yaml
-
Create secret for API token
Create a secret named
dynakube
for the API token obtained in Tokens and permissions required.kubectl -n dynatrace create secret generic dynakube --from-literal="apiToken=<API_TOKEN>"
-
Apply the DynaKube custom resource
Download the DynaKube custom resource sample for classic full stack from GitHub. In addition, you can review the available parameters or how-to-guides, and adapt the DynaKube custom resource according to your requirements.
Run the command below to apply the DynaKube custom resource, making sure to replace
<your-DynaKube-CR>
with your actual DynaKube custom resource file name. A validation webhook will provide helpful error messages if there's a problem.kubectl apply -f <your-DynaKube-CR>.yaml
-
optional Verify deployment
Verify that your DynaKube is running and all pods in your Dynatrace namespace are running and ready.
> kubectl get dynakube -n dynatrace NAME APIURL STATUS AGE dynakube https://<ENVIRONMENTID>.live.dynatrace.com/api Running 45s
In a default DynaKube configuration, you should see the following pods:
> kubectl get pods -n dynatrace NAME READY STATUS RESTARTS AGE dynakube-activegate-0 1/1 Running 0 50s dynakube-oneagent-2wnbb 1/1 Running 0 50s dynakube-oneagent-wp2bt 1/1 Running 0 50s dynakube-oneagent-pxdv4 1/1 Running 0 50s dynatrace-operator-8445c87f87-qhc5t 1/1 Running 0 3m02s dynatrace-webhook-56644487df-ws7gg 1/1 Running 0 3m02s dynatrace-webhook-56644487df-xkxkd 1/1 Running 0 3m02s
As OneAgent is deployed as DaemonSet, you should have a OneAgent pod on each node.
-
Add the Dynatrace Helm repository
helm repo add dynatrace \ https://raw.githubusercontent.com/Dynatrace/dynatrace-operator/main/config/helm/repos/stable
Note that attempting to access the above URL will result in a 404 error page as it is only used internally by the Helm client.
-
Install Dynatrace Operator
You have two options:
Option 1: Install Dynatrace Operator using the default values:
helm install dynatrace-operator dynatrace/dynatrace-operator \ --set "installCRD=true" \ --atomic \ --create-namespace --namespace dynatrace
Option 2: For additional configuration to the Helm chart, edit the
values.yaml
sample from GitHub, then run the install command passing the YAML file as an argument:helm install dynatrace-operator dynatrace/dynatrace-operator \ -f values.yaml \ --atomic \ --create-namespace --namespace dynatrace
If
installCRD
is set tofalse
, you need to create the custom resource definition manually before starting the Helm installation:oc apply -f https://github.com/Dynatrace/dynatrace-operator/releases/download/v0.13.0/dynatrace-operator-crd.yaml
-
Create secret for API token
Create a secret named
dynakube
for the API token obtained in Tokens and permissions required.oc -n dynatrace create secret generic dynakube --from-literal="apiToken=<API_TOKEN>"
-
Apply DynaKube custom resource
Download the DynaKube custom resource sample for classic full stack from GitHub. In addition, you can review the available parameters or how-to-guides, and adapt the DynaKube custom resource according to your requirements.
Run the command below to apply the DynaKube custom resource, making sure to replace
<your-DynaKube-CR>
with your actual DynaKube custom resource file name. A validation webhook will provide helpful error messages if there's a problem.oc apply -f <your-DynaKube-CR>.yaml
-
optional Verify deployment
Verify that your DynaKube is running and all pods in your Dynatrace project are running and ready.
> oc get dynakube -n dynatrace NAME APIURL STATUS AGE dynakube https://<ENVIRONMENTID>.live.dynatrace.com/api Running 45s
In a default DynaKube configuration, you should see the following pods:
> oc get pods -n dynatrace NAME READY STATUS RESTARTS AGE dynakube-activegate-0 1/1 Running 0 50s dynakube-oneagent-2wnbb 1/1 Running 0 50s dynakube-oneagent-wp2bt 1/1 Running 0 50s dynakube-oneagent-pxdv4 1/1 Running 0 50s dynatrace-operator-8445c87f87-qhc5t 1/1 Running 0 3m02s dynatrace-webhook-56644487df-ws7gg 1/1 Running 0 3m02s dynatrace-webhook-56644487df-xkxkd 1/1 Running 0 3m02s
As OneAgent is deployed as DaemonSet, you should have a OneAgent pod on each node.
Learn more
After you've successfully installed the Dynatrace Operator, you may find the following resources helpful for further learning and troubleshooting.
Get actionable answers
Start to analyze your Kubernetes clusters and containerized Apps with Dynatrace and benefit from actionable answers.
Guides
Learn how you can configure Dynatrace Operator to support specific use cases.
Troubleshooting
Troubleshoot any challenges you may encounter while working with the Dynatrace Operator and its various components.
How it works
Want to learn more about the Dynatrace components in your Kubernetes cluster?
Reference
API reference and configuration options for all Dynatrace components within your Kubernetes cluster.
Dynatrace Operator release notes
See release notes for Dynatrace Operator.
Update or uninstall
This page provides a detailed instructions on how to update and uninstall Dynatrace Operator.