Line data    Source code

       1              : /* ----------
       2              :  *  pgstat_kind.h
       3              :  *
       4              :  *  Definitions related to the statistics kinds for the PostgreSQL
       5              :  *  cumulative statistics system.  Can be included in backend or
       6              :  *  frontend code.
       7              :  *
       8              :  *  Copyright (c) 2001-2026, PostgreSQL Global Development Group
       9              :  *
      10              :  *  src/include/utils/pgstat_kind.h
      11              :  * ----------
      12              :  */
      13              : #ifndef PGSTAT_KIND_H
      14              : #define PGSTAT_KIND_H
      15              : 
      16              : /* The types of statistics entries */
      17              : #define PgStat_Kind uint32
      18              : 
      19              : /* Range of IDs allowed, for built-in and custom kinds */
      20              : #define PGSTAT_KIND_MIN 1       /* Minimum ID allowed */
      21              : #define PGSTAT_KIND_MAX 32      /* Maximum ID allowed */
      22              : 
      23              : /* use 0 for INVALID, to catch zero-initialized data */
      24              : #define PGSTAT_KIND_INVALID 0
      25              : 
      26              : /* stats for variable-numbered objects */
      27              : #define PGSTAT_KIND_DATABASE    1   /* database-wide statistics */
      28              : #define PGSTAT_KIND_RELATION    2   /* per-table statistics */
      29              : #define PGSTAT_KIND_FUNCTION    3   /* per-function statistics */
      30              : #define PGSTAT_KIND_REPLSLOT    4   /* per-slot statistics */
      31              : #define PGSTAT_KIND_SUBSCRIPTION    5   /* per-subscription statistics */
      32              : #define PGSTAT_KIND_BACKEND 6   /* per-backend statistics */
      33              : 
      34              : /* stats for fixed-numbered objects */
      35              : #define PGSTAT_KIND_ARCHIVER    7
      36              : #define PGSTAT_KIND_BGWRITER    8
      37              : #define PGSTAT_KIND_CHECKPOINTER    9
      38              : #define PGSTAT_KIND_IO  10
      39              : #define PGSTAT_KIND_SLRU    11
      40              : #define PGSTAT_KIND_WAL 12
      41              : 
      42              : #define PGSTAT_KIND_BUILTIN_MIN PGSTAT_KIND_DATABASE
      43              : #define PGSTAT_KIND_BUILTIN_MAX PGSTAT_KIND_WAL
      44              : #define PGSTAT_KIND_BUILTIN_SIZE (PGSTAT_KIND_BUILTIN_MAX + 1)
      45              : 
      46              : /* Custom stats kinds */
      47              : 
      48              : /* Range of IDs allowed for custom stats kinds */
      49              : #define PGSTAT_KIND_CUSTOM_MIN  24
      50              : #define PGSTAT_KIND_CUSTOM_MAX  PGSTAT_KIND_MAX
      51              : #define PGSTAT_KIND_CUSTOM_SIZE (PGSTAT_KIND_CUSTOM_MAX - PGSTAT_KIND_CUSTOM_MIN + 1)
      52              : 
      53              : /*
      54              :  * PgStat_Kind to use for extensions that require an ID, but are still in
      55              :  * development and have not reserved their own unique kind ID yet. See:
      56              :  * https://wiki.postgresql.org/wiki/CustomCumulativeStats
      57              :  */
      58              : #define PGSTAT_KIND_EXPERIMENTAL    24
      59              : 
      60              : static inline bool
      61      8423967 : pgstat_is_kind_builtin(PgStat_Kind kind)
      62              : {
      63      8423967 :     return kind >= PGSTAT_KIND_BUILTIN_MIN && kind <= PGSTAT_KIND_BUILTIN_MAX;
      64              : }
      65              : 
      66              : static inline bool
      67      1516942 : pgstat_is_kind_custom(PgStat_Kind kind)
      68              : {
      69      1516942 :     return kind >= PGSTAT_KIND_CUSTOM_MIN && kind <= PGSTAT_KIND_CUSTOM_MAX;
      70              : }
      71              : 
      72              : #endif                          /* PGSTAT_KIND_H */