OneAgent files and disk space requirements on AIX

This page provides information about the OneAgent directory structure and disk space requirements for OneAgent full-stack installation and updates. Note that exact values may vary based on OneAgent version.

Default directory
Can be modified?
Size of installation (with temporary installation files removed)
360 MB
/opt/dynatrace/oneagent
Yes 1
Persistent configuration
~5 MB
/var/lib/dynatrace/oneagent/agent/config
No
Temporary files, runtime configuration
200 MB
/var/lib/dynatrace/oneagent/agent/runtime
No
Logs
1 GB
/var/log/dynatrace/oneagent 2
Yes 3
Crash reports, memory dumps
3 GB
/var/lib/dynatrace/oneagent/datastorage
Yes 4
EEC logs retransmission persistence file
600 MB
/var/lib/dynatrace/oneagent/agent/runtime/extensions/persistence
Yes 5 6
Additional space required for updates
550 MB
Total
7.1 GB
1

Use the INSTALL_PATH installation parameter.

2

For OneAgent version 1.201 and earlier, the default location for log files is /opt/dynatrace/oneagent/log.

3

Use the LOG_PATH installation parameter.

4

Use the DATA_STORAGE installation parameter.

5

Applicable only if you use Dynatrace Extensions that define the log metrics, events, or add their own log processing rules. Can be changed via support request.

6

The reliability mechanism does not work if the requirement is not met. Extra 1.5 GB required as a buffer. For more information see Persistence details.

For a complete list of files and directories added to your system by OneAgent, see OneAgent security on AIX.

OneAgent files aging mechanism

OneAgent in Full-Stack Monitoring mode uses a built-in aging mechanism to ensure that the OneAgent files, including log files and runtime data, are kept within a reasonable size. For more information, see OneAgent file aging mechanism.

Space required for updates

When calculating the space required for updates, we take into account the installer file size and the size of the installation process, that is the space required to deploy OneAgent files.

Installer file size
35 MB
Installation process size
465 MB

Additional space required for updates is calculated using the 10% safety margin:

(installer file size + size of the installation process) * 1.1

Size of the installation process

The size of the installation process is calculated as follows:

3 * installer file size + size of the installation

The installer size must be multiplied by 3 to account for:

  • Downloaded installer file (/var/lib/dynatrace/oneagent)
  • Archive, which is separated from the installer script (/opt/dynatrace/oneagent)
  • Unpacked external TAR (/opt/dynatrace/oneagent)

In terms of space requirements, there's no real difference between manual installation of the new version (when an older version is already installed), automatic update, and updates that are triggered by restarting the OneAgent container. In all these cases, the installation process is performed exactly the same way. What differs is the method through which the update is triggered.

Persistence details

The reliabilty mechanism ensures the persitance of Extention Execution Controller (EEC) logs in case ActiveGate or OneAgent is unavailable, there are network problems, or EEC experiences the data ingest overload. Thanks to the reliability mechanism, we're able to minimize the gaps in the log coverage.

General information

  • persistence is working by default if the volume requirement is satisfied - 2136 MB
    • 600 MB of free disk space to be used by the reliability mechanism
    • extra 1.5 GB of free disk space as a buffer (not used by the reliability mechanism)
  • the requirement is checked periodically and if not met, the persistence will be turned off - log ingest will be transmitted without the reliability mechanism
  • the volume is used proportionally to the load of logs ingest
  • if the requirement can't be met on the host, the configuration of logs persistence can by adjusted - for more information see Persistence configuration.

Configuration

Windows configuration file: C:\ProgramData\dynatrace\remotepluginmodule\agent\conf\extensionsuser.conf

Linux configuration file: /var/lib/dynatrace/remotepluginmodule/agent/conf/extensionsuser.conf

Variable

Description

persistence.reliable_mode

true - reliable mode turned on; SFM logs genereted if space requirement not met false - reliable mode turned off; log ingest will be transmitted without the reliability mechanism

persistence.total_limit_kb

Maximum volume limit for Extensions Log Persistence in kilobytes. By default: 600 MB Can be modified manually if the requirement can't be met on the host.