Process groups Log Monitoring API v1 - GET analysis job status

Gets the status of the specified log analysis job.

The request produces an application/json payload.

GET	ManagedDynatrace for Government	`https://{your-domain}/e/{your-environment-id}/api/v1/entity/infrastructure/process-groups/{pgId}/logs/jobs/{jobId}`
	SaaS	`https://{your-environment-id}.live.dynatrace.com/api/v1/entity/infrastructure/process-groups/{pgId}/logs/jobs/{jobId}`
	Environment ActiveGate	`https://{your-activegate-domain}:9999/e/{your-environment-id}/api/v1/entity/infrastructure/process-groups/{pgId}/logs/jobs/{jobId}`

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
pgId	string	The Dynatrace entity ID of the required process group.	path	required
jobId	string	The ID of the required log analysis job. You can retrieve it from the response of the POST analysis job request.	path	required

Parameter

Type

Description

Required

pgId

string

The Dynatrace entity ID of the required process group.

path

required

jobId

string

The ID of the required log analysis job.

You can retrieve it from the response of the POST analysis job request.

path

required

Response

Response codes

Code	Type	Description
200	LogJobStatusResult	Success
400	ErrorEnvelope	Failed. See the response body for details

Response body objects

The `LogJobStatusResult` object

The status the log analysis job.

Element	Type	Description
filterableFields	string[]	The map of the log entry filterable fields.
logAnalysisStatus	string	The status of the log analysis job. `AGENT_PROCESSING` `CANCELLED` `CANCEL_PENDING` `DOWNLOAD` `FAILED` `PROCESSING` `READY` `TRANSFERRING` `WAITING`
logHandlingError	string	The cause of the job failure. A successful job has the `NONE` value. `AGENT_VERSION_NOT_SUPPORTING_DOCKER` `CANCELLED` `FILE_ACCESS_DISABLED` `FILE_NOT_FOUND` `INCORRECT_DATE_FORMAT` `INCORRECT_LOG_FILE` `INTERNAL_PROCESSING_ERROR` `INVALID_FILTER_QUERY` `INVALID_SEARCH_QUERY` `NONE` `NO_LOG_AGENT` `PROCESSOR_FILE_PROCESSING_ERROR` `PROCESSOR_INTERNAL_ERROR` `PROCESSOR_INVALID_PARAMETER_ERROR` `PROCESSOR_NO_LOGS_FILE_FOUND_ERROR` `PROCESSOR_STOPPING_INTERRUPTED` `PROCESSOR_TIMED_OUT` `PROCESSOR_UNHANDLED_EXCEPTION` `PROCESSOR_UNZIPPING_ERROR` `REPACK_FAILED_TO_SAVE_LOG_ANALYSIS_IN_STORAGE` `REPACK_FAILED_TO_STORE_ALL_LOG_ANALYSIS` `REPACK_FAILED_TO_STORE_LOG_ANALYSIS` `SOME_LOG_INCORRECT_DATE_FORMAT` `TIMEOUT`
recordsTotal	integer	The number of analyzed log entries.
sortableFields	string[]	The map of the log entry sortable fields.
statusChangeTimestamp	integer	The timestamp of the last status change, in UTC milliseconds.

Response body JSON model

1{
2  "filterableFields": [
3    "string"
4  ],
5  "logAnalysisStatus": "AGENT_PROCESSING",
6  "logHandlingError": "AGENT_VERSION_NOT_SUPPORTING_DOCKER",
7  "recordsTotal": 1,
8  "sortableFields": [
9    "string"
10  ],
11  "statusChangeTimestamp": 1
12}

Example

In this example the request inquires the status of the log analysis job with the ID 707306f2-f3c2-4f7b-a457-cf00f7a65b1d.

The API token is passed in the Authorization header.

The response shows that the job has completed successfully—the logAnalysisStatus has the READY value—and it has analyzed 224 log entries.

Curl

1curl -X GET \
2  https://mySampleEnv.live.dynatrace.com/api/v1/entity/infrastructure/process-groups/PROCESS_GROUP-54A8B0B75D36E463/logs/jobs/707306f2-f3c2-4f7b-a457-cf00f7a65b1d \
3  -H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890'

Request URL

1https://mySampleEnv.live.dynatrace.com/api/v1/entity/infrastructure/process-groups/PROCESS_GROUP-54A8B0B75D36E463/logs/jobs/707306f2-f3c2-4f7b-a457-cf00f7a65b1d

Response content

1{
2  "logAnalysisStatus":"READY",
3  "statusChangeTimestamp":1470226839963,
4  "logHandlingError":"NONE",
5  "recordsTotal":224
6}

Response code

200