Version: v26.03

Log Extension Component Development Guide ​

Feature Introduction ​

Log system as pluggable extension component, independently deployed and running in openFuyao platform, provides powerful log filtering, searching, querying and alerting capabilities for platform and users.

Constraints and Limitations ​

None.

Environment Preparation ​

For detailed installation steps, please refer to Installation Guide.

Usage Scenarios ​

Usage Scenario Overview ​

Developers need to install log extension component in openFuyao cluster management interface themselves. When installing extension component, several settings need to be configured to enable log system to better adapt to their own business scenarios. Configurable options include:

  • Configure time limit from creation to now for collected logs and log storage update time policy.
  • Configure log collection source configuration.
  • Configure custom alert triggering rules for log alerts.

System Architecture ​

Log system business layer is divided into UI layer, backend layer, and component layer.

UI layer: Users can perform log operations on console-website.

Backend layer: logging-operator is deployed in microservice form providing some core capabilities, including log filtering, searching, querying, configuration and alerting functions.

Component layer: Component layer provides key log collection, storage and processing capabilities for log system, and supports integration with backend layer, enabling users to efficiently perform log operations.

Figure 1 Log Extension Component System Architecture

Interface Description ​

Main interface descriptions are shown in following table.

Table 1 Main Interface Description

InterfaceDescription
PATCH /rest/logging/v1/update-configAdd new collection job and modify existing collection job.
GET /rest/logging/v1/configmapList collection source paths of all workflows of current log collection component.

Development Steps ​

Prerequisites ​

Log extension component has been successfully installed. For detailed installation steps, please refer to Logs.

Testing and Verification ​

When configured collection task name and collection source path match collection paths listed in workflows of current log collection system, it indicates that this configuration has successfully taken effect. Interface for viewing collection source paths of all workflows of current log collection component is shown in following table.

Table 2 Testing Interface Description

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