The View Logs (GREP) tool uses the GREP command to retrieve and parse logs for an edge server IP address. The tool retrieves the logs for a particular hostname or CP code of your choice. You can get the logs from either the last 6 or 24 hours depending on the server and traffic conditions.
The results of this tool can help you identify errors in the traffic either between a client and an edge server or the edge server and origin.
Learn how to submit a request in the View logs (GREP) tool.
Go to ☰ > SUPPORT > Edge Diagnostics.
In the side menu, select > View logs (GREP).
Select whether you want to filter the logs by Host headers or CP codes. Enter up to 10 values.
Select the Log record type of interest. You can get logs for:
- Client requests to an edge server (r). Requests from client’s machine to an edge server.
- Forward requests from an edge server (f). Requests between edge and origin servers.
Select the Time period you want to get the logs for. You can get logs from either the last 6 or 24 hours depending on the server and traffic conditions.
The recommended time frame is 10 minutes. It ensures that you quickly get only the most relevant data.
Optional: Add filters.
a. Select a filter to filter the logs by. The available filters are:
- User agent. For the list of all possible values, check the List of User Agents.
- HTTP status code. Click the hyperlink to specify if you want the filter to include or exclude specific values.
- ARL. Akamai Resource Locator (ARL) is a modified object URL that contains an object's caching properties and resolves to the optimal Akamai server. To learn about the ARL syntax, check ARL syntax.
- Client IP.
b. Enter up to 10 filters values.
What you should see
If you entered more than host header or CP code, Edge Diagnostics divides your input; one request per host header or CP code/edge server IP pair. All requests appear in the Recent requests table.
Click your request’s row to check the results. If you see in the Actions column, it means, that your request could not be processed and you need to retry.
The Logs preview include the following data:
- Date time. The time when the request was submitted.
- Log type. Either r, for requests from client to edge server or f, for forward requests from edge to origin server.
- CS IP. Customer IP. The IP of a user’s machine. Not shown for forward requests.
- FW IP. Forward IP. The IP of an edge server that forwarded the request to the origin server. Not shown for client requests.
- CS method. Action taken by the user on CS URL, possible options are:
- GET for getting a resource.
- POST for creating a new resource.
- PUT for updating a resource.
- DELETE for deleting a resource.
- CS URL. The URL accessed by the user of the CS IP.
- CS status. The status of the operation represented by the HTTP response code.
- Content type. The format of the downloaded object.
- Bytes served. The number of bytes served by the server.
- Bytes received. The number of bytes received and processed by the server.
- Object size. The size of the downloaded object.
- Time taken. Time the whole operation lasted, in seconds.
- CS (referer). The previous site visited by the user.
- CS (user agent). The browser used by the user.
- CS (cookie). The content of the cookie sent or received, if any.
- Error. The error code returned. For details, check Error codes.
- SSL version. Secure Sockets Layer version used during the request.
- Host header. Header specifying the host and port number of the request's server.
For more details on returned Object status codes, check Object status.
Updated about 2 months ago