Skip to main content

KurocoFiles Log

You can check the access logs for files within Kuroco.

Accessing the screen

Image from Gyazo

Click [Log management] above the page title and click [KurocoFiles Logs] in the dropdown menu.  

Image from Gyazo

Field descriptions

Image from Gyazo

Filter conditions

You can easily filter the logs using the keyword search, date/time filters, and advanced search functions.

Image from Gyazo

Enter the search keyword in the [Keyword] text box and click [Search] to filter logs that contain the specified keyword.

Image from Gyazo

Select the date and time range for the timestamp and click [Search].   Logs are retained for 35 days. Ensure that the specified date range falls within this 35-day retention period.

Click the [Advanced search] button to input advanced filter conditions.

Image from Gyazo

The following input options are available:

FieldDescriptionSpecifiable conditions
Cache statusIndicates if this request was served by a cache.Cache status
HTTP methodHTTP method of the request.
StatusHTTP response status code for the request.
ResponseAPI response message.Available search operations
URIURI of the endpoint that sent the request.Available search operations
Client IP addressIP address of the user making the request.Available search operations
API access tokenAccess token which was sent with the request.Available search operations
Execution timeRequest execution time of the server.Available search operations
Body size Body size of HTTP request.Available search operations
Referer URL of the website right before the currently requested page.Available search operations
User agentThe user agent who requested the API.Available search operations
CityCity code of the user..Available search operations
Country codeCountry code of the user.Available search operations
IO info Fastly image optimizer data.Available search operations
Application request ID Kuroco request ID.Available search operations
Request IDFastly request ID.Available search operations

The advanced search function allows you to concatenate multiple conditions using AND or OR.

  • AND: Returns only data matching all the specified conditions in your search.
  • OR: Returns data matching any of your specified conditions.
Date and time range specification

The following date and time input options are available:

  • Date range
  • Relative
  • Time range
  • Datetime range
Available search operations

You can specify the following operations in the search conditions:

OperationInput typeReturned data
containsText stringEntries matching part of the search term.
not containsText stringEntries not matching any part of the search term.
=Alphanumeric stringEntries exactly matching the search term.
!=Alphanumeric stringEntries not exactly matching the search term.
<Alphanumeric stringEntries less than the search term.
>Alphanumeric stringEntries greater than the search term.
<=Alphanumeric stringEntries less than or equal to the search term.
>=Alphanumeric stringEntries greater than or equal to the search term.
starts withText stringEntries beginning with the search term.
not starts withText stringEntries not beginning with the search term.  
ends withText stringEntries ending with the search term.
not ends withText stringEntries not ending with the search term.
inAlphanumeric stringEntries matching any of the search terms (for multiple search terms only).
not inAlphanumeric stringEntries not matching any of the search terms (for multiple search terms only).
Sort

Under "Sort", you can specify the sort key and display order of the search results.

  • ASC: Ascending, from oldest to newest.
  • DESC: Descending, from newest to oldest.

Log entries

The columns displayed for the log entries are as follows:

ColumnDescription
Timestamp The date and time when the log was registered.
Cache statusIndicates whether the cache was used for the request. See Cache status for details.
HTTP method HTTP method.
StatusHTTP response status code.
ResponseAPI response message.
URI "URI endpoint to which the request was sent.
Client IP addressIP address of the user who sent the request.
API access tokenAccess token sent with the request.
Execution timeRequest execution time on the server.
Body size Body size of the HTTP request.
Referer URL of the referring website before the current request.
User agentUser agent that requested the API.
CityThe city where the user is located.
Country codeCountry code of the user.
IO info Fastly image optimizer data.
Request IDFastly request ID.
Application request ID Kuroco request ID.

Cache status

There are three types of cache status.

StatusDescription
HITThere was a request from the cache.
MISSReached the server without finding the cache.
PASSCould not cache.

Buttons

Image from Gyazo

ButtonDescription 
SearchSearch based on the above settings.
DownloadDownload a list of the displayed logs.
DeleteDelete a list of the displayed logs.

Log list download

After clicking the [Download] button, the download settings will open.

Image from Gyazo

Image from Gyazo

FieldDescription 
CharsetCharacter encoding of the output CSV file.
CancelCancel downloading.
DownloadExecute downloading.

Support

If you have any other questions, please contact us or check out Our Discord Community.