Version: v26.06

Log Extension Component Development Guide ​

Feature Introduction ​

As a pluggable extension component, the logging system is independently deployed on the openFuyao platform and provides log filtering, search, query, and alerting capabilities for both the platform and users.

Constraints ​

None.

Environment Preparation ​

For detailed installation steps, see Installation Guide.

Usage Scenarios ​

Scenario Overview ​

Developers need to install the log extension on the openFuyao cluster management plane. During installation, several options can be configured so that the logging system better matches service requirements:

  • Configure the time limit for collected logs and the log retention update policy.
  • Configure log collection sources.
  • Configure custom alerting rules for logs.

System Architecture ​

The service layer of the logging system consists of the UI layer, backend layer, and component layer.

  • UI layer: Users perform log operations on the console website.
  • Backend layer: logging-operator is deployed as a microservice to provide core capabilities such as log filtering, search, query, configuration, and alerting.
  • Component layer: Provides key capabilities for log collection, storage, and processing, and integrates with the backend layer to support efficient log operations.

Figure 1 Architecture of the log extension

Interface Description ​

Main APIs are listed in the following table.

Table 1 Main Interface Description

APIDescription
PATCH /rest/logging/v1/update-configAdd new collection jobs or modify existing collection jobs.
GET /rest/logging/v1/configmapList collection source paths for all workflows of the current log collection component.

Development Steps ​

After the log extension is installed successfully, for detailed steps see Logs.

Verification ​

When the configured collection job name and collection source path match the listed paths in workflows of the current logging system, the configuration takes effect.

Table 2 Verification API

APIDescription
GET /rest/logging/v1/configmapList collection source paths for all workflows of the current log collection component.
InterfaceDescription
GET /rest/logging/v1/configmapList collection source paths of all workflows of current log collection component.