{"Entry":{"collection":"guc","key":"cluster_name","name":"cluster_name","aliases":[],"metadata":{"baseline":false,"boot_human":"Not specified","boot_val":null,"category":"Reporting and Logging / Process Title","category_zh":"","changed_in":["14"],"changes":[{"documentation_changed":false,"fields":{},"from":"9.4","status":"added","to":"9.5"},{"documentation_changed":true,"fields":{},"from":"9.5","status":"changed","to":"9.6"},{"documentation_changed":true,"fields":{},"from":"11","status":"changed","to":"12"},{"documentation_changed":true,"fields":{},"from":"12","status":"changed","to":"13"},{"documentation_changed":false,"fields":{"category":{"from":"Process Title","to":"Reporting and Logging / Process Title"}},"from":"13","status":"changed","to":"14"},{"documentation_changed":true,"fields":{},"from":"15","status":"changed","to":"16"}],"content_hash":"e95ca67636fd544110b295a0676e53ecc904cb1153fab81485c8daaf5186a2c5","context":"","default_changed_in":[],"default_history":[{"from":"9.5","to":"19","value":"Empty string"}],"editorial":{"advice":{"olap":"Preserve cluster_name so long jobs can be attributed from operating-system and PostgreSQL views; use application_name for finer job identity.","oltp":"Keep cluster_name enabled or populated for operator clarity unless profiling proves material overhead. Use stable, non-secret labels that match monitoring inventory.","small":"Do not tune cluster_name for capacity. Its observability value normally outweighs negligible overhead, but avoid high-cardinality or sensitive labels."},"mechanism":["cluster_name sets the name of the cluster, which is included in the process title. It is an operator-facing label included in process titles and can distinguish several clusters running on one host; it is not a database identifier.","cluster_name is a POSTMASTER-context setting: PostgreSQL reads it during server startup, and a configuration reload or session SET cannot activate a new value.","Process titles complement application_name, cluster_name, pg_stat_activity, and log_line_prefix, allowing operating-system observations to be joined with database activity."],"pitfalls":["Expecting a reload or SET to activate cluster_name, although it requires a controlled server restart.","Putting secrets or unbounded high-cardinality data into operator-visible process labels.","Using inconsistent cluster, application, and process labels that cannot be joined across monitoring systems.","Changing cluster_name globally without a rollback plan and a client or operational compatibility test."],"references":[{"title":"PostgreSQL 19 Beta 4: cluster_name","url":"https://www.postgresql.org/docs/19/runtime-config-logging.html#GUC-CLUSTER-NAME"},{"title":"PostgreSQL 19 release notes","url":"https://www.postgresql.org/docs/19/release-19.html"}],"related":["application_name","update_process_title","log_line_prefix","log_timezone","log_hostname"],"summary":"cluster_name is the PostgreSQL setting that defines the name of the cluster, which is included in the process title."},"enumvals":[],"first_version":"9.5","group":"Reporting and Logging","group_slug":"logging","imported_at":"2026-09-30T00:40:56.78198+08:00","intro_commit":{"authored_at":"2014-06-29T14:15:09+02:00","discussion":[],"hash":"51adcaa0df81da5e94b582d47de64ebb17129937","subject":"Add cluster_name GUC which is included in process titles if set.","url":"https://git.postgresql.org/gitweb/?p=postgresql.git;a=commit;h=51adcaa0df81da5e94b582d47de64ebb17129937"},"key":"cluster_name","last_version":"20","max_val":"","min_val":"","name":"cluster_name","position":63,"present_in":["9.5","9.6","10","11","12","13","14","15","16","17","18","19","20"],"short_desc":"Sets a name that identifies this database cluster (instance) for various purposes.","short_desc_zh":"","source_rev":"english-manuals:7977941b9f7f0f412d45568b2ed84488a536913b12701f2862052b32f08ca8cb","unit":"","vartype":"string"}},"Definition":{"Collection":"guc","Key":"cluster_name","SourceDatabase":"center","Version":"18","SourceTable":"guc","SourceKey":"cluster_name","SourceRevision":"english-manuals:7977941b9f7f0f412d45568b2ed84488a536913b12701f2862052b32f08ca8cb","Facts":{"boot_val":"","category":"Reporting and Logging / Process Title","context":"postmaster","description":"Sets a name that identifies this database cluster (instance) for various purposes. The cluster name appears in the process title for all server processes in this cluster. Moreover, it is the default application name for a standby connection (see synchronous_standby_names). The name can be any string of less than NAMEDATALEN characters (64 characters in a standard build). Only printable ASCII characters may be used in the cluster_name value. Other characters are replaced with C-style hexadecimal escapes. No name is shown if this parameter is set to the empty string '' (which is the default). This parameter can only be set at server start.","doc":{"anchor":"GUC-CLUSTER-NAME","file":"runtime-config-logging.html","lang":"en","sha256":"93c48c522a72fca19705c4c91a71e951eae653662008eee2e4a9a74a11127fde","slug":"18"},"documented":true,"enumvals":null,"extra_desc":null,"lang":"en","max_val":null,"metadata_version":"18","min_val":null,"name":"cluster_name","short_desc":"Sets the name of the cluster, which is included in the process title.","source":"pg-settings-source-snapshot","unit":null,"vartype":"string"},"ManualEvidence":{"doc":{"anchor":"GUC-CLUSTER-NAME","file":"runtime-config-logging.html","lang":"en","sha256":"93c48c522a72fca19705c4c91a71e951eae653662008eee2e4a9a74a11127fde","slug":"18"}},"MeasuredEvidence":{"metadata_version":"18"}},"Text":{"Collection":"guc","Key":"cluster_name","SourceDatabase":"pgweb","Version":"18","Locale":"zh-Hans","Title":"cluster_name","Summary":"","BodyHTML":"\u003cp\u003e设置一个用于各种目的、标识此数据库集簇（实例）的名称。集簇名称会出现在此集簇所有服务器进程的进程标题中。此外，它还是备库连接的默认应用名称（参见\u003ca href=\"/docs/18/runtime-config-replication.html#GUC-SYNCHRONOUS-STANDBY-NAMES\" rel=\"nofollow\"\u003esynchronous_standby_names\u003c/a\u003e）。\u003c/p\u003e\u003cp\u003e这个名称可以是长度少于\u003ccode\u003eNAMEDATALEN\u003c/code\u003e个字符（在标准编译中是 64字符）的任何字符串。只有可打印的 ASCII 字符能被用在\u003ccode\u003ecluster_name\u003c/code\u003e值中。其他字符将被替换为\u003ca href=\"/docs/18/sql-syntax-lexical.html#SQL-SYNTAX-STRINGS-ESCAPE\" rel=\"nofollow\"\u003eC 风格的十六进制转义序列\u003c/a\u003e。如果这个参数被设置为空字符串\u003ccode\u003e\u0026#39;\u0026#39;\u003c/code\u003e（也是默认值），将不会显示名称。这个参数只能在服务器启动时设置。\u003c/p\u003e","SourceRevision":"2026-09-11@29c86d9","ContentHash":"80da4e6e94e98b37794aee24ab96c1a2c3a381eff3c3b4bb34f571e8c156af31","Payload":{"carried_from":"","carry_reason":"","doc_html":"\u003cp\u003e设置一个用于各种目的、标识此数据库集簇（实例）的名称。集簇名称会出现在此集簇所有服务器进程的进程标题中。此外，它还是备库连接的默认应用名称（参见\u003ca href=\"/docs/18/runtime-config-replication.html#GUC-SYNCHRONOUS-STANDBY-NAMES\"\u003esynchronous_standby_names\u003c/a\u003e）。\u003c/p\u003e\u003cp\u003e这个名称可以是长度少于\u003ccode class=\"symbol\"\u003eNAMEDATALEN\u003c/code\u003e个字符（在标准编译中是 64字符）的任何字符串。只有可打印的 ASCII 字符能被用在\u003ccode class=\"varname\"\u003ecluster_name\u003c/code\u003e值中。其他字符将被替换为\u003ca href=\"/docs/18/sql-syntax-lexical.html#SQL-SYNTAX-STRINGS-ESCAPE\" title=\"4.1.2.2. C风格转义的字符串常量\"\u003eC 风格的十六进制转义序列\u003c/a\u003e。如果这个参数被设置为空字符串\u003ccode class=\"literal\"\u003e''\u003c/code\u003e（也是默认值），将不会显示名称。这个参数只能在服务器启动时设置。\u003c/p\u003e","doc_same_as":""}},"RequestedLocale":"zh-Hans","Fallback":false,"Versions":["10","11","12","13","14","15","16","17","18","19","20","9.5","9.6"],"Locales":["en","zh-Hans"],"Signatures":null,"Spellings":null,"SQLState":null,"Evidence":null}