Skip to main content

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.

  1. Go to the KakaoCloud Console > Data Store > PostgreSQL.

  2. Select the instance group whose instance list you want to view.

  3. Navigate to the Instance tab.

    ItemDescription
    Instance nameThe name specified when the PostgreSQL instance was created
    AZThe availability zone where the instance was created
    StatusInstance status
    - See Lifecycle and status values
    Availability statusIndicates replication state between instances (HA only)
    - See Instance availability status
    RoleRole of the instance
    - See Availability and roles
    Instance typeThe type selected at creation
    Storage sizeBase and log storage size configured at creation
    UptimeTime elapsed since last update (create/restart/failover)
    Created atInstance creation date and time

Monitor instances

You can view monitoring results for PostgreSQL instance groups in the Monitoring tab.

  1. Go to the KakaoCloud Console > Data Store > PostgreSQL.

  2. Select the PostgreSQL instance group to monitor.

  3. Click the Monitoring tab.

    ItemDescription
    Monitored instanceSelect instance to monitor
    Metric itemsChoose metrics to display
    - Options: PostgreSQL, CPU, Memory, Filesystem, Disk, Network
    - Default view shows all
    - Multiple selections allowed
    Data periodPeriod shown in monitoring graph
    - Options: 1 hour (default), 3 hours, 12 hours, 1 day, 7 days
    View modeGraph layout mode: single, two-column, or three-column views
    Auto-refresh intervalOptions: Off (default), 10 sec, 30 sec, 1 min, 5 min
    Manual refreshClick to refresh the monitoring graph
Monitoring metrics
CategoryMetricDescription
PostgreSQLConnection (count)Number of total PostgreSQL connections
PostgreSQLConnections (count)Number of active PostgreSQL connections
PostgreSQLLock sessions (count)Number of PostgreSQL lock sessions
PostgreSQLDeadlocks (count)Number of deadlocks in PostgreSQL
PostgreSQLActive transactions (count)Number of active transactions
PostgreSQLReplication lag (sec)Replication delay time
PostgreSQLBuffer hit ratio (%)Buffer cache hit ratio
PostgreSQLVacuum XIDMeasured vacuum XID per DB
PostgreSQLTemp file usage per DB (%)Temp file usage by DB
CPUTotal usage (%)Total CPU usage over time
MemoryTotal usage (%)Total memory usage over time
MemoryUsage by type (Bytes)Memory usage per type over time
FilesystemTotal usage (%)Total filesystem usage over time
FilesystemTotal usage (Bytes)Total filesystem usage in bytes over time
FilesystemInode usage by mount (%)Inode usage per mount over time
DiskRead Bytes (Bytes/sec)Disk IO read over time
DiskWrite Bytes (Bytes/sec)Disk IO write over time
DiskRead IOPS (IO/sec)Read operations per second
DiskWrite IOPS (IO/sec)Write operations per second
NetworkRX by interface (Bytes)Received bytes per network interface
NetworkTX by interface (Bytes)Transmitted bytes per network interface
NetworkRX by interface (PPS)Packets per second received
NetworkTX by interface (PPS)Packets per second transmitted

View instance logs

PostgreSQL logs can be viewed through the Log Explorer in KakaoCloud’s monitoring service.

  1. Go to the KakaoCloud Console > Monitoring.
  2. Click the Explorer tab and select PostgreSQL from the Log Explorer.
  3. Check the query period and enter your log filter. File path filtering is not supported.
  4. After setting search criteria, logs and charts will display results.
info

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, or Terminating.
  • Restarting the primary may cause a brief downtime.
  1. Go to the KakaoCloud Console > Data Store > PostgreSQL.
  2. Select the instance group of the PostgreSQL instance to restart.
  3. Go to the Instance tab.
  4. Click [More options] for the instance to restart and select Restart PostgreSQL.
  5. Review details in the popup and click [Confirm].