Background Services

Monitor and adjust the status of the services that support the feature quality users experience, as well as cleanup and maintenance services.


How to Check

Click System Administration > Background Services > View Details.

Background services

Performance Metrics

Select a lookup period (1h / 6h / 24h / 7d) to see the overall statistics for that period.

ItemDescription
Total throughputThe number of jobs processed by all services
Total errorsThe number of errors that occurred
Total memory usageThe combined memory usage of all services
ActiveThe number of services currently running

You can view the number of jobs processed, processing rate, memory usage, and uptime for each service in a list.

Service List

Services are divided into two categories: Core Features and Auxiliary Operations.

Core Features

Services that directly support the feature quality users experience.

ServiceCategoryDescription
Knowledge indexerKnowledge indexingReads and splits documents into data the AI can search.
File indexing schedulerFile searchPeriodically refreshes the file search index.
Metadata autocompleteFile searchPrepares autocomplete candidates from file information to assist search input.
Recent files cacheFile searchMaintains temporary data to quickly display the recent files list.
Transform ingestFile operationsDetects new and converted files and forwards them for preview generation, text extraction, and AI search processing.
Realtime chat persistenceReal-time sessionsSafely commits real-time conversation content to storage.
Filespace batch deleteFile operationsMoves multiple files to trash and cleans up their related information.

Auxiliary Operations

Operational services responsible for cleanup, protection, and maintenance.

ServiceCategoryDescription
Index prunerFile searchCleans up outdated or unnecessary index data.
AI request state cleanupReal-time sessionsCleans up long-lingering AI request states and response action caches.
Session state cleanupReal-time sessionsCleans up expired session states to keep real-time connections stable.
AI pending state cleanupCleanup tasksCleans up AI approval-pending, file-creation-pending, and task plan states.
File operation task cleanupCleanup tasksPeriodically cleans up completed asynchronous file operation states.
Temporary access cleanupCleanup tasksCleans up expired temporary access states and tokens.
Upload state cleanupCleanup tasksCleans up old upload states, conflict information, and user preferences.
Memory monitorSystem protectionMonitors the memory used by SpaceBuilder to prevent server overload.

Service Control

Each service can be adjusted individually.

  • Pause: Temporarily stops the service.
  • Reset counters: Resets statistics to 0. This does not affect actual data.
  • Auto-refresh: Refreshes status in real time.
  • Restart: Restarts all background services at once.

Service Status

StatusDescription
NormalThe service is running normally
WaitingA normal state, waiting for a job to process
PausedThe admin has temporarily stopped the service
StoppedThe service is not running
WarningAn error has occurred or the service needs attention

In the Warning state, first check the last error and error count. If the error count keeps increasing, restart the service; if the same issue persists, check the server logs.