Docs

Volcengine Managed Service for Prometheus

Creating a workspace

Creating aggregation query workspaces

If you need to view monitoring data of multiple workspaces, you can create an aggregation query workspace for a global view. This topic describes the procedure and considerations for creating an aggregation query workspace.

tip

[Beta · Apply for Trial]: This feature is currently in beta. If you want to use it, contact your account manager.

Limits

The aggregation query workspace must be associated with at least one common workspace.

Prerequisites

A common workspace or a local workspace has been created. For more details, refer to Creating common workspaces and Creating local workspaces.

Operation Procedures

In the top navigation bar, select the target region.

On the left navigation bar, click Workspace to go to the workspace list page.

Click Create, and click the Aggregated workspace tab to configure the aggregation query workspace.

Parameter	Descriptions
Aggregation query workspace name	Specify a name for the aggregation workspace. The name is in the string format and must be 1 to 100 characters in length.
Description	Specify the description of the aggregation query workspace. You can specify the detailed information about the workspace, including the purpose and scope of the workspace.
Project	The project to which the workspace belongs. Project management is a resource management mechanism that Volcano Engine provides to enable grouping of cloud resources by project. Project-based authorization with Identity and Access Management (IAM) facilitates resource isolation and data security, while streamlining expense allocation and auditing for diverse cloud resources. For details, see Project management.
Tags	Add labels to the workspace. A label is used to identify the workspace. You can combine labels with selectors to filter workspaces. A label is a key-value pair that allows you to classify and aggregate cloud resources from different dimensions. You can use labels for resource authorization and bill splitting. For details, see Managing labels. tip You can add up to 50 labels.
Enable custom authentication (optional)	By default, the aggregation query workspace supports authentication through Volcano Engine AK/SK for data writing and query. You can also manually enable and configure custom authentication based on your business requirements. tip The common workspace provides dual-mode AK/SK authentication capability by default: Use the standard signature method of Volcano Engine AK/SK to complete identity verification by carrying signature information in the request header. Use the Volcano Engine AK as the username and the SK as the password to complete basic authentication. This meets the access requirements of third-party tools. Enable custom authentication: After you enable this option, workspaces support custom authentication and Volcano Engine AK/SK authentication. Custom authentication is categorized into the following two types: Basic Auth and Bearer Token. tip Basic Auth and Bearer Token cannot be both enabled. Basic Auth: A basic authentication method that supports authentication through custom usernames and passwords, which achieves data writing and query. Bearer Token: A token-based authentication method that supports authentication through tokens, which achieves data writing and query. Disable custom authentication (default): After you disable custom authentication, you can use the default Volcano Engine AK/SK method to perform authentication.
Basic Auth (optional)	You need to specify the following parameters only if Enable custom authentication is enabled and Basic Auth is used for authentication. User name: Specify a username used for Basic Auth authentication. Password: Specify a password used for Basic Auth authentication. Confirm password: Enter the password used for basic authentication again and ensure the two passwords are identical.
Bearer Token (optional)	You need to specify this parameter only if Enable custom authentication is enabled and Bearer Token is used for authentication. You can click auto generation to obtain a Token or manually enter a Token. This token is used to validate requests and restrict the scope of operations. warning The bearer token will be stored by the system through reversible encryption to ensure token data security. To prevent risks caused by the manually configured token, such as weak passwords and repeated use, we recommend that you use the automatic generation feature of the Volcano Engine to obtain the token.
Should single workspace query errors be ignored	Specify whether to ignore the query errors of a single workspace during queries. Ignores the query errors of a single workspace. If an error occurs in a workspace, only data queried from other workspaces will be returned. This is suitable for scenarios where high accuracy of monitoring data is not required. Does not ignore the query errors of a single workspace. If an error occurs in a workspace, an error in the entire aggregation workspace is reported during queries. This is suitable for scenarios where high accuracy of monitoring data is required.
Select the workspaces to aggregate.	Select workspaces for aggregation queries. At least 2 standard workspaces need to be selected. warning Only workspaces within the same region and the same account can be aggregated.

Click Create now, and wait for the system to create the workspace.

Verifying results

Obtain the query URL

After the aggregation query workspace is created, you can view the workspace in the workspace list.

Click the workspace name to go to the details page of the workspace, and allow viewing and obtaining the query URL of the workspace.

Query aggregation metrics

You can use the Explore feature or Grafana to view the metrics in the aggregation query workspace. The __ws__ tag will be added to the metrics, which indicates the ID of the workspace where the metrics belong, such as __ws__: f7a69888-***.

tip

Use the custom Grafana to access the workspace and query metrics. Refer to Deploying Grafana in a VKE cluster and accessing workspaces.

Last updated: 2026.07.10 11:37:25