Storage requirements

This guide describes how the different storage volumes are used by Dynatrace Operator.

Overview

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

CSI driver volumes

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.

Host volumes

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.

Plugin directory disk usage

Contains the CSI driver components and enables kubelet to interact with the driver for operations like health checks.

Storage usage depends on your environment:

  • Number of pods on the node
  • Number of different code module versions
  • Number of DynaKubes

If OneAgent is monitoring the host additional storage is consumed.

Component
Disk usage
Notes
OneAgent
5 GB
Essential for OneAgent functionality.
Code Modules
see table below 1
Runtime logs
0.1-1 GB per pod
Logs and data generated at runtime.
Configuration
20 MB per pod
1

Disk usage per version is depending on the architecture. Without CSI driver the listed amount of storage is consumed per pod.

Architecture
Disk usage
amd64
1.2 GB
arm64
800 MB
s390x
500 MB
ppc64le
500 MB

Ephemeral volumes

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

OneAgent volumes

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.

1

Configurable using storageHostPath field in the Dynakube. See Dynakube parameters for more information.

Application pod volumes

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-bin

emptyDir

Stores the OneAgent binary and logs.

Used if CSI driver is not installed. 1

oneagent-bin

csi

Stores the OneAgent binary and logs.

Used if CSI driver is installed. 1

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

1

Same disk usage as described in plugin directory disk usage. You can save storage by configuring the node image pull feature.

Read-only CSI driver

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