Process group log monitoring API - POST analysis job
Starts the log analysis job.
Optionally, you can specify the timeframe of analysis, by providing the start and the end time stamp. You can also specify a query to filter log content.
The request produces an application/json payload.
| POST |
|
Authentication
To execute this request, you need the Read log content (LogExport) permission assigned to your API token. To learn how to obtain and use it, see Tokens and authentication.
Parameters
Note All special characters in the log path must be escaped.
| Parameter | Type | Description | In | Required |
|---|---|---|---|---|
| pgId | string |
The Dynatrace entity ID of the required process group. |
path | required |
| logPath | string |
The full pathname of the log. |
path | required |
| hostFilter | string |
Narrows down the scope of the analysis to process groups, running at the specified hosts. Specify the entity ID of the required host here. To specify several IDs, separate them with a comma. |
query | optional |
| query | string |
Narrows down the scope of the analysis to the entries, matching the specified criteria. The criteria must use the Dynatrace search query language. |
query | optional |
| startTimestamp | integer |
The start timestamp of the analysis range, in UTC milliseconds. If not set, then 2 hours behind from current timestamp is used. |
query | optional |
| endTimestamp | integer |
The end timestamp of the analysis range, in UTC milliseconds. If not set, then the current timestamp is used. |
query | optional |
| body | ExtractFields |
Extract fields from the log content to form custom columns. See the Search patterns in log data and parse results help page for the syntax definition and examples. The special characters must be escaped. |
body | optional |
The ExtractFields object
A query to extract log content to a custom column.
| Element | Type | Description | Required |
|---|---|---|---|
| parsingMode | string |
The parsing mode for log analysis entries presentation. Possible values are: |
optional |
| customParsingPatterns | string |
The query for content extraction. See the Search patterns in log data and parse results help page for the syntax definition and examples. |
optional |
This is a model of the request body, showing the possible elements. It has to be adjusted for usage in an actual request. See the Example expandable section for working sample request.
{
"parsingMode": "json",
"customParsingPatterns": "\"user %{STRING:User} logged\", \"job took %{INTEGER:Time} ms\""
}
Response format
| Element | Type | Description |
|---|---|---|
| jobId | string | The ID of the started job. |
{
"jobId": "string"
}
Response codes
| Code | Description |
|---|---|
| 202 | Success. The response body contains the ID of the job. |
| 400 | Failed. See response body for details |
| 404 | Not found. See response body for details |
Example
In this example the request starts a log analysis job for the logs/var/log/syslog log of the PROCESS_GROUP-54A8B0B75D36E463 process group. The timeframe of analysis lies between timestamps 1470300000000 and 1470360000000.
The API token is passed in the Authorization header.
The response contains the ID of the started analysis job.
Curl
curl -X POST \
https://mySampleEnv.live.dynatrace.com/api/v1/entity/infrastructure/process-groups/PROCESS_GROUP-54A8B0B75D36E463/logs/%2Fvar%2Flog%2Fsyslog?startTimestamp=1470300000000&endTimestamp=1470360000000 \
-H 'Authorization: Api-Token abcdefjhij1234567890' \
Request URL
https://mySampleEnv.live.dynatrace.com/api/v1/entity/infrastructure/process-groups/PROCESS_GROUP-54A8B0B75D36E463/logs/%2Fvar%2Flog%2Fsyslog?startTimestamp=1470300000000&endTimestamp=1470360000000
Response content
{
"jobId":"707306f2-f3c2-4f7b-a457-cf00f7a65b1d"
}
Response code
202