Manage instance
This guide explains how to manage running PostgreSQL instances in the service.
View instance list
You can view the list of instances included in an active PostgreSQL instance group. For more about the relationship between instance groups and instances, see Key Concepts.
-
Go to the KakaoCloud Console > Data Store > PostgreSQL.
-
Select the instance group whose instance list you want to view.
-
Navigate to the Instance tab.
Item Description Instance name The name specified when the PostgreSQL instance was created AZ The availability zone where the instance was created Status Instance status
- See Lifecycle and status valuesAvailability status Indicates replication state between instances (HA only)
- See Instance availability statusRole Role of the instance
- See Availability and rolesInstance type The type selected at creation Storage size Base and log storage size configured at creation Uptime Time elapsed since last update (create/restart/failover) Created at Instance creation date and time
Monitor instances
You can view monitoring results for PostgreSQL instance groups in the Monitoring tab.
-
Go to the KakaoCloud Console > Data Store > PostgreSQL.
-
Select the PostgreSQL instance group to monitor.
-
Click the Monitoring tab.
Item Description Monitored instance Select instance to monitor Metric items Choose metrics to display
- Options: PostgreSQL, CPU, Memory, Filesystem, Disk, Network
- Default view shows all
- Multiple selections allowedData period Period shown in monitoring graph
- Options: 1 hour (default), 3 hours, 12 hours, 1 day, 7 daysView mode Graph layout mode: single, two-column, or three-column views Auto-refresh interval Options: Off (default), 10 sec, 30 sec, 1 min, 5 min Manual refresh Click to refresh the monitoring graph
Monitoring metrics
Category | Metric | Description |
---|---|---|
PostgreSQL | Connection (count) | Number of total PostgreSQL connections |
PostgreSQL | Connections (count) | Number of active PostgreSQL connections |
PostgreSQL | Lock sessions (count) | Number of PostgreSQL lock sessions |
PostgreSQL | Deadlocks (count) | Number of deadlocks in PostgreSQL |
PostgreSQL | Active transactions (count) | Number of active transactions |
PostgreSQL | Replication lag (sec) | Replication delay time |
PostgreSQL | Buffer hit ratio (%) | Buffer cache hit ratio |
PostgreSQL | Vacuum XID | Measured vacuum XID per DB |
PostgreSQL | Temp file usage per DB (%) | Temp file usage by DB |
CPU | Total usage (%) | Total CPU usage over time |
Memory | Total usage (%) | Total memory usage over time |
Memory | Usage by type (Bytes) | Memory usage per type over time |
Filesystem | Total usage (%) | Total filesystem usage over time |
Filesystem | Total usage (Bytes) | Total filesystem usage in bytes over time |
Filesystem | Inode usage by mount (%) | Inode usage per mount over time |
Disk | Read Bytes (Bytes/sec) | Disk IO read over time |
Disk | Write Bytes (Bytes/sec) | Disk IO write over time |
Disk | Read IOPS (IO/sec) | Read operations per second |
Disk | Write IOPS (IO/sec) | Write operations per second |
Network | RX by interface (Bytes) | Received bytes per network interface |
Network | TX by interface (Bytes) | Transmitted bytes per network interface |
Network | RX by interface (PPS) | Packets per second received |
Network | TX by interface (PPS) | Packets per second transmitted |
View instance logs
PostgreSQL logs can be viewed through the Log Explorer in KakaoCloud’s monitoring service.
- Go to the KakaoCloud Console > Monitoring.
- Click the Explorer tab and select PostgreSQL from the Log Explorer.
- Check the query period and enter your log filter. File path filtering is not supported.
- After setting search criteria, logs and charts will display results.
For more on log explorer, see Log Explorer.
Restart PostgreSQL
You can restart PostgreSQL for a running instance.
- You cannot restart PostgreSQL if the instance status is
Pending
,Starting
, orTerminating
. - Restarting the primary may cause a brief downtime.
- Go to the KakaoCloud Console > Data Store > PostgreSQL.
- Select the instance group of the PostgreSQL instance to restart.
- Go to the Instance tab.
- Click [More options] for the instance to restart and select Restart PostgreSQL.
- Review details in the popup and click [Confirm].