supabase/apps/studio/data/reports/database-charts.ts

export const getReportAttributes = (isFreePlan: boolean) => [
  { id: 'ram_usage', label: 'Memory usage', hide: false },
  { id: 'avg_cpu_usage', label: 'Average CPU usage', hide: false },
  { id: 'max_cpu_usage', label: 'Max CPU usage', hide: false },
  { id: 'disk_iops_write', label: 'Disk IOps write', hide: false },
  { id: 'disk_iops_read', label: 'Disk IOps read', hide: false },
  {
    id: 'pg_stat_database_num_backends',
    label: 'Pooler to database connections',
    hide: false,
  },
  {
    id: 'supavisor_connections_active',
    label: 'Client to Shared Pooler connections',
    hide: false,
  },
  {
    id: 'client_connections_pgbouncer',
    label: 'Client to Dedicated Pooler connections',
    hide: isFreePlan,
  },
]

export const getReportAttributesV2 = (isFreePlan: boolean) => [
  {
    id: 'ram-usage',
    label: 'Memory usage',
    hide: false,
    showTooltip: true,
    showLegend: true,
    hideChartType: false,
    defaultChartStyle: 'line',
    showMaxValue: false,
    attributes: [
      {
        attribute: 'ram_usage_used',
        provider: 'infra-monitoring',
        label: 'Used',
        tooltip:
          'Total RAM currently in use by the system and applications. High usage may indicate memory pressure.',
      },
      {
        attribute: 'ram_usage_cache_and_buffers',
        provider: 'infra-monitoring',
        label: 'Cache + buffers',
        tooltip:
          'RAM used for caching and buffering disk operations. Higher values improve read performance.',
      },
      {
        attribute: 'ram_usage_free',
        provider: 'infra-monitoring',
        label: 'Free',
        tooltip:
          'Available unused RAM. A small amount is always reserved. High unused RAM present with erratic Used RAM may indicate unoptimized queries disrupting cache.',
      },
      {
        attribute: 'ram_usage_swap',
        provider: 'infra-monitoring',
        label: 'Swap',
        tooltip:
          'Memory swapped to disk when RAM is full. An instance has 1GB of SWAP. High swap with high disk I/O signals memory stress.',
      },
    ],
  },
  {
    id: 'cpu-usage',
    label: 'CPU usage',
    format: '%',
    valuePrecision: 2,
    hide: false,
    showTooltip: true,
    showLegend: true,
    showMaxValue: false,
    hideChartType: false,
    defaultChartStyle: 'line',
    attributes: [
      {
        attribute: 'cpu_usage_busy_system',
        provider: 'infra-monitoring',
        label: 'System',
        format: '%',
        tooltip:
          'CPU time spent on kernel operations (e.g., process scheduling, memory management). High values may indicate system overhead.',
      },
      {
        attribute: 'cpu_usage_busy_user',
        provider: 'infra-monitoring',
        label: 'User',
        format: '%',
        tooltip:
          'CPU time used by database queries and user-space processes. High values may suggest CPU-intensive queries.',
      },
      {
        attribute: 'cpu_usage_busy_iowait',
        provider: 'infra-monitoring',
        label: 'IOwait',
        format: '%',
        tooltip:
          'CPU time waiting for disk or network I/O. High values may indicate disk bottlenecks.',
      },
      {
        attribute: 'cpu_usage_busy_irqs',
        provider: 'infra-monitoring',
        label: 'IRQs',
        format: '%',
        tooltip: 'CPU time handling hardware interrupt requests (IRQ)',
      },
      {
        attribute: 'cpu_usage_busy_other',
        provider: 'infra-monitoring',
        label: 'Other',
        format: '%',
        tooltip: 'CPU time spent on other tasks (e.g., background processes, software interrupts).',
      },
    ],
  },
  {
    id: 'disk-iops',
    label: 'Disk IOps',
    hide: false,
    showTooltip: true,
    showLegend: true,
    hideChartType: false,
    defaultChartStyle: 'line',
    attributes: [
      {
        attribute: 'disk_iops_write',
        provider: 'infra-monitoring',
        label: 'IOps write/s',
        tooltip:
          'Number of write operations per second. High values indicate frequent data writes, logging, or transaction activity.',
      },
      {
        attribute: 'disk_iops_read',
        provider: 'infra-monitoring',
        label: 'IOps read/s',
        tooltip:
          'Number of read operations per second. High values suggest frequent disk reads due to queries or poor caching.',
      },
    ],
  },
  {
    id: 'client-connections',
    label: 'Database client connections',
    valuePrecision: 0,
    hide: false,
    showTooltip: false,
    showLegend: false,
    showMaxValue: false,
    hideChartType: false,
    defaultChartStyle: 'line',
    attributes: [
      {
        attribute: 'pg_stat_database_num_backends',
        provider: 'infra-monitoring',
        label: 'active connections',
        tooltip: 'Active connections',
      },
    ],
  },
  {
    id: 'pgbouncer-connections',
    label: 'Pooler client connections',
    valuePrecision: 0,
    hide: false,
    showTooltip: false,
    showLegend: false,
    showMaxValue: false,
    hideChartType: false,
    defaultChartStyle: 'line',
    attributes: [
      {
        attribute: 'client_connections_pgbouncer',
        provider: 'infra-monitoring',
        label: 'pgbouncer',
        tooltip: 'PgBouncer connections',
      },
    ],
  },
  {
    id: 'supavisor-connections-active',
    label: 'Supavisor client connections',
    valuePrecision: 0,
    hide: isFreePlan,
    showTooltip: false,
    showLegend: false,
    showMaxValue: false,
    hideChartType: false,
    defaultChartStyle: 'line',
    attributes: [
      {
        attribute: 'supavisor_connections_active',
        provider: 'infra-monitoring',
        label: 'supavisor',
        tooltip: 'Supavisor connections',
      },
    ],
  },
]