Custom device logs API v1 - GET logs

Lists all the available logs on the specified custom device.

The request produces an application/json payload.

  • Managed https://{your-domain}/e/{your-environment-id}/api/v1/entity/infrastructure/custom-devices/{customDeviceId}/logs
  • SaaS https://{your-environment-id}{customDeviceId}/logs
  • Environment ActiveGate https://{your-activegate-domain}/e/{your-environment-id}/api/v1/entity/infrastructure/custom-devices/{customDeviceId}/logs


To execute this request, you need the Read logs (LogExport) permission assigned to your API token. To learn how to obtain and use it, see Tokens and authentication.


Parameter Type Description In Required
customDeviceId string

The Dynatrace entity ID of the required custom device.

path required


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 Description



Failed. See the response body for details

Response body

The LogListForCustomDeviceResult object

Logs available on the Custom Device.

Element Type Description
logs LogForCustomDevice[]

The list of available logs.

The LogForCustomDevice object

The list of available logs.

Element Type Description
path string

The full path to the log.

availableForAnalysis boolean

The log is available (true) or not available (false) for analysis.