By default, a newly created service account isn’t given any permissions. To export metrics, you need to grant your service account the ProjectAdmin role. See RBAC for more details.

​
Step 1: Generate API key

Generate the API key ID and API key secret in the Cloud Portal. See Generate an API key for details.

​
Step 2: Get Cloud_HOST

Get the corresponding CLOUD_HOST for your region and Cloud provider from the table below:
Region/CloudProviderCLOUD_HOST
us-east-2/awscanary-useast2-mgmt.risingwave.cloud
us-east-1/awsprod-aws-usea1-mgmt.risingwave.cloud
us-west-2/awsprod-aws-uswe2-mgmt.risingwave.cloud
eu-west-2/awsprod-aws-euwe2-mgmt.risingwave.cloud
eu-north-1/awsprod-aws-euno1-mgmt.risingwave.cloud
ap-southeast-1/awsprod-aws-apse1-mgmt.risingwave.cloud
europe-west3/gcpprod-gcp-euwe3-mgmt.risingwave.cloud
europe-north1/gcpprod-gcp-euno1-mgmt.risingwave.cloud

​
Step 3: Configure monitoring systems

Choose one of the following methods to configure monitoring systems.
The metrics are formatted according to Prometheus standards. If your monitoring collection mode is compatible with the Prometheus format, refer to the Prometheus section below to configure the collection.
To import the metrics to Prometheus, edit the scrape_configs section in the prometheus.yaml file as follows:
scrape_configs:
- job_name: risingwave-remote
  relabel_configs:
  - target_label: namespace
    regex: {NS_ID}
  - target_label: risingwave_name
    regex: risingwave
  - target_label: risingwave_component
    source_labels:
    - component
  static_configs:
  - targets:
    - {CLOUD_HOST}
  metrics_path: /api/v2/tenants/{NS_ID}/metrics
  basic_auth:
    username: {API_KEY}
    password: {API_SECRET}
  scrape_interval: 60s
  scrape_timeout: 60s
  scheme: https

​
Notes

  • Update the Cloud_HOST according to the region and Cloud provider of your RisingWave cluster.
  • Update the NS_ID with the specific UUID of your RisingWave project. To find the UUID, hover over the tag next to your project name.

​
Step 4: Set up dashboards

To set up dashboards with Grafana and Prometheus, please follow the Grafana dashboard build instructions to build a set of dashboards with multiple namespace support. For other systems, or to generate them programmatically, please refer to the script for generating the Grafana user-facing dashboard and build your own.