• Home
  • Dynatrace API
  • Environment
  • Settings
  • Schemas
  • Activate Grail for logs and events

Settings API - Activate Grail for logs and events schema table

Activate Grail for logs and events (builtin:logmonitoring.logs-on-grail-activate)

Your tenant is eligible for Grail. For details, see documentation.

After activation, you will:

  • Use Grail storage with custom retention times. For details, see Log buckets and retention and Business event bucket assignment

  • Use DQL for data analysis, log metrics, event definition, and processing rules. For details, see Migration to DQL.

Your existing log data will not be available after you activate Grail.

Because logs typically contain sensitive data, access to Grail is restricted to administrators. For details, see account settings.

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

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
activatedActivate logs powered by Grail.boolean-required