• Home
  • Dynatrace API
  • Environment
  • Settings
  • Schemas
  • OneAgent

Settings API - OneAgent schema table

OneAgent (builtin:logmonitoring.log-agent-configuration)

Configure OneAgent options for Dynatrace Log Monitoring

Schema IDSchema groupsScope
builtin:logmonitoring.log-agent-configuration
  • group:log-monitoring
  • group:log-monitoring.ingest-and-processing
HOST - Host
HOST_GROUP - Host Group
environment
Retrieve schema via Settings API
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

PropertyLabelTypeDescriptionRequired
LAConfigIISDetectionEnabledDetect IIS logsboolean-required
LAConfigSystemLogsDetectionEnabledDetect system logsboolean

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

required
LAConfigLogScannerLinuxNfsEnabledDetect logs on Network File Systems (NFS)boolean-required
LAConfigMonitorOwnLogsEnabledAllow OneAgent to monitor OneAgent logsboolean

Enabling this option may affect your DDU consumption. For more details, see documentation.

required
LAConfigContainersLogsDetectionEnabledDetect logs inside containersboolean-required
LAConfigOpenLogFilesDetectionEnabledDetect open log filesboolean-required
LAConfigUTCAsDefaultContainerTimezoneSet UTC as the default time zone for containersboolean

Deprecated for OneAgent 1.247+

required
LAConfigContainerTimezoneHeuristicEnabledDetect container time zonesboolean-required
LAConfigDefaultTimezoneDefault timezone for agentstext

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

required
LAConfigDateSearchLimit_BytesTimestamp search limitinteger

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

required
LAConfigSeverityDetectionLimit_BytesSeverity search chars limitinteger

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

required
LAConfigSeverityDetectionLinesLimitSeverity search lines limitinteger

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

required
LAConfigMaxLgisPerEntityCountMaximum of log group instances per entity limit - countinteger

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

required
LAConfigEventLogQueryTimeout_SecWindows Event Log query timeoutinteger

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

required
LAConfigMinBinaryDetectionLimit_BytesMinimal log file size to perform binary detection.integer

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

required