OneAgent monitoring configuration API - GET configuration
This API is deprecated. Use the Settings API with the Monitoring (builtin:host.monitoring) schema instead.
Gets the monitoring configuration of OneAgent on the specified host.
The request produces an application/json payload.
| GET | ManagedDynatrace for Government | https://{your-domain}/e/{your-environment-id}/api/config/v1/hosts/{id}/monitoring |
| SaaS | https://{your-environment-id}.live.dynatrace.com/api/config/v1/hosts/{id}/monitoring | |
| Environment ActiveGate | https://{your-activegate-domain}/e/{your-environment-id}/api/config/v1/hosts/{id}/monitoring |
Authentication
To execute this request, you need an access token with ReadConfig scope.
To learn how to obtain and use it, see Tokens and authentication.
Parameters
| Parameter | Type | Description | In | Required |
|---|---|---|---|---|
| id | string | The Dynatrace entity ID of the required host. | path | required |
Response
Response codes
| Code | Type | Description |
|---|---|---|
| 200 | Monitoring | Success |
Response body objects
The MonitoringConfig object
Monitoring configuration of OneAgent.
| Element | Type | Description |
|---|---|---|
| metadata | Configuration | Metadata useful for debugging |
| id | string | The Dynatrace entity ID of the host where OneAgent is deployed. |
| monitoringEnabled | boolean | The monitoring is enabled ( |
| monitoringMode | string | The monitoring mode for the host: full stack or infrastructure only. |
| autoInjectionEnabled | boolean | Code modules will be injected automatically into monitored applications if this setting is enabled. This setting won't apply if auto-injection is disabled via oneagentctl (see https://dt-url.net/oneagentctl). |
The ConfigurationMetadata object
Metadata useful for debugging
| Element | Type | Description |
|---|---|---|
| configurationVersions | integer[] | A sorted list of the version numbers of the configuration. |
| currentConfigurationVersions | string[] | A sorted list of version numbers of the configuration. |
| clusterVersion | string | Dynatrace version. |
Response body JSON model
{
"metadata": {
"configurationVersions": [
4,
2
],
"currentConfigurationVersions": [
"1.0.4",
"1.23"
],
"clusterVersion": "1.192.1"
},
"id": "HOST-0123456789ABCDE",
"monitoringEnabled": true,
"monitoringMode": "FULL_STACK",
"autoInjectionEnabled": true
}