Skip to main content

Admin API/MCP logs

The Admin API/MCP logs screen displays the logs of the management operations performed through the Admin API and the Admin MCP. Operations performed directly in the admin panel are recorded in the Admin panel logs.

Accessing the screen

In the left sidebar menu, click [Operation] -> [Log management].

Image from Gyazo

Click the [Log management] link above the page title, and select [Admin API/MCP logs] in the dropdown menu.

Image from Gyazo

Field descriptions

Image from Gyazo

Filter conditions

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

Enter the search keyword in the [URI] text box and click [Search] to filter logs whose URI contains the specified keyword.

Select the date and time range for the timestamp and click [Search].
The designated logging period is 35 days. When specifying past log dates, please make sure to specify within the 35-day range.

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

The following input options are available:

FieldDescriptionSpecifiable conditions
HostSite accessed.Available search operations
Log levelLog level indicating the importance of the message.Available search operations
ActionGateway the request came through.Action
HTTP method / credentialHTTP method of the request and the credential used for the authentication.Available search operations
OperationRequested endpoint, or the executed operation.Available search operations
Execution time / resultExecution time of the request, or the result of the operation.Available search operations
Body sizeSize of the response.Available search operations
URIURI of the endpoint the request was made to.Available search operations
Client IP addressIP address of the user who attempted the access.Available search operations
Member IDMember ID of the user who attempted the access.Available search operations
Application request IDUnique request ID used by Kuroco.Available search operations
User agentUser agent of the client used for the access.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.
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
TimestampDate and time the log was recorded.
HostSite accessed.
Log levelLog level indicating the importance of the message.
ActionGateway the request came through. See: Action below for details.
HTTP method / credentialHTTP method of the request and the credential used for the authentication.
OperationRequested endpoint, or the executed operation. See: Recorded log types below for details.
Execution time / resultExecution time of the request in milliseconds, or the result of the operation. See: Recorded log types below for details.
Body sizeSize of the response in bytes.
URIURI of the endpoint the request was made to.
Client IP addressIP address of the user who attempted the access.
Member IDMember ID of the user who attempted the access.
Application request IDUnique request ID used by Kuroco.
User agentUser agent of the client used for the access.

Action

ValueDescription
AdminAPIRequest made through the Admin API.
AdminMCPRequest made through the Admin MCP.

[Action] shows these values in the log list. In the advanced search, the [Action] dropdown shows the options as [Admin API] and [Admin MCP]. Select one of them to display the logs of that gateway only.

Recorded log types

Two kinds of logs are recorded for a single request:

TypeOperationExecution time / resultBody size
Access logRequested endpoint, or the JSON-RPC method name.Execution time of the request in milliseconds.Size of the response in bytes.
Executed operation logExecuted operation.Summary of the result.Not displayed.

Buttons

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 click [Download] button, the download settings will open.

Image from Gyazo

Field(s)Description
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.