O&M Log

  • Last update: 2026-08-12
  • Overview

    Version

    FineOps Version
    Functional Change
    V1.5.5/
    V1.5.7

    1. Supported single-time log download from multiple cluster nodes.

    2. Supported log selection by specified service type.

    V1.5.9

    1. Added Basic Log Information in O&M Log.

    2. Supported log type selection during O&M log download.

    V1.13.0Supported the download of more logs related to O&M components.
    V2.0.0Optimized interactions and relocated the function entry.
    V2.1.0Supported O&M log download when the project was unavailable.
    V2.3.0Supported the export of exporter.log (the indicator collection log) and FineOperation.log (the self-service crash-handling tool log).
    V2.10.0Supported custom selection of logs to download for projects with the Elasticsearch component enabled, shortening download time.
    V2.14.0Supported daily and precise-time log downloads for FineOps-deployed projects.
    V2.25.0Supported the export of update.log (the FineBI data update log).
    V2.26.0Supported the export of fine-ai and fine-chat-bi-parser component logs.
    V2.38.0Added the Data Retention Days function to support custom retention periods.

    Application Scenario

    Some companies have strict controls over equipment rooms. The process of entering an equipment room is complicated, and obtaining logs is time-consuming and labor-intensive. With FineOps, you can quickly and easily locate and download debug logs of O&M projects on the page.

    For projects with heavy usage, logs grow quickly and may easily fill up the disk. In FineOps, you can set Data Retention Days in Log Management to control the log size.

    Log Introduction

    In FineOps, you can view log storage locations and download the following types of logs.

    LogDescription
    fanruan.logThis log records the runtime information of FanRuan applications.
    standard.logThis log is available only for FineBI projects. It records FineBI cluster information and is usually stored in logs/cluster.
    eventlogThis log is available only for FineBI projects. It records details about dataset updates calculated by the Spark engine and helps analyze slow Spark executions.
    BIEvent.logThis log is available only for FineBI projects. It records FineBI configuration operations.
    polars.logThis log is available only for FineBI projects. It records calculations related to dashboards and dataset editing.
    operator_calculate.logThis log is available only for FineBI projects. It records calculations related to dashboards and dataset editing.
    update.logThis log is available only for FineBI projects. It records data updates.
    access.logThis log records Nginx access details, including the access time, IP address, request method, access path, and HTTP status code.
    catalina.outThis log records Tomcat standard output and standard errors, including Tomcat logs and application-console output.
    catalina.logThis log records Tomcat runtime information, mainly during startup and shutdown.
    localhost_access_log.txtThis log records Tomcat request access details, including the request time, request type, requested resource, and returned status code.
    messages.txtThis Linux system log records events and errors, including startup, shutdown, hardware failures, and software crashes.
    agent.logThis log records information about the OPS Agent component.
    exporter.logThis log records project indicator collection information.
    FineOperation.logThis log records scheduled self-service crash-handling tasks and their execution details.

    Log Management

    You can view the log storage location and set the data retention days of logs in Log Management. 

    Viewing Log Storage Locations

    You can view the O&M log storage location of each project node.

    Applicable Scope

    This function applies only to projects that do not use the Elasticsearch component to store logs.

    If the Elasticsearch component is installed for log storage, the Storage Location field displays Elasticsearch Log Service instead of a specific path.

    Procedure

    1. Log in to FineOps as the admin, select an O&M project, and choose Log > O&M Log.

    2. In Log Management, click View next to Storage Location to view the O&M log storage location of each project node.

    Notes

    If a certain type of log does not exist, the storage location of that log is not displayed.

    Setting Data Retention Days

    For heavily used projects, logs grow quickly and may easily fill up the disk. In FineOps, you can customize data retention days to control log storage usage.

    Applicable Scope

    This function applies only to projects that use the Elasticsearch component to store logs.

    Procedure

    1. Log in to FineOps as the admin, select an O&M project, and choose Log > O&M Log.

    2. In Log Management, click Edit next to Data Retention Days.

    3. Set the data retention days in the Rule Adjustment dialog box. The default retention period is 7 days.

    4. Click Save. The configuration takes effect immediately.

    Notes

    1. Logs older than the retention period are automatically cleared. Do not set this value too small to avoid losing historical logs you require.

    2. FineOps does not provide a direct log cleanup entry. To reduce disk space occupied by historical logs, you can shorten data retention days.

    Downloading O&M Logs

    No.ProcedureNotes
    1Log in to FineOps as the admin, select an O&M project, and choose Log > O&M Log.
    2Select a download mode and time range.

    1. For projects that use Elasticsearch to store logs, two modes are available:

    • Download by Exact Time: It covers logs within the retention period and allows a time span of up to 2 days. The default precise-time range is from 2 hours before the current time to the current time. 

    • Download by Daily: It has no date range limit and defaults to the current day.

    2. Projects that use the Swift engine to store logs support Download by Day only, which defaults to the current day.

    3Select a service type.

    Supported types: fr, fdl, bi-web, bi-engine-worker, and bi-engine-master.

    Selectable range: You can select service types that exist within the selected time period. All service types are selected by default. 

    Notes: 

    1. Service type selection is unavailable for projects not deployed via FineOps. 

    2. If no service type exists, this option is not displayed.

    4Select nodes.Selectable range: You can select all nodes in the selected O&M project. All nodes are selected by default.
    5Select the logs to download.

    For supported types, see the table in the "Log Introduction" section of this document.

    If a certain type of log does not exist, that type of log cannot be downloaded.

    6Click Download to generate an O&M log file on the local computer.

    1. If the file size exceeds 5 GB, it cannot be exported, and the following prompt is displayed: "The size of the following log(s) exceeds the upper limit (5 GB), and the download failed: Log type"

    2. If this type of log file does not exist, the log cannot be exported, and the following prompt is displayed: "The following log does not exist: Log type." 

    3. Logs are compressed during download. If the wait is too long, click Cancel Download to stop the download. 

    4. After decompression, the log files are organized by service type, date, and node address.

    Notes

    FanruanLog Compression Error

    Problem Description

    During log download, the "compress FanruanLog error" error occurs.

    Cause Analysis 

    This is caused by insufficient disk space.

    Solution 

    Expand the disk corresponding to the mounting directory of the O&M project to ensure sufficient space for compressed files.

    result (6).png

    System O&M Subprocess Connection Failure

    Problem Description

    After you (the admin) log in to FineOps, select an O&M project, and choose Log > O&M Log, the following error message is displayed: "Failed to connect the System O&M subprocess."

    Troubleshooting:

    1. Log in to the FanRuan application as the admin, choose System Management > Intelligent O&M > Crash Handling, and confirm that Auto Memory Stack Export is enabled.

    2. Use the curl command to ensure network connectivity between FineOps and the project server.

    3. If SSL is configured for both FineOps and the project, ensure that the certificates on both sides have not expired.

    4. Disable and then re-enable the System O&M plugin, and reconnect FineOps and the O&M project.

    Attachment List


    Theme: Project Management
    • Helpful
    • Not helpful
    • Only read

    滑鼠選中內容,快速回饋問題

    滑鼠選中存在疑惑的內容,即可快速回饋問題,我們將會跟進處理。

    不再提示

    10s後關閉

    Get
    Help
    Online Support
    Professional technical support is provided to quickly help you solve problems.
    Online support is available from 9:00-12:00 and 13:30-17:30 on weekdays.
    Page Feedback
    You can provide suggestions and feedback for the current web page.
    Pre-Sales Consultation
    Business Consultation
    Business: international@fanruan.com
    Support: support@fanruan.com
    Page Feedback
    *Problem Type
    Cannot be empty
    Problem Description
    0/1000
    Cannot be empty

    Submitted successfully

    Network busy