{"id":27509,"date":"2023-08-29T08:32:50","date_gmt":"2023-08-29T06:32:50","guid":{"rendered":"https:\/\/www.dbi-services.com\/blog\/?p=27509"},"modified":"2023-08-29T08:32:52","modified_gmt":"2023-08-29T06:32:52","slug":"postgresql-17-pg_wait_events","status":"publish","type":"post","link":"https:\/\/www.dbi-services.com\/blog\/postgresql-17-pg_wait_events\/","title":{"rendered":"PostgreSQL 17: pg_wait_events"},"content":{"rendered":"\n<p>As development of PostgreSQL 17 already started there are already some commits which bring in new functionality. One of them introduces a new catalog view called &#8220;pg_wait_events&#8221;. As the same implies, this view lists the known wait events for PostgreSQL. Many of those wait events came in over time since the &#8220;wait_event_type&#8221; and &#8220;wait_event&#8221; columns have been to PostgreSQL 9.6. <\/p>\n\n\n\n<p>Up to now you either have to go to the <a href=\"https:\/\/www.postgresql.org\/docs\/15\/monitoring-stats.html#WAIT-EVENT-ACTIVITY-TABLE\" target=\"_blank\" rel=\"noreferrer noopener\">documentation<\/a> to get the full list of wait events, or you can have a look at wait_event_names.txt in the source code:<\/p>\n\n\n<div class=\"wp-block-syntaxhighlighter-code \"><pre class=\"brush: bash; title: ; notranslate\" title=\"\">\npostgres@debian12-pg:\/home\/postgres\/postgresql\/ &#x5B;pgdev] find . -name wait_event_names.txt\n.\/src\/backend\/utils\/activity\/wait_event_names.txt\npostgres@debian12-pg:\/home\/postgres\/postgresql\/ &#x5B;pgdev] head -10 .\/src\/backend\/utils\/activity\/wait_event_names.txt\n#\n# wait_event_names.txt\n#      PostgreSQL wait events\n#\n# Copyright (c) 2023, PostgreSQL Global Development Group\n#\n# This list serves as the basis for generating source and documentation files\n# related to wait events.\n#\n# The files generated from this one are:\n<\/pre><\/div>\n\n\n<p>In fact, pg_wait_events gets its content from this text file, so this is the source of truth. Looking at the view itself, it is very simple:<\/p>\n\n\n<div class=\"wp-block-syntaxhighlighter-code \"><pre class=\"brush: sql; title: ; notranslate\" title=\"\">\npostgres=# \\d pg_wait_events \n          View &quot;pg_catalog.pg_wait_events&quot;\n   Column    | Type | Collation | Nullable | Default \n-------------+------+-----------+----------+---------\n type        | text |           |          | \n name        | text |           |          | \n description | text |           |          | \n<\/pre><\/div>\n\n\n<p>There is a type, a name and the description of the wait event:<\/p>\n\n\n<div class=\"wp-block-syntaxhighlighter-code \"><pre class=\"brush: sql; title: ; notranslate\" title=\"\">\npostgres=# select * from pg_wait_events limit 5;\n   type   |       name        |                     description                     \n----------+-------------------+-----------------------------------------------------\n Activity | ArchiverMain      | Waiting in main loop of archiver process\n Activity | AutoVacuumMain    | Waiting in main loop of autovacuum launcher process\n Activity | BgWriterHibernate | Waiting in background writer process, hibernating\n Activity | BgWriterMain      | Waiting in main loop of background writer process\n Activity | CheckpointerMain  | Waiting in main loop of checkpointer process\n(5 rows)\n<\/pre><\/div>\n\n\n<p>The view for its own might not be very useful except for having access to the description of the wait events directly inside PostgreSQL. It gets more useful if you join the view to <a href=\"https:\/\/www.postgresql.org\/docs\/15\/monitoring-stats.html#MONITORING-PG-STAT-ACTIVITY-VIEW\" target=\"_blank\" rel=\"noreferrer noopener\">pg_stat_activity<\/a>. For getting an idea how that looks like lets generate a wait in a first session:<\/p>\n\n\n<div class=\"wp-block-syntaxhighlighter-code \"><pre class=\"brush: sql; title: ; notranslate\" title=\"\">\npostgres=# begin;\nBEGIN\npostgres=*# select * from t;\n--\n(0 rows)\n<\/pre><\/div>\n\n\n<p>In a second session join pg_stat_activity with pg_wait_events and you&#8217;ll see the whole description of the wait event beside the wait, which is very handy as it gives you more information about the wait event:<\/p>\n\n\n<div class=\"wp-block-syntaxhighlighter-code \"><pre class=\"brush: sql; title: ; notranslate\" title=\"\">\npostgres=# select a.datname, a.usename, a.state, a.wait_event_type, a.wait_event, b.description \n             from pg_stat_activity a \n             join pg_wait_events b \n               on a.wait_event_type = b.type \n              and a.wait_event = b.name;\n datname  | usename  |        state        | wait_event_type |     wait_event      |                         description                          \n----------+----------+---------------------+-----------------+---------------------+--------------------------------------------------------------\n          |          |                     | Activity        | ArchiverMain        | Waiting in main loop of archiver process\n          |          |                     | Activity        | AutoVacuumMain      | Waiting in main loop of autovacuum launcher process\n          |          |                     | Activity        | BgWriterHibernate   | Waiting in background writer process, hibernating\n          |          |                     | Activity        | CheckpointerMain    | Waiting in main loop of checkpointer process\n          | postgres |                     | Activity        | LogicalLauncherMain | Waiting in main loop of logical replication launcher process\n          |          |                     | Activity        | WalWriterMain       | Waiting in main loop of WAL writer process\n postgres | postgres | idle in transaction | Client          | ClientRead          | Waiting to read data from the client\n(7 rows)\n<\/pre><\/div>\n\n\n<p>Nice, thanks to all involved.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>As development of PostgreSQL 17 already started there are already some commits which bring in new functionality. One of them introduces a new catalog view called &#8220;pg_wait_events&#8221;. As the same implies, this view lists the known wait events for PostgreSQL. Many of those wait events came in over time since the &#8220;wait_event_type&#8221; and &#8220;wait_event&#8221; columns [&hellip;]<\/p>\n","protected":false},"author":29,"featured_media":0,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[229,198],"tags":[77],"type_dbi":[],"class_list":["post-27509","post","type-post","status-publish","format-standard","hentry","category-database-administration-monitoring","category-database-management","tag-postgresql"],"acf":[],"yoast_head":"<!-- This site is optimized with the Yoast SEO Premium plugin v27.2 (Yoast SEO v27.2) - https:\/\/yoast.com\/product\/yoast-seo-premium-wordpress\/ -->\n<title>PostgreSQL 17: pg_wait_events - dbi Blog<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/www.dbi-services.com\/blog\/postgresql-17-pg_wait_events\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"PostgreSQL 17: pg_wait_events\" \/>\n<meta property=\"og:description\" content=\"As development of PostgreSQL 17 already started there are already some commits which bring in new functionality. One of them introduces a new catalog view called &#8220;pg_wait_events&#8221;. As the same implies, this view lists the known wait events for PostgreSQL. Many of those wait events came in over time since the &#8220;wait_event_type&#8221; and &#8220;wait_event&#8221; columns [&hellip;]\" \/>\n<meta property=\"og:url\" content=\"https:\/\/www.dbi-services.com\/blog\/postgresql-17-pg_wait_events\/\" \/>\n<meta property=\"og:site_name\" content=\"dbi Blog\" \/>\n<meta property=\"article:published_time\" content=\"2023-08-29T06:32:50+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2023-08-29T06:32:52+00:00\" \/>\n<meta name=\"author\" content=\"Daniel Westermann\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:creator\" content=\"@westermanndanie\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"Daniel Westermann\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"1 minute\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\/\/www.dbi-services.com\/blog\/postgresql-17-pg_wait_events\/#article\",\"isPartOf\":{\"@id\":\"https:\/\/www.dbi-services.com\/blog\/postgresql-17-pg_wait_events\/\"},\"author\":{\"name\":\"Daniel Westermann\",\"@id\":\"https:\/\/www.dbi-services.com\/blog\/#\/schema\/person\/8d08e9bd996a89bd75c0286cbabf3c66\"},\"headline\":\"PostgreSQL 17: pg_wait_events\",\"datePublished\":\"2023-08-29T06:32:50+00:00\",\"dateModified\":\"2023-08-29T06:32:52+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\/\/www.dbi-services.com\/blog\/postgresql-17-pg_wait_events\/\"},\"wordCount\":240,\"commentCount\":0,\"keywords\":[\"PostgreSQL\"],\"articleSection\":[\"Database Administration &amp; Monitoring\",\"Database management\"],\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"CommentAction\",\"name\":\"Comment\",\"target\":[\"https:\/\/www.dbi-services.com\/blog\/postgresql-17-pg_wait_events\/#respond\"]}]},{\"@type\":\"WebPage\",\"@id\":\"https:\/\/www.dbi-services.com\/blog\/postgresql-17-pg_wait_events\/\",\"url\":\"https:\/\/www.dbi-services.com\/blog\/postgresql-17-pg_wait_events\/\",\"name\":\"PostgreSQL 17: pg_wait_events - dbi Blog\",\"isPartOf\":{\"@id\":\"https:\/\/www.dbi-services.com\/blog\/#website\"},\"datePublished\":\"2023-08-29T06:32:50+00:00\",\"dateModified\":\"2023-08-29T06:32:52+00:00\",\"author\":{\"@id\":\"https:\/\/www.dbi-services.com\/blog\/#\/schema\/person\/8d08e9bd996a89bd75c0286cbabf3c66\"},\"breadcrumb\":{\"@id\":\"https:\/\/www.dbi-services.com\/blog\/postgresql-17-pg_wait_events\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/www.dbi-services.com\/blog\/postgresql-17-pg_wait_events\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/www.dbi-services.com\/blog\/postgresql-17-pg_wait_events\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Accueil\",\"item\":\"https:\/\/www.dbi-services.com\/blog\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"PostgreSQL 17: pg_wait_events\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/www.dbi-services.com\/blog\/#website\",\"url\":\"https:\/\/www.dbi-services.com\/blog\/\",\"name\":\"dbi Blog\",\"description\":\"\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/www.dbi-services.com\/blog\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Person\",\"@id\":\"https:\/\/www.dbi-services.com\/blog\/#\/schema\/person\/8d08e9bd996a89bd75c0286cbabf3c66\",\"name\":\"Daniel Westermann\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/secure.gravatar.com\/avatar\/31350ceeecb1dd8986339a29bf040d4cd3cd087d410deccd8f55234466d6c317?s=96&d=mm&r=g\",\"url\":\"https:\/\/secure.gravatar.com\/avatar\/31350ceeecb1dd8986339a29bf040d4cd3cd087d410deccd8f55234466d6c317?s=96&d=mm&r=g\",\"contentUrl\":\"https:\/\/secure.gravatar.com\/avatar\/31350ceeecb1dd8986339a29bf040d4cd3cd087d410deccd8f55234466d6c317?s=96&d=mm&r=g\",\"caption\":\"Daniel Westermann\"},\"description\":\"Daniel Westermann is Principal Consultant and Technology Leader Open Infrastructure at dbi services. He has more than 15 years of experience in management, engineering and optimization of databases and infrastructures, especially on Oracle and PostgreSQL. Since the beginning of his career, he has specialized in Oracle Technologies and is Oracle Certified Professional 12c and Oracle Certified Expert RAC\/GridInfra. Over time, Daniel has become increasingly interested in open source technologies, becoming \u201cTechnology Leader Open Infrastructure\u201d and PostgreSQL expert. \u00a0Based on community or EnterpriseDB tools, he develops and installs complex high available solutions with PostgreSQL. He is also a certified PostgreSQL Plus 9.0 Professional and a Postgres Advanced Server 9.4 Professional. He is a regular speaker at PostgreSQL conferences in Switzerland and Europe. Today Daniel is also supporting our customers on AWS services such as AWS RDS, database migrations into the cloud, EC2 and automated infrastructure management with AWS SSM (System Manager). He is a certified AWS Solutions Architect Professional. Prior to dbi services, Daniel was Management System Engineer at LC SYSTEMS-Engineering AG in Basel. Before that, he worked as Oracle Developper &amp;\u00a0Project Manager at Delta Energy Solutions AG in Basel (today Powel AG). Daniel holds a diploma in Business Informatics (DHBW, Germany). His branch-related experience mainly covers the pharma industry, the financial sector, energy, lottery and telecommunications.\",\"sameAs\":[\"https:\/\/x.com\/westermanndanie\"],\"url\":\"https:\/\/www.dbi-services.com\/blog\/author\/daniel-westermann\/\"}]}<\/script>\n<!-- \/ Yoast SEO Premium plugin. -->","yoast_head_json":{"title":"PostgreSQL 17: pg_wait_events - dbi Blog","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/www.dbi-services.com\/blog\/postgresql-17-pg_wait_events\/","og_locale":"en_US","og_type":"article","og_title":"PostgreSQL 17: pg_wait_events","og_description":"As development of PostgreSQL 17 already started there are already some commits which bring in new functionality. One of them introduces a new catalog view called &#8220;pg_wait_events&#8221;. As the same implies, this view lists the known wait events for PostgreSQL. Many of those wait events came in over time since the &#8220;wait_event_type&#8221; and &#8220;wait_event&#8221; columns [&hellip;]","og_url":"https:\/\/www.dbi-services.com\/blog\/postgresql-17-pg_wait_events\/","og_site_name":"dbi Blog","article_published_time":"2023-08-29T06:32:50+00:00","article_modified_time":"2023-08-29T06:32:52+00:00","author":"Daniel Westermann","twitter_card":"summary_large_image","twitter_creator":"@westermanndanie","twitter_misc":{"Written by":"Daniel Westermann","Est. reading time":"1 minute"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/www.dbi-services.com\/blog\/postgresql-17-pg_wait_events\/#article","isPartOf":{"@id":"https:\/\/www.dbi-services.com\/blog\/postgresql-17-pg_wait_events\/"},"author":{"name":"Daniel Westermann","@id":"https:\/\/www.dbi-services.com\/blog\/#\/schema\/person\/8d08e9bd996a89bd75c0286cbabf3c66"},"headline":"PostgreSQL 17: pg_wait_events","datePublished":"2023-08-29T06:32:50+00:00","dateModified":"2023-08-29T06:32:52+00:00","mainEntityOfPage":{"@id":"https:\/\/www.dbi-services.com\/blog\/postgresql-17-pg_wait_events\/"},"wordCount":240,"commentCount":0,"keywords":["PostgreSQL"],"articleSection":["Database Administration &amp; Monitoring","Database management"],"inLanguage":"en-US","potentialAction":[{"@type":"CommentAction","name":"Comment","target":["https:\/\/www.dbi-services.com\/blog\/postgresql-17-pg_wait_events\/#respond"]}]},{"@type":"WebPage","@id":"https:\/\/www.dbi-services.com\/blog\/postgresql-17-pg_wait_events\/","url":"https:\/\/www.dbi-services.com\/blog\/postgresql-17-pg_wait_events\/","name":"PostgreSQL 17: pg_wait_events - dbi Blog","isPartOf":{"@id":"https:\/\/www.dbi-services.com\/blog\/#website"},"datePublished":"2023-08-29T06:32:50+00:00","dateModified":"2023-08-29T06:32:52+00:00","author":{"@id":"https:\/\/www.dbi-services.com\/blog\/#\/schema\/person\/8d08e9bd996a89bd75c0286cbabf3c66"},"breadcrumb":{"@id":"https:\/\/www.dbi-services.com\/blog\/postgresql-17-pg_wait_events\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/www.dbi-services.com\/blog\/postgresql-17-pg_wait_events\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/www.dbi-services.com\/blog\/postgresql-17-pg_wait_events\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Accueil","item":"https:\/\/www.dbi-services.com\/blog\/"},{"@type":"ListItem","position":2,"name":"PostgreSQL 17: pg_wait_events"}]},{"@type":"WebSite","@id":"https:\/\/www.dbi-services.com\/blog\/#website","url":"https:\/\/www.dbi-services.com\/blog\/","name":"dbi Blog","description":"","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/www.dbi-services.com\/blog\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Person","@id":"https:\/\/www.dbi-services.com\/blog\/#\/schema\/person\/8d08e9bd996a89bd75c0286cbabf3c66","name":"Daniel Westermann","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/secure.gravatar.com\/avatar\/31350ceeecb1dd8986339a29bf040d4cd3cd087d410deccd8f55234466d6c317?s=96&d=mm&r=g","url":"https:\/\/secure.gravatar.com\/avatar\/31350ceeecb1dd8986339a29bf040d4cd3cd087d410deccd8f55234466d6c317?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/31350ceeecb1dd8986339a29bf040d4cd3cd087d410deccd8f55234466d6c317?s=96&d=mm&r=g","caption":"Daniel Westermann"},"description":"Daniel Westermann is Principal Consultant and Technology Leader Open Infrastructure at dbi services. He has more than 15 years of experience in management, engineering and optimization of databases and infrastructures, especially on Oracle and PostgreSQL. Since the beginning of his career, he has specialized in Oracle Technologies and is Oracle Certified Professional 12c and Oracle Certified Expert RAC\/GridInfra. Over time, Daniel has become increasingly interested in open source technologies, becoming \u201cTechnology Leader Open Infrastructure\u201d and PostgreSQL expert. \u00a0Based on community or EnterpriseDB tools, he develops and installs complex high available solutions with PostgreSQL. He is also a certified PostgreSQL Plus 9.0 Professional and a Postgres Advanced Server 9.4 Professional. He is a regular speaker at PostgreSQL conferences in Switzerland and Europe. Today Daniel is also supporting our customers on AWS services such as AWS RDS, database migrations into the cloud, EC2 and automated infrastructure management with AWS SSM (System Manager). He is a certified AWS Solutions Architect Professional. Prior to dbi services, Daniel was Management System Engineer at LC SYSTEMS-Engineering AG in Basel. Before that, he worked as Oracle Developper &amp;\u00a0Project Manager at Delta Energy Solutions AG in Basel (today Powel AG). Daniel holds a diploma in Business Informatics (DHBW, Germany). His branch-related experience mainly covers the pharma industry, the financial sector, energy, lottery and telecommunications.","sameAs":["https:\/\/x.com\/westermanndanie"],"url":"https:\/\/www.dbi-services.com\/blog\/author\/daniel-westermann\/"}]}},"_links":{"self":[{"href":"https:\/\/www.dbi-services.com\/blog\/wp-json\/wp\/v2\/posts\/27509","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.dbi-services.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.dbi-services.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.dbi-services.com\/blog\/wp-json\/wp\/v2\/users\/29"}],"replies":[{"embeddable":true,"href":"https:\/\/www.dbi-services.com\/blog\/wp-json\/wp\/v2\/comments?post=27509"}],"version-history":[{"count":7,"href":"https:\/\/www.dbi-services.com\/blog\/wp-json\/wp\/v2\/posts\/27509\/revisions"}],"predecessor-version":[{"id":27518,"href":"https:\/\/www.dbi-services.com\/blog\/wp-json\/wp\/v2\/posts\/27509\/revisions\/27518"}],"wp:attachment":[{"href":"https:\/\/www.dbi-services.com\/blog\/wp-json\/wp\/v2\/media?parent=27509"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.dbi-services.com\/blog\/wp-json\/wp\/v2\/categories?post=27509"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.dbi-services.com\/blog\/wp-json\/wp\/v2\/tags?post=27509"},{"taxonomy":"type","embeddable":true,"href":"https:\/\/www.dbi-services.com\/blog\/wp-json\/wp\/v2\/type_dbi?post=27509"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}