Skip to main content

Create and manage workspace

Workspace in Advanced Managed Prometheus is the basic unit for data management and monitoring. Each workspace can manage its data independently. Below is how to create and use a workspace.

Create workspace

Create a new workspace. Depending on the environment, it may take about 1 minute to complete.

  1. Go to KakaoCloud console > Management > Advanced Managed Prometheus.

  2. In the Workspace menu, click the [워크스페이스 생성] button in the upper right corner.

  3. Enter a workspace name and click the [생성] button.

    CategoryDescription
    Workspace nameName of the workspace to be created
    - Duplicate names are not allowed within the same project (only uppercase/lowercase letters, numbers, and hyphens allowed)
    - Example: workspace-1

Manage workspace

View workspace list

You can view the list of workspaces created within a project.

  1. Go to KakaoCloud console > Management > Advanced Managed Prometheus.

  2. In the Workspace menu, check the list of currently created workspaces.

    ItemDescriptionNote
    NameName defined by user at creationClick to view workspace details
    IDUnique workspace IDAutomatically assigned when created
    CreatorUser who requested workspace creation
    Created atDate and time of workspace creation

View workspace information

You can view detailed information for each workspace.

  1. Go to KakaoCloud console > Management > Advanced Managed Prometheus.
  2. In the Workspace menu, click the name of the workspace to view.
  3. View details in the tabs.

Header information

ItemDescription
CreatorUser who requested workspace creation
Created atDate and time of workspace creation

Details tab

ItemDescription
Workspace nameName defined by user at creation
Workspace IDUnique ID automatically assigned
Write endpointAPI used by Prometheus agents or servers to write metric data to cloud storage
Read endpointAPI for querying stored metrics, used by analysis tools such as Grafana

Alert policy tab

You can check alert policies configured in the workspace.
Alert policies can only be configured through Alert Center. For details, refer to Alert Center > Create and manage alert policies.

ItemDescription
Alert policy nameName defined by user when creating alert policy
Rule file nameName of rule file uploaded by user
Last alert sent atTime when the last alert was triggered by the policy

Monitoring tab

CategoryDescription
Data rangeTime range shown in monitoring graph
- 1 hour ago (default) / 3 hours ago / 12 hours ago / 1 day ago / 7 days ago
MetricsSelect metrics to monitor
- Write / Read / Rule
- All selected by default
- Multiple selections allowed
View modeSet view mode of monitoring graph
- 1-column, 2-column, 3-column layouts available
Auto refresh intervalSet auto refresh interval
- Off (default) / 10 seconds / 30 seconds / 1 minute / 5 minutes
Manual refreshRefresh monitoring results by clicking refresh button
Monitoring data
ItemMonitoring dataDescription
WriteIngestion rate (Count/s)Number of samples ingested per second
WriteActive series (Count)Number of currently active time series
WriteDiscarded samples (Count/s)Number of samples dropped without processing
ReadQuery per second (Count/s)Number of queries executed per second
ReadQuery latency (Sec)Average time to process queries
ReadQuery samples scanned (Count/s)Number of samples scanned during query
RuleRule evaluations (Count)Number of rule evaluations per minute
RuleRule evaluation failures (Count)Number of failed rule evaluations per minute
Discarded samples legend types

The legend of discarded samples displays warning messages based on reason for failure.

ItemDescription
greater_than_max_sample_ageSample discarded due to being too old
new-value-for-timestampDifferent values found for same timestamp
per_metric_series_limitExceeded active series limit per metric (Max: 200,000)
per_user_series_limitExceeded active series limit per user (Max: 10,000,000)
rate_limitedReached sample ingestion limit (Max: 170,000 per second)
sample-out-of-orderSample not sent in chronological order
label_value_too_longLabel value exceeds allowed length (Max: 2048 characters)
max_label_names_per_seriesExceeded max label count per series (Max: 70)
missing_metric_nameMetric name not provided
metric_name_invalidInvalid metric name provided
label_invalidInvalid label provided
duplicate_label_namesDuplicate label names provided

Edit workspace

info

Workspace ID and endpoints cannot be changed after creation. Only the workspace name can be modified.

  1. Go to KakaoCloud console > Management > Advanced Managed Prometheus.

  2. In the Workspace menu, click the [수정] button in the upper right corner.

  3. Modify the workspace name and click the [저장] button.

    CategoryDescription
    Workspace nameName of the workspace
    - Duplicate names are not allowed within the same project (only uppercase/lowercase letters, numbers, and hyphens allowed)
    - Example: workspace-1

Delete workspace

Delete a workspace that is no longer in use.

caution

Once deleted, metric data in the workspace cannot be recovered.

  1. Go to KakaoCloud console > Management > Advanced Managed Prometheus.

  2. In the Workspace menu, click the [삭제] button in the upper right corner.

  3. In the Delete workspace popup, enter the name of the workspace to delete, then click the [삭제] button.