• Home
  • API
  • Environment
  • Settings
  • Schemas
  • Log buckets

Settings API - Log buckets schema table

Log buckets (builtin:logmonitoring.log-buckets-rules)

Dynatrace logs are stored in buckets. You can give each bucket a unique log retention period (35 days is the default). In addition, you can use buckets to set unique access rules to different logs or log areas. To create or manage buckets go to bucket permissions. Read more about using buckets for logs in our documentation.

Schema IDSchema groupsScope
builtin:logmonitoring.log-buckets-rules
  • group:log-monitoring.analysis
  • group:log-monitoring
environment
Retrieve schema via Settings API
GETManagedhttps://{your-domain}/e/{your-environment-id}/api/v2/settings/schemas/builtin:logmonitoring.log-buckets-rules
SaaShttps://{your-environment-id}.live.dynatrace.com/api/v2/settings/schemas/builtin:logmonitoring.log-buckets-rules
Environment ActiveGatehttps://{your-activegate-domain}/e/{your-environment-id}/api/v2/settings/schemas/builtin:logmonitoring.log-buckets-rules

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
enabledEnabledboolean-required
ruleNameRule nametext-required
bucketNameBuckettext

A 'bucket' is the length of time your logs will be stored. Select the bucket that's best for you.

required
matcherMatcher (DQL)text-required