Get specific logs

get

https://{hostname}/edge-diagnostics/v1/grep

Using the grep command, returns logs that match the query parameters. This operation gets the data directly. If you don't have detailed information about the logs or you want to avoid latency, run the Launch a GREP request operation. If you provide request parameters for which Edge Diagnostics doesn't find logs, you get the validation error.

Query Params

edgeIp

string

required

IP address that belongs to edge server and you want to get the logs for. To verify if an IP address belongs to an edge server, run the Verify an IP operation. To get the IP, you may need to run the Get domain details with dig or Get diagnostic data of a group operation first. This is the IP value from the answerSection array in the Get domain details with dig operation response or the ip value from the edgeIps array in the collected diagnostic data.

cpCode

integer

required

CP code you want to get the logs for.

clientIp

string

Client IP to filter the logs by.

objectStatus

string

Object status codes you want to get the logs for. To see available values, check Object status codes.

httpStatusCode

integer

HTTP status code to filter the logs by.

userAgent

string

User agent to filter the logs by.

arl

string

ARL to filter the logs by.

start

string

ISO 8601 timestamp for a point of time in the past when the log search window starts. You can get the logs from either the last 6 or 24 hours depending on the server and traffic conditions. The recommended 10-minute periods ensure that data fetches quickly and you get the most relevant logs.

end

string

ISO 8601 timestamp for a point of time in the past when the log search window ends.

logType

string

enum

Enum Record type of the logs. Possible values are either R for client requests to an edge server or F for forward requests from an edge server to the origin.

Allowed:

accountSwitchKey

string

For customers who manage more than one account, this runs the operation from another account. The Identity and Access Management API provides a list of available account switch keys.

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

200The response provides the grep results and details about the request.

400Validation error.

401Authorization error.

403Permission error.

404Resource not found error.

405Method not allowed.

429Too many requests.