Install

The platform's logging system consists of two plugins: ACP Log Collector and ACP Log Storage. This chapter will introduce you to the installation of these two plugins.

WARNING
  1. After the successful installation of the ACP Log Storage plugin, the cluster where the component is installed can be used as the storage cluster for various clusters in the platform (optional during the installation of the ACP Log Collector plugin) to provide log storage services for all clusters in the platform.

  2. The global cluster can query the log data stored on any workload cluster within the platform. Ensure that the global cluster can access port 11780 of the workload cluster.

  3. The ACP Log Storage with Clickhouse plugin and the ACP Log Storage with ElasticSearch plugin cannot be installed in the same cluster. Please read the Selection Suggestions and choose to install one of the log storage plugins.

Install ACP Log Storage with ElasticSearch

  1. Navigate to App Store Management > Cluster Plugin and select the target cluster.

  2. In the Plugins tab, click the action button to the right of ACP Log Storage with ElasticSearch > Install.

  3. Refer to the following instructions to configure relevant parameters.

    ParameterDescription
    Connect External ElasticsearchKeep closed to install the log storage plugin within the platform.
    Component installation SettingsLocalVolume: Local storage, log data will be stored in the local storage path of the selected node. The advantage of this method is that the log component is directly bound to local storage, eliminating the need to access storage over the network and providing better storage performance.
    StorageClass: Dynamically create storage resources using storage classes to store log data. The advantage of this method is a higher degree of flexibility; when multiple storage classes are defined for the entire cluster, administrators can select the corresponding storage class for the log components based on usage scenarios, reducing the impact of host malfunction on storage. However, the performance of StorageClass may be affected by factors such as network bandwidth and latency, and it relies on the redundancy mechanisms provided by the storage backend to achieve high availability of storage.
    Retention PeriodThe maximum time logs, events, and audit data can be retained on the cluster. Data exceeding the retention period will be automatically cleaned up.
    Tip: You may back up data that needs to be retained for a long time. If you need assistance, please contact technical support personnel.
  4. Click Install.

Install ACP Log Storage with Clickhouse

  1. Navigate to App Store Management > Cluster Plugin and select the target cluster.

  2. In the Plugins tab, click the action button to the right of ACP Log Storage with Clickhouse > Install.

  3. Refer to the following instructions to configure relevant parameters.

    ParameterDescription
    Component installation SettingsLocalVolume: Local storage, log data will be stored in the local storage path of the selected node. The advantage of this method is that the log component is directly bound to local storage, eliminating the need to access storage over the network and providing better storage performance.
    StorageClass: Dynamically create storage resources using storage classes to store log data. The advantage of this method is a higher degree of flexibility; when multiple storage classes are defined for the entire cluster, administrators can select the corresponding storage class for the log components based on usage scenarios, reducing the impact of host malfunction on storage. However, the performance of StorageClass may be affected by factors such as network bandwidth and latency, and it relies on the redundancy mechanisms provided by the storage backend to achieve high availability of storage.
    Retention PeriodThe maximum time logs, events, and audit data can be retained on the cluster. Data exceeding the retention period will be automatically cleaned up.
    Tip: You may back up data that needs to be retained for a long time. If you need assistance, please contact technical support personnel.
  4. Click Install.

Install ACP Log Collector Plugin

  1. Navigate to App Store Management > Cluster Plugin and select the target cluster.

  2. In the Plugins tab, click the action button to the right of ACP Log Collector > Install.

  3. Select the Storage Cluster (where ACP Log Storage has been installed) and click Select/Deselect log types to set the scope of log collection in the cluster.

  4. Click Install.