Skip to content

Operations & Logs ​

Applicable roles: Administrator

Prerequisites: Signed in with an administrator account

This guide covers three areas: Usage Overview (how much is being consumed), System Logs (who did what), and Extension Settings (attaching sub-applications).


1. Usage Overview ​

Usage overview

1.1 Core Metrics ​

MetricDefinition
Total TokensThe cumulative number of Tokens consumed by the platform
Total ConversationsThe cumulative number of sessions
Total UsersThe number of registered users on the platform

1.2 Usage Distribution ​

AreaDescription
Today's usage TOP3 modelsThe top three models ranked by Token consumption
Monthly usage trend (TOP3 models)Trends shown by month, with the Y axis representing the number of Tokens
User usage listA paginated list showing each user's group, total Tokens, and total conversations

Tip · The statistical dimension is the number of Tokens, not the number of requests. A single conversation with a long context consumes significantly more Tokens than a short conversation, so read the rankings together with the total conversation count.

1.3 Investigating Usage Anomalies ​

SymptomInvestigation direction
A user's Token count is abnormally highLook at that user's session list for runaway long conversations or looping tasks
A model's Token share is too highConfirm whether the default model was set to a high-priced model
Usage suddenly spikes in a given monthCheck whether a batch of new users was onboarded

2. System Logs ​

System log list

The platform keeps a complete audit trail of every key operation.

Recorded fieldDescription
UserThe operator
User groupThe operator's group at the time
Source IPClient address
IP locationThe resolved region
CategoryOperation category (login, container, assets, configuration, etc.)
ActionThe specific operation
DetailsThe operation content in JSON structure
StatusSuccess / failure
Error messageThe reason when the operation failed
TimePrecise to the millisecond

2.1 Multi-dimensional Filtering ​

System log filter

You can combine filters across the following dimensions:

DimensionDescription
UserBy operator
CategoryBy operation category
ActionBy specific action
StatusSuccess / failure
Source IPBy client address
LocationBy region
Time rangeBy start and end time

Tip · When troubleshooting, first filter by "Status = failure", then narrow down by time and user; usually one or two steps are enough to locate the problem.

2.2 Typical Investigation Scenarios ​

QuestionFilter path
Who changed the model provider configurationCategory = configuration, action = update, aligned with the time of the change
Whether a user's account was ever resetUser = the target user, action = reset password
Where the abnormal login in the middle of the night came fromStatus = failure, source IP is not the local machine
Who deleted a fileCategory = file, action = delete

3. Extension Settings ​

Add extension

An extension is a third-party sub-application embedded into the platform as an iframe. Once registered, an icon appears in the middle of the left navigation bar.

Each row in the extension list corresponds to a registered extension:

FieldDescription
IconThe icon displayed on the navigation bar
NameThe extension identifier, which determines the access path /ext/<name>
Display titleThe name shown on the navigation bar and the hover tooltip
PositionThe grouping position of the icon within the navigation bar
URLThe full address of the sub-application, it must be an absolute address
Sort orderThe display order on the navigation bar, smaller values come first
StatusEnabled / disabled

3.1 Add an Extension ​

FieldRequiredDescription
Name✅Unique identifier, lowercase English is recommended
Icon✅Icon identifier
Title✅Display name
URL✅Sub-application address, it must be an absolute address

Note · The URL must be an absolute address (with http:// or https://), otherwise the extension page will be blank.

3.2 Enable, Disable, Edit, and Delete ​

ActionEffect
EnableThe icon appears on the navigation bar, visible to everyone
DisableThe icon disappears and pages that are already open are no longer available
EditChanges to the name, icon, title, and URL take effect after saving
DeleteRemoved from the list. The extension container itself is not deleted, only the registration is canceled

Tip · Extensions are deployment-level configuration; the applications registered differ between environments, and the specific list is maintained by the deployer. For how users use them, see Extension Applications.


4. FAQ ​

SymptomCauseResolution
The usage overview has no dataNo conversations have taken place yetData only appears after normal use
A user ranks abnormally highLong conversations or looping tasksRead it together with the conversation count
A certain operation cannot be found in the logsThat operation is not within the audit scopeRefer to the "Category" list
The extension page is blankThe URL is not an absolute address, or the sub-application service is unreachableEdit extension
The extension cannot be seen on the navigation barIt is not enabledEnable extension
The extension icon does not refreshFrontend cacheRefresh the page; changes to the extension list actively trigger a reload

PageContents
Extension ApplicationsUsing embedded third-party sub-applications on the user side
Users & PermissionsAuditing group and user operations

Released under Sogood Technology · Shenzhen Sogood Technology Co., Ltd.