Settings API - Process instance snapshots schema table
Process instance snapshots (builtin:process-visibility)
If this feature is enabled, Dynatrace examines the most resource-consuming processes running on your host and the processes monitored by Process availability. When a triggering event occurs, metrics reported 10 minutes before and 10 minutes after the event for those processes are sent to the cluster.
A graph of the resource consumption by process is available.
If Process instance snapshots is triggered by Process availability, you can see the behavior of processes before they ended, and whether they restarted within 10 minutes.
Reported process metrics:
CPU usage (%)
Memory usage (B)
Incoming network traffic (KB)
Outgoing network traffic (KB)
Metrics are reported once per minute and cover the number of processes defined in Reported processes limit.
Each host can report up to 60 minutes of these metrics per day. When the limit is exceeded, metrics aren't sent even when a new event arises.
Events triggering Process instance snapshots:
High host CPU usage
High system load
High host memory usage
High packet drop rates
High NIC utilization rates
High number of NIC errors
Manual requests
Process availability events
For details, see Process instance snapshots
| Schema ID | Schema groups | Scope |
|---|---|---|
builtin:process-visibility |
| HOST - HostHOST_GROUP - Host Groupenvironment |
| GET | Managed | https://{your-domain}/e/{your-environment-id}/api/v2/settings/schemas/builtin:process-visibility |
| SaaS | https://{your-environment-id}.live.dynatrace.com/api/v2/settings/schemas/builtin:process-visibility | |
| Environment ActiveGate | https://{your-activegate-domain}/e/{your-environment-id}/api/v2/settings/schemas/builtin:process-visibility |
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
| Property | Type | Description | Required |
|---|---|---|---|
Enable Process instance snapshotsenabled | boolean | - | required |
Reported processes limitmaxProcesses | integer | The maximum amount of processes that host may report is 100 | required |