Custom device logs API v1 - GET logs

deprecated

This API is deprecated.

For Log monitoring - Custom devices, Hosts, or Process Groups, what to use instead depends on which version of Log Monitoring you use:
- Log Management and Analytics: Grail Query API
- Log Monitoring Classic: Log Monitoring API
For Calculated metrics - Log Monitoring, use the Settings API endpoint with schemaId builtin:logmonitoring.schemaless-log-metric.

Lists all the available logs on the specified custom device.

The request produces an application/json payload.

GET	SaaS	`https://{your-environment-id}.live.dynatrace.com/api/v1/entity/infrastructure/custom-devices/{customDeviceId}/logs`
GET	Environment ActiveGate	`https://{your-activegate-domain}:9999/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.

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.

Code	Type	Description
200	LogListForCustomDeviceResult	Success
400	ErrorEnvelope	Failed. See the response body for details
4XX	ErrorEnvelope	Client side error.
5XX	ErrorEnvelope	Server side error.

Logs available on the Custom Device.

Element	Type	Description
logs	LogForCustomDevice[]	The list of available logs.

The list of available logs.

Element	Type	Description
availableForAnalysis	boolean	The log is available (`true`) or not available (`false`) for analysis.
path	string	The full path to the log.

{
  "logs": [
    {
      "availableForAnalysis": true,
      "path": "string"
    }
  ]
}