Managing a Cluster

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.

If you recently created or modified the cluster, the header displays a banner showing the cluster state. The console header also displays information about the selected cluster:

• The cluster name.
• The length of time since the last cluster update.
• The cluster connection type (Public or Private), which indicates whether the cluster nodes are in a public subnet.
• The Cluster ID associated with the cluster.
• The name of the cloud provider account on which the cluster resides; click the account name to navigate to the details page for the account.
• User-defined resource tags associated with the cluster.

The cluster header also displays a set of informational panes that show 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.

The Cluster Information Tabs

The tabbed browser on the Cluster tab provides 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 nodes displays below. Click 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 cluster log files.

The Overview Tab

Select the Overview tab to review information about the cluster. Panes on the Overview tab contain links to cluster artifacts:

• Select a database name in the Databases pane to navigate to the information page for that database.
• Select a backup store name in the Backup Store pane to navigate to the information page for the store.

The Nodes pane contains general node information. Use the tabbed browser to select a node and review information about that node:

• The Availability Zone lists the provider region in which the node is deployed.
• 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.
• The Instance ID identifies the node and associated resources in the cloud provider console.
• The UUID is a unique identifier for cluster resources outside of the cloud provider console; use the UUID when making API calls.

When the Overview tab is selected, a map displays the locations of the cluster nodes. Hover over a mapped node to display the name and city in which the node resides.

The Overview tab also displays the currently defined Firewall Rules.

Select the Manage Firewall Rules button to open a dialog that allows you to modify or create rules for the cluster.

The Overview tab also displays the current VPC Associations:

Select the + Add VPC Association button to add a new association.

The Overview tab also displays a list of the current public ingresses:

Select the + Add Ingress button to create a public ingress for a cluster without a public-facing IP address.

Reviewing Cluster Metrics

Select the Metrics tab to review detailed system resource usage for the cluster.

Select from the tabs across the top to review graphs containing:

• metrics for all nodes in your cluster.
• metrics for a specific node in your cluster.

The drop-down at the top of the Metrics pane allows you to specify the length of time displayed by each graph.

Select a point on a graph to display information about the graphed event that occurred on your cluster:

The following table describes the available graphs:

Reviewing Cluster Log Files

Select the Logs tab to review log files for the cluster.

Use the tabs across the top to select the nodes for which you want to review log files. Then select one of the following log types:

• System logs to review the system commands performed to manage your cluster.
• Docker logs to review the Docker-specific commands executed to manage the container in which your cluster is running.
• SSH logs to review details about SSH connections made to your cluster.

Use the Auto refresh/Manual refresh drop-down to specify whether log entries update automatically (Auto refresh) or pause updating (Manual refresh) for easier viewing. To manually refresh the log table's content, select the refresh button to the right of the drop-down.

Use the controls in the table header to sort or search the selected log file:

• Select a column heading to sort alphabetically by the column value; select a second time to reverse the sort order.
• Click the filter icon to the right of the Level heading to select a status from the drop-down; all rows assigned the selected status will be filtered to the top of the result set.

• Use the search box to the right of the Message label to enter a search string; the search term will be highlighted in the log file entries. Use the navigation arrows to move to the next or previous occurrence of the search term.

Cluster Administration Links

Use the links at the end of the navigation pane to access pgEdge Cloud resources:

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