Process group log monitoring API - GET log content

Gets the content of the specified log.

The log content can be retrieved using this call only when logAnalysisStatus equals READY in the job status call. The request produces an application/json payload.

GET
  • Managed https://{your-domain}/e/{your-environment-id}/api/v1/entity/infrastructure/process-groups/{pgId}/logs/jobs/{jobId}/records
  • SaaS https://{your-environment-id}.live.dexp.ae/api/v1/entity/infrastructure/process-groups/{pgId}/logs/jobs/{jobId}/records

Parameters

Parameter Type Description In Required
pgId string

The enitity 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 /entity/infrastructure/hosts/{pgId}/logs/{logPath} request.

path required
scrollToken string

The scrollToken value from the previous response.

You can use it to get the next page of results. Without it the first page is always returned.

query optional
pageSize integer

The number of records per result page.

If not set then each page contains 100 results.

Maximum allowed value is 10000.

query optional

Response format

When scrolling through the result records using scroll token, the last result page contains an empty records list node and no scrollToken node.

The LogJobRecordsResult object

The results of the log analysis job.

Element Type Description
records LogRecord[]

The list of log analysis results.

The last page contains empty list.

scrollToken string

The scroll token for the next page of results.

Without it you'll get the first page again.

The LogRecord object

The analysis result for a single log entry.

Element Type Description
timestamp integer

The timestamp of the log entry, in UTC milliseconds.

logLevel string

The severity level of the log entry.

hostId string

The entity ID of the host that produced the log.

Not applicable to OS logs.

text string

The text of the log entry.

customFields object

The map of the log entry custom fields.

Example

In this example the request lists the content of the logs/Fvar/Flog/Fsyslog log of the PROCESS_GROUP-54A8B0B75D36E463 process group, which has been processed by the job with ID 707306f2-f3c2-4f7b-a457-cf00f7a65b1d.

The API token is passed in the Authorization header.

The response contains entries of this log. It is truncated to two entries.

Curl

curl -X GET \
  https://mySampleEnv.live.dexp.ae/api/v1/entity/infrastructure/process-groups/PROCESS_GROUP-54A8B0B75D36E463/logs/jobs/707306f2-f3c2-4f7b-a457-cf00f7a65b1d/records \
  -H 'Authorization: Api-Token abcdefjhij1234567890'

Request URL

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

Response content

{
  "records":[
    {
      "text":"Aug  4 10:46:07 all services working well",
			"timestamp":1470300367000
    },
    {
      "text":"Aug  4 10:46:08 all services stopped",
			"timestamp":1470300368000
    }
	],
  "scrollToken":"64"
}

Response code

200