Managing a Cluster

You can use the pgEdge Cloud console to review cluster information; highlight the name of a cluster in the Clusters menu to access the console for that cluster.

The cluster console header

The console header displays information about the selected cluster:

  • the console name
  • the length of time since console creation
  • the name of the cloud provider
  • the number of regions that host nodes
  • the instance type and size of each node

Also in the cluster header, a set of informational panes tell you the state of the cluster at a glance:

  • the total node count
  • the number of healthy nodes
  • the number of unhealthy nodes
  • the number of unresponsive nodes

Use the drop-down menu in the upper-right corner to delete a cluster.

Use the lower section of the console window to access detailed information about each node.

The Cluster Overview Tabs

Cluster Overview

Tabs below the cluster header provide quick access to information about the state of your cluster:

  • Select the Overview tab to view information about the cluster, and the databases currently deployed on the cluster. Detailed information about the cluster's nodes is displayed below. Click on an icon in the Database pane to navigate to detailed information about the selected database.
  • Select the Metrics tab to view details about cluster resource use.
  • Select the Logs tab to review the log files for the cluster.

The Nodes pane displays node and connection details for each node in the cluster. To view information for a specific cluster node, select the tab labeled with the cluster name.

The cluster console Nodes tab

The Nodes information pane contains general node information:

  • Use the External IP Address when making ssh connections to the node.
  • Use the Internal IP Address when configuring VPN connections to the node.
  • The Instance Type and Volume Size fields provide node size information.
  • Use the Instance ID to identify the node and associated resources in the cloud provider console.

Below the Nodes browser, a map displays the locations of the cluster's nodes. Hover over a mapped node to display the name and city in which the node resides.

The cluster console Map tab

The Metrics Tab

Select the Metrics tab to display graphed metrics for the cluster. To display a graph that compares information for all of the nodes in the cluster, choose the All Nodes display option. To graph information for a single cluster node, choose the cluster name/location combination in the tab browser.

The cluster console Metrics tab

The graphs display usage statistics for each node in the cluster:

  • The CPU graph displays the percentage of CPU usage.
  • The Memory Usage graph displays the percentage of Memory usage.
  • The Disk Usage graph displays the amount of disk used(in GB).
  • The Running Processes graph displays a count of the number of processes used.
  • The Network Receive graph displays the time used by inbound processes (in Kb).
  • The Network Send graph displays the time used by outbound processes (in Kb).

Each node in the cluster is represented by a different color of line in the graph. Use the Select Timeframe drop-down to select the amount of time that is represented in the Metrics graphs.

Specify a Metrics graph timeframe

Position the selection bar to display detailed metrics for a specific point in time.

Display point in time metrics

The Logs Tab

Select the Logs tab to display logging activity for the cluster. To display the log files for all of the nodes in the cluster, choose the All Nodes display option. To display the log files for a single specific cluster node, choose the node name/location combination in the tab browser.

The cluster console Logs tab

Navigation buttons across the top of the log display allow quick access to log files:

  • The system log displays system calls used to create and manage the nodes on your system.

  • The nodectl log displays the pgEdge management commands invoked while creating and managing the cluster. For detailed information about pgEdge commands, see the documentation for pgEdge Platform.

  • The postgres log displays user commands invoked against the PostgreSQL server (opens in a new tab) that resides on the node.

  • The docker log displays the commands that manage the Docker containers used by your deployment.

  • The sshd log displays the log files for the SSH daemon monitoring your nodes for connections.

pgEdge Resources

Use the links in the lower-left corner of the pgEdge Cloud console to access pgEdge resources:

  • For an invitation to the pgEdge Discord server, select the Community link.
  • To review the documentation, select the Docs link.
  • To manage account details, select the Settings link.
  • Select the Team Management link to manage account membership.