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 | Managed | 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 Read logs (LogExport) permission assigned to your API token. 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
truewhen the stored log is ready for analysis.
Response codes
| Code | Type | Description |
|---|---|---|
| 200 | Log | Success |
| 400 | Error | Failed. See the response body for details |
Response body objects
The LogListForCustomDeviceResult object
Logs available on the Custom Device.
| Element | Type | Description | Required |
|---|---|---|---|
| logs | Log | The list of available logs. | optional |
The LogForCustomDevice object
The list of available logs.
| Element | Type | Description | Required |
|---|---|---|---|
| path | string | The full path to the log. | optional |
| availableForAnalysis | boolean | The log is available ( | optional |
Response body JSON model
{
"logs": [
{
"path": "string",
"availableForAnalysis": true
}
]
}