• Home
  • Dynatrace API
  • Environment
  • Settings
  • Schemas
  • Monitoring

Settings 2.0 - Monitoring schema

Monitoring (builtin:host.monitoring)

OneAgent automatically monitors host, its processes, services and applications but you can switch off monitoring, disable full-stack monitoring or auto-injection.

Schema IDSchema groupsScope
builtin:host.monitoring-
HOST - Host
Retrieve schema via Settings API
GETManagedhttps://{your-domain}/e/{your-environment-id}/api/v2/settings/schemas/builtin:host.monitoring
SaaShttps://{your-environment-id}.live.dynatrace.com/api/v2/settings/schemas/builtin:host.monitoring
Environment ActiveGatehttps://{your-activegate-domain}/e/{your-environment-id}/api/v2/settings/schemas/builtin:host.monitoring

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
enabledMonitor this hostboolean

Turn on monitoring to gain visibility into this host, its processes, services, and applications.

required
fullStackFull-stack monitoringboolean

Dynatrace uses full-stack monitoring by default, to monitor every aspect of your environment, including all processes, services, and applications detected on your hosts.

If you turn off full-stack monitoring, Dynatrace will only monitor your infrastructure. You will lose access to application performance, user experience data, code-level visibility and PurePath insights.

To learn more, visit Infrastructure Monitoring mode.

Please note that changing the monitoring mode will impact the license consumption of this OneAgent. To learn more, visit Host units.

Full-stack monitoring will be applied to a process after its restart.

The OneAgent's monitoring mode will automatically overwrite this setting whenever it is changed with oneagentctl or the OneAgent comes online.

required
autoInjectionAuto-injectionboolean

An auto-injection disabled with oneagentctl takes precedence over this setting and cannot be changed from the Dynatrace web UI.

required