Custom device logs API v1 - GET logs
Lists all the available logs on the specified custom device.
The request produces an application/json
payload.
GET | ManagedDynatrace for Government | https://{your-domain}/e/{your-environment-id}/api/v1/entity/infrastructure/custom-devices/{customDeviceId}/logs |
SaaS | https://{your-environment-id}.live.dynatrace.com/api/v1/entity/infrastructure/custom-devices/{customDeviceId}/logs | |
Environment ActiveGate | https://{your-activegate-domain}/e/{your-environment-id}/api/v1/entity/infrastructure/custom-devices/{customDeviceId}/logs |
Authentication
To execute this request, you need an access token with LogExport
scope.
To learn how to obtain and use it, see Tokens and authentication.
Parameters
Parameter | Type | Description | In | Required |
---|---|---|---|---|
customDeviceId | string | The Dynatrace entity ID of the required custom device. | path | required |
Response
The result is a JSON, containing the array of objects, each representing a log.
- For the default environment, the availableForAnalysis attribute is always set to
true
. - For upgraded Log Monitoring environments, the availableForAnalysis attribute is set to
true
when the stored log is ready for analysis.
Response codes
Code | Type | Description |
---|---|---|
200 | Log | Success |
400 | ErrorEnvelope | Failed. See the response body for details |
Response body objects
The LogListForCustomDeviceResult
object
Logs available on the Custom Device.
Element | Type | Description |
---|---|---|
logs | Log | The list of available logs. |
The LogForCustomDevice
object
The list of available logs.
Element | Type | Description |
---|---|---|
availableForAnalysis | boolean | The log is available ( |
path | string | The full path to the log. |
Response body JSON model
{
"logs": [
{
"availableForAnalysis": true,
"path": "string"
}
]
}