Settings API - Advanced log settings schema table

Advanced log settings (builtin:logmonitoring.log-agent-configuration)

Configure OneAgent options for Dynatrace Log Monitoring

Schema ID
Schema groups
Scope
builtin:logmonitoring.log-agent-configuration
  • group:log-monitoring
  • group:log-monitoring.ingest-and-processing
HOST - Host
HOST_GROUP - Host Group
environment
GETManagedhttps://{your-domain}/e/{your-environment-id}/api/v2/settings/schemas/builtin:logmonitoring.log-agent-configuration
SaaShttps://{your-environment-id}.live.dynatrace.com/api/v2/settings/schemas/builtin:logmonitoring.log-agent-configuration
Environment ActiveGatehttps://{your-activegate-domain}/e/{your-environment-id}/api/v2/settings/schemas/builtin:logmonitoring.log-agent-configuration

Authentication

To execute this request, you need an access token with Read settings (settings.read) scope. To learn how to obtain and use it, see Tokens and authentication.

Parameters

Property
Type
Description
Required
Detect open log files
LAConfigOpenLogFilesDetectionEnabled
boolean

Automatically detect logs written by important processes. For more details, check our documentation

required
Detect system logs
LAConfigSystemLogsDetectionEnabled
boolean

Linux: syslog, message log Windows: system, application, security event logs

required
Detect logs of containerized applications
LAConfigContainersLogsDetectionEnabled
boolean

Allows detection of log messages written to the containerized application's stdout/stderr streams.

required
Detect IIS logs
LAConfigIISDetectionEnabled
boolean

Allows detection of logs and event logs written by IIS server.

required
Detect logs on network file systems
LAConfigLogScannerLinuxNfsEnabled
boolean

Allows detection of logs written to mounted network storage drives. Applies only to Linux hosts. For other OSes it's always enabled.

required
Allow OneAgent to monitor Dynatrace logs
LAConfigMonitorOwnLogsEnabled
boolean

Enabling this option may affect your licensing costs. For more details, see documentation.

required
Detect container time zones
LAConfigContainerTimezoneHeuristicEnabled
boolean

Enables automatic detection of timezone in container's logs if it is not explicitly defined in content or configured.

required
Default timezone for agents
LAConfigDefaultTimezone
text

Default timezone for agent if more specific configurations is not defined.

required
Timestamp search limit
LAConfigDateSearchLimit_Bytes
integer

Defines the number of characters in every log line (starting from the first character in the line) where the timestamp is searched.

required
Severity search chars limit
LAConfigSeverityDetectionLimit_Bytes
integer

Defines the number of characters in every log line (starting from the first character in the line) where severity is searched.

required
Severity search lines limit
LAConfigSeverityDetectionLinesLimit
integer

Defines the number of the first lines of every log entry where severity is searched.

required
Maximum of log group instances per entity limit - count
LAConfigMaxLgisPerEntityCount
integer

Defines the maximum number of log group instances per entity after which, the new automatic ones wouldn't be added.

required
Windows Event Log query timeout
LAConfigEventLogQueryTimeout_Sec
integer

Defines the maximum timeout value, in seconds, for the query extracting Windows Event Logs

required
Minimal log file size to perform binary detection.
LAConfigMinBinaryDetectionLimit_Bytes
integer

Defines the minimum number of bytes in log file required for binary detection.

required