Merge pull request #1944 from neondatabase/dprice-stats-lost-on-suspend

docs: add note about stats retention

content/docs/extensions/pg_stat_statements.md

@@ -27,6 +27,10 @@ The version of `pg_stat_statements` available on Neon depends on the version of
 - Postgres 15 - `pg_stat_statements` 1.10
 - Postgres 16 - `pg_stat_statements` 1.10
 
+### Data persistence
+
+In Neon, statistics collected by the `pg_stat_statements` extension are not retained when your Neon compute instance (where Postgres runs) is suspended or restarted. For example, if your compute instance scales down to zero due to inactivity, any existing statistics are lost. New statistics will be gathered once your compute instance restarts. For more details about the lifecycle of a Neon compute instance, see [Compute lifecycle](/docs/conceptual-guides/compute-lifecycle/). For information about configuring Neon's autosuspend behavior, see [Autosuspend](/docs/introduction/auto-suspend).
+
 ## Enable the `pg_stat_statements` extension
 
 You can enable the extension by running the following `CREATE EXTENSION` statement in the Neon **SQL Editor** or from a client such as `psql` that is connected to Neon.

content/docs/reference/compatibility.md

@@ -127,7 +127,7 @@ The Neon cloud service automatically closes idle connections after a period of i
 
 ## Statistics collection
 
-Statistics collected by the Postgres [cumulative statistics system](https://www.postgresql.org/docs/current/monitoring-stats.html) are currently not saved when the Neon compute node is placed into an `Idle` state due to inactivity or restarted. For information about the lifecycle of a Neon compute, see [Compute lifecycle](/docs/conceptual-guides/compute-lifecycle/).
+Statistics collected by the Postgres [cumulative statistics system](https://www.postgresql.org/docs/current/monitoring-stats.html) are not saved when a Neon compute (where Postgres runs) is suspended due to inactivity or restarted. For information about the lifecycle of a Neon compute, see [Compute lifecycle](/docs/conceptual-guides/compute-lifecycle/). For information about configuring Neon's autosuspend behavior, see [Autosuspend](/docs/introduction/auto-suspend).
 
 ## Database encoding