Altinity Cloud Manager Introduction

An overview of using the Altinity Cloud Manager (ACM) to managing your ClickHouse clusters with Altinity.Cloud.

26 January 2023 · Read time 3 min

Overview - Altinity Cloud Manager

This section introduces the Altinity Cloud Manager for managing ClickHouse cluster environments. The Altinity Cloud Manager (ACM) is where your existing clusters are shown. https://acm.altinity.cloud/clusters/

Points of interest marked by the red pins include:

  • The your.environment name is what you signed up with, otherwise a cluster name appears hear in this menu.
  • The John Doe is an example of your logged-in name.
  • The left pane collapses or expands the text labels beside the icons.
  • The Launch Cluster text tag refers to the call-to-action LAUNCH CLUSTER button.
Launch Cluster button

Figure 1 – The Altinity Cloud Manager (ACM) home screen with no clusters showing.


Looking at the Demo

To switch to the demo environment:

  1. Use the environment menu to switch to demo to see the clusters.
Launch Cluster button

Figure 2 – The environment menu, where the demo name is selected.


The demo environment has several example clusters:

  • posthog
  • clickhouse101
  • meetup
  • github

Panel View

To see the detail for the cluster named clickhouse101:

  1. In the cluster named clickhouse101, hover over pane, the outline turns blue, then click .
Launch Cluster button

Figure 3 – The demo environment showing several cluster panels.


List View

The list view provides a spreadsheet table view of your clusters.

  1. Select the List View icon.
Launch Cluster button

Figure 4 – The list view of all the demo clusters.

Cluster Dashboard view

Selecting a cluster name from a panel view or list view displays the settings that were set by the Cluster Launch Wizard.

Launch Cluster button

Figure 5 – Detailed settings view of the cluster clickhouse101.

Explore View

While viewing your cluster, selecting the Explore button displays the Query screen. This is where SQL queries are run on your cluster. Note the additional tabs for Schema, Workload and DBA Tools.

Launch Cluster button

Figure 6 – The cluster Query tab screen. This is where SQL queries are run.

Grafana Monitoring View

From your cluster dashboard view, selecting the Monitoring View in Grafana link displays the graphs shown in the following screenshot.

Launch Cluster button

Figure 7 – The Grafana graphs for the K8S Namespace demo, for the cluster named clickhouse101.

A Wizard-Created Cluster

When you create a new cluster using the LAUNCH CLUSTER Wizard, the example-environment-name appears in your Altinity Cloud Manager (ACM).

Points of interest include:

example-environment - Menu name changes to the selected environment (aka namespace or domain).
2/2 nodes online - Green to indicate running status. Action > Stop to take offline.
0/2 nodes online - Red shows nodes are not running. Action > Resume to start.
stopped - Cluster / node is not running. Action > Resume to start.
6/6 checks passed - Shows green when all 6 checks have completed successfully.
0/6 checks passed - Shows red until all checks have passed. Action > Resume to start.
Shield green - TLS (Transport Layer Security) is enabled.
Actions - Mouse hover shows this light blue shade.
Blue outline - In cluster panel view, moving your mouse cursor over a cluster changes the grey outline to blue; click to view.
Panel view icon - View clusters in panel format.
List view icon - View cluster in a list format.
Address of all clusters - https://acm.altinity.cloud/clusters/
Address of a specific cluster - https://acm.altinity.cloud/cluster/2887

Cluster Launch Wizard summary

Figure 8 – Points of interest from the newly created example-cluster.

Last modified 2023.01.26: Getting Started rewrite