This guide describes how the different storage volumes are used by Dynatrace Operator.
The following table shows the storage requirements of Dynatrace Operator deployment modes.
Deployment type
CSI driver disabled
CSI driver enabled
classicFullStack
2 GB for OneAgent configuration and binaries on the node root filesystem
N/A
hostMonitoring
2 GB for OneAgent configuration and binaries on the node root filesystem
2 GB for OneAgent configuration and binaries in the kubelet root directory
applicationMonitoring
1 GB per monitored pod from local ephemeral storage (for example, kubelet root directory)
1 GB per tenant and running OneAgent version in the kubelet root directory
0.1 GB per injected pod from local ephemeral storage (for example, kubelet root directory)
cloudNativeFullStack
Combination of hostMonitoring
and applicationMonitoring
Combination of hostMonitoring
and applicationMonitoring
The kubelet
root directory is the central storage location for all directories required by the CSI driver. Allocate approximately 30 GB for the kubelet
directory to cover all Dynatrace-related storage requirements.
These numbers should be increased for volatile environments and can be decreased for environments with disk space monitoring.
Depending on your setup, the kubelet
root directory might not be located in /var/lib/kubelet
.
Volume name
Path on the host
Permissions
Purpose
Sizing recommendation
mountpoint-dir
/var/lib/kubelet/pods
Read-write necessary
Stores node information
N/A
registration-dir
/var/lib/kubelet/plugins_registry
Read-write necessary
Contains the CSI driver "registration" socket. This socket allows the registrar to use it to register the CSI driver.
10 MB
plugin-dir
, data-dir
/var/lib/kubelet/plugins/csi.oneagent.dynatrace.com
Read-write necessary
Stores all files required for the CSI driver's operation.
See plugin directory directory disk usage for all factors that influence storage consumption.
Contains the CSI driver components and enables kubelet
to interact with the driver for operations like health checks.
Storage usage depends on your environment:
If OneAgent is monitoring the host additional storage is consumed.
Disk usage per version is depending on the architecture. Without CSI driver the listed amount of storage is consumed per pod.
Volumes are automatically cleaned up by Kubernetes when the CSI driver pod is terminated.
Volume name
Purpose
Sizing recommendation
lockfile-dir
Used by the registrar container and mounted to avoid filesystem writes.
1 MB
tmp-dir
Temporary file storage for small operations.
1 MB
Allows the OneAgent to persist its configuration.
Volume name
Volume Type
Host path
Purpose
volume-storage
hostPath
/var/opt/dynatrace
(default) 1
Without CSI driver configuration is written directly to the host filesystem.
volume-storage
csi
/var/lib/kubelet/plugins/plugins/csi.oneagent.dynatrace.com
With CSI driver no configuration is written to an ephemeral volume, instead plugin directory on the host is used to persist OneAgent configuration.
Configurable using storageHostPath
field in the Dynakube. See Dynakube parameters for more information.
These directories are specific to Dynatrace. They are injected into workloads by the Webhook and don't require user management or configuration.
Volume name
Volume type
Purpose
Sizing recommendation
oneagent-share
emptyDir
Stores configuration data for the OneAgent, including custom CAs.
10 MB
metadata-enrichment
emptyDir
Stores configuration data for metadata enrichment (dt_metadata
).
10 MB
Same disk usage as described in plugin directory disk usage. You can save storage by configuring the node image pull feature.
These directories are required only if the CSI driver volume is read-only.
Volume name
Path
Purpose
Sizing recommendation
oneagent-agent-conf
/opt/dynatrace/oneagent-paas/agent/conf
Stores general OneAgent configuration.
5 MB
oneagent-data-storage
/opt/dynatrace/oneagent-paas/datastorage
Used for memory dumps, runtime data, and other diagnostic information.
5 MB-5 GB
oneagent-log
/opt/dynatrace/oneagent-paas/log
Stores runtime logs for the OneAgent.
10 MB