Install

Overview

The monitoring component serves as the infrastructure for monitoring, alerting, inspection, and health checking functions within the observability module. This document describes how to install the ACP Monitoring with Prometheus plugin or the ACP Monitoring with VictoriaMetrics plugin within a cluster.

Installation Preparation

Before install the monitoring components, please ensure the following conditions are met:

  • The appropriate monitoring component has been selected by referring to the Monitoring Component Selection Guide.
  • When install in a workload cluster, ensure that the global cluster can access port 11780 of the workload cluster.
  • If you need to use storage classes or persistent volume storage for monitoring data, please create the corresponding resources in the Storage section in advance.

Install the ACP Monitoring with Prometheus Plugin

Installation Procedures

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

  2. Locate the ACP Monitoring with Prometheus plugin and click Install.

  3. Configure the following parameters:

    ParameterDescription
    Scale ConfigurationSupports three configurations: Small Scale, Medium Scale, and Large Scale:
    - Default values are set based on the recommended load test values of the platform
    - You can choose or customize quotas based on the actual cluster scale
    - Default values will be updated with platform versions; for fixed configurations, custom settings are recommended
    Storage Type- LocalVolume: Local storage with data stored on specified nodes
    - StorageClass: Automatically generates persistent volumes using a storage class
    - PV: Utilizes existing persistent volumes
    Note: Storage configuration cannot be modified after Installation
    Replica CountSets the number of monitoring component pods
    Note: Prometheus supports only single-node installation
    Parameter ConfigurationData parameters for the monitoring component can be adjusted as needed
  4. Click Install to complete the installation.

Access Method

Once installation is complete, the components can be accessed at the following addresses (replace <> with actual values):

ComponentAccess Address
Thanos<platform_access_address>/clusters/<cluster>/prometheus
Prometheus<platform_access_address>/clusters/<cluster>/prometheus-0
Alertmanager<platform_access_address>/clusters/<cluster>/alertmanager

Install the ACP Monitoring with VictoriaMetrics Plugin

Prerequisites

  • If only install the VictoriaMetrics agent, ensure that the VictoriaMetrics Center has been installed in another cluster.

Installation Procedures

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

  2. Locate the ACP Monitoring with VictoriaMetrics plugin and click Install.

  3. Configure the following parameters:

    ParameterDescription
    Scale ConfigurationSupports three configurations: Small Scale, Medium Scale, and Large Scale:
    - Default values are set based on the recommended load test values of the platform
    - You can choose or customize quotas based on the actual cluster scale
    - Default values will be updated with platform versions; for fixed configurations, custom settings are recommended
    Install Agent Only- Off: Install the complete VictoriaMetrics component suite
    - On: Install only the VMAgent collection component, which relies on the VictoriaMetrics Center
    VictoriaMetrics CenterSelect the cluster where the complete VictoriaMetrics component has been installed
    Storage Type- LocalVolume: Local storage with data stored on specified nodes
    - StorageClass: Automatically generates persistent volumes using a storage class
    - PV: Utilizes existing persistent volumes
    Replica CountSets the number of monitoring component pods:
    - LocalVolume storage type does not support multiple replicas
    - For other storage types, please refer to on-screen prompts for configuration
    Parameter ConfigurationData parameters for the monitoring component can be adjusted
    Note: Data may temporarily exceed the retention period before being deleted
  4. Click Install to complete the installation.