• Home
  • Dynatrace API
  • Environment
  • Settings
  • Schemas
  • Log storage configuration

Settings API - Log storage configuration schema table

Log storage configuration (builtin:logmonitoring.log-storage-settings)

Dynatrace allows you to include and exclude specific log sources for analysis by Dynatrace Log Monitoring.

The storage configuration is based on rules that use matchers for hierarchy, log path, and process groups. These rules determine the upload of log files known to OneAgent, auto-detected log files, and custom log files defined per process group. For more details and examples, see documentation.

Add multiple scopes if you want to include or exclude items based on multiple attributes.

Schema IDSchema groupsScope
builtin:logmonitoring.log-storage-settings
  • 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-storage-settings
SaaShttps://{your-environment-id}.live.dynatrace.com/api/v2/settings/schemas/builtin:logmonitoring.log-storage-settings
Environment ActiveGatehttps://{your-activegate-domain}/e/{your-environment-id}/api/v2/settings/schemas/builtin:logmonitoring.log-storage-settings

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
enabledActiveboolean-required
config-item-titleNametext-required
send-to-storageSend to storageboolean

If true matching logs will be included in storage. If false matching logs will be excluded from storage.

required
matchers-set-required

Request body objects

The Matcher object
PropertyLabelTypeDescriptionRequired
attributeAttributeenum-required
operatorOperatorenum-required
values-set-required