0%

Advanced Analytics - Logs

Introduction

The Logs report is included with our Advanced Analytics. The Logs report allows users to query logs for requests from within the CacheFly portal.

Using the available filters with the Logs report, users can view a broad range of logs down to pinpointing a single request.

A few common examples for using the Logs report are:

  • Identifying traffic trends

  • Tracking errors

  • Troubleshooting delivery/performance issues

Where to use the Logs Report

To access the Logs report:

  • Log in to the CacheFly portal

  • Navigate to the Advanced Analytics top-level menu and select Logs

  • Enter or select the data in the information fields to create a query

Continue scrolling to view more details on using the Logs report.

Using Logs Report

To create a query using the Logs report, you will need to enter a start date and time in the From filter and an end date and time in the To filter. If the remaining filters are left empty, the report will query for all requests during the selected timeframe.

To fine tune the Logs reports, use any of the remaining filters to narrow down the query to fit your needs.

Text Input Filters

For filters that contain a text input, we will default to including those filters in the query. However, you can exclude that filter by using a NOT operator by prepending an exclamation point (!).

For example, if 1.2.3.4 is entered into the Client IP (v4) filter, the query will include only requests from that IP. However, if !1.2.3.4 is entered into that filter, the query will exclude requests from that IP.

Dropdown Filters

In the filters with a dropdown, you can select whether that selection should be included or excluded as well. This is done by hovering over an item in the dropdown, which will display a box to next to that item allowing you to include or exclude that item.

Removing Filters

To remove a filter, follow the same steps above and either clear the text field or select Remove from Filter.

Customizing Filters and Columns

Customizing Filters

Filters can be displayed or hidden using the Edit Filters button in the top right of the screen. To display or hide a filter, either check or uncheck the box for the filter, then click Save.

Additionally, the filters can be reordered so the more commonly used filters are displayed first. To reorder, click the same Edit Filters button and use the vertical dots to the left of the filter and drag the item to the desired location. Then click Save.

You can also reset the filters back to the default list of displayed filters by using the Reset button in the Edit Filters pop-up. Once the filters are reset, don't forgot to click Save.

Customizing Columns

Much like filters, the Logs report columns can be customized to be displayed/hidden, and reordered for your needs.

Columns can be displayed or hidden similarly to Filters. To change the view of a column, click Edit Columns, check the columns you wish to display, then click Save.

The columns can also be reordered. To reorder columns, click Edit Columns, used the vertical dots to the left of the column and drag it to the desired location, then click Save.

Logs Report Query Filters

Below is a table showing the filter options for the Logs report and their definitions.

Filter Name

Filter Definition

From

Beginning query time in UTC.

This filter is required.

To

End query time in UTC.

This filter is required.

Service

Select either (All Services) or 1 service at a time to query.

Method

End-user HTTP method. Multiple methods can be selected and can either be included or excluded.

Query options: GET, POST, PUT, DELETE, HEAD, OPTIONS, and PATCH.

Status Code

Status code of a request. Multiple status codes can be selected and can either be included or excluded.

Query options: 1XX, 2XX, 3XX, 4XX, 5XX, or individual status codes (i.e. 200, 404, 503, etc.).

Path

Partial or full path not including query strings (i.e. /foo/bar/ or /foo/bar/example.txt).

Cache Status

Object CDN cache status. Multiple cache statuses can be selected and can either be included or excluded.

Query options: HIT, MISS, NOT CACHEABLE.

Client IP (v4)

End-user IPv4 address. Only 1 IP address can be queried for at a time.

Country

End-user country of origin. Multiple countries can be selected and can either be included or excluded.

Pop

POP location. Multiple POPs can be selected and can either be included or excluded.

Total Response Time (ms)

Total time taken, in milliseconds, to deliver the content to the end-user.

Hovering over the Add button allows the selection of: Equal to, Greater Than, Greater Than or Equal to, Less Than, or Less Than or Equal to.

Client IP (v6)

End-user IPv6 address. Only 1 IP address can be queried for at a time.

Note: If IPv6 is not enabled, we will log the IPv4 address the user is tunneled to by their ISP.

Hostname

Hostname from request

(i.e. example.cachefly.net or example.com).

Query Parameters

Query paramaters from request.

URI

End-users' requested URI (path and query parameters) of request

(i.e. /foo/bar/example.txt?query=param).

Referrer URL

Referrer used by end-user (Referer request header value).

Browser / Device

End-users' user-agent (User-Agent request header value).

Request Size (Bytes)

Size of the request received by the end-user.

Hovering over the Add button allows the selection of: Equal to, Greater Than, Greater Than or Equal to, Less Than, or Less Than or Equal to.

Data Transferred

Total Bytes transferred to end-user.

Hovering over the Add button allows the selection of: Equal to, Greater Than, Greater Than or Equal to, Less Than, or Less Than or Equal to.

Content-Type

Content-Type of file served (Content-Type response header value).

Content Length

Content-length header received by origin (Content-Length response header value).

Hovering over the Add button allows the selection of: Equal to, Greater Than, Greater Than or Equal to, Less Than, or Less Than or Equal to.

PoP Cache Status

Cache HIT or cache MISS in the PoP the user was routed to. Multiple statuses can be selected and can either be included or excluded.

Query options: HIT, MISS, NOT CACHEABLE.

CacheXCF1

CacheFly Layer 1 Cache Header. Multiple results can be selected and can either be included or excluded.

Query options: H, M, -.

CacheXCF2

CacheFly Layer 2 Cache Header. Multiple results can be selected and can either be included or excluded.

Query options: H, M, -.

CacheXCF3

CacheFly Layer 3 Cache Header. Multiple results can be selected and can either be included or excluded.

Query options: H, M, -.

CacheXCF4

CacheFly Layer 4 Cache Header. Multiple results can be selected and can either be included or excluded.

Query options: H, M, -.

Example Logs Report

In this example, we've selected all filters to be displayed and only the default columns to be displayed.

From those available filters, we are filtering for the following:

  • From: 2026-03-13 20:00:00 UTC

  • To: 2026-03-13 20:30:00 UTC

  • Service: filter for requests to myexample - 12345

  • Method: include GET method, exclude HEAD method

  • Status Code: include 200s, exclude 5xx and 4xx responses

  • Path: /foo/bar

  • Cache Status: include cache HITs

  • Client IP (v4): exclude requests from 5.6.7.8

  • Country: include United States

  • Pop: include (ORD) Chicago, exclude (IAD) Washington

  • Total Response Time: filter for requests greater than or equal to 2 seconds

  • Hostname: exclude requests with the hostname notmyexample.com

All other filters remained untouched.

0%