[doc][2025.1] Auto analyze service tserver and master flags

docs/content/preview/reference/configuration/yb-master.md

@@ -987,6 +987,18 @@ expensive when the number of yb-tservers, or the number of databases goes up.
 
 {{< /note >}}
 
+## Auto Analyze Service flags
+
+Auto Analyze service flags are {{<tags/feature/tp>}}.
+
+See also [Auto Analyze Service TServer flags](../yb-tserver/#auto-analyze-service-flags).
+
+##### ysql_enable_auto_analyze_service
+
+Enable the Auto Analyze service which automatically runs ANALYZEs to update table statistics for tables which have changed more than a configurable threshold.
+
+Default: false
+
 ## Advanced flags
 
 ##### --allowed_preview_flags_csv

docs/content/preview/reference/configuration/yb-tserver.md

@@ -1624,6 +1624,73 @@ After a DDL statement that includes updating DocDB system catalog completes, YB-
 When the flag `ysql_ddl_transaction_wait_for_ddl_verification` is enabled, YSQL waits for any YB-Master background operations to finish before returning control to the user.
 {{< /note >}}
 
+## Auto Analyze Service flags
+
+Auto Analyze service flags are {{<tags/feature/tp>}}.
+
+{{< note title="Note" >}}
+
+To fully enable Auto Analyze service, you need to enable `ysql_enable_auto_analyze_service` on all YB-Masters and YB-TServers, as well as `ysql_enable_table_mutation_counter` on all YB-TServers.
+
+{{< /note >}}
+
+See also [Auto Analyze Service Master flags](../yb-master#auto-analyze-service-flags).
+
+##### ysql_enable_auto_analyze_service
+
+Enable the Auto Analyze service which automatically runs ANALYZEs to update table statistics for tables which have changed more than a configurable threshold.
+
+Default: false
+
+##### ysql_enable_table_mutation_counter
+Enable counting of mutations on a per-table basis. These mutations are used to automatically run ANALYZE as soon as the mutations of a table cross 
+a certain threshold (decided based on [ysql_auto_analyze_threshold](#ysql-auto-analyze-threshold) and [ysql_auto_analyze_scale_factor](#ysql-auto-analyze-scale-factor)).
+
+Default: false
+
+##### ysql_auto_analyze_threshold
+
+The minimum number of mutations needed to run ANALYZE on a table.
+
+Default: 50
+
+##### ysql_auto_analyze_scale_factor
+
+The fraction defining when sufficient mutations have been accumulated to run ANALYZE for a table.
+ANALYZE runs when the mutation count becomes larger than `ysql_auto_analyze_scale_factor * <table_size> + ysql_auto_analyze_threshold`.
+
+Default: 0.1
+
+##### ysql_auto_analyze_batch_size
+
+The max number of tables the auto analyze service tries to analyze in a single ANALYZE statement.
+
+Default: 10
+
+##### ysql_cluster_level_mutation_persist_interval_ms
+
+Interval at which the reported node level table mutation counts are persisted to the underlying auto-analyze mutations table.
+
+Default: 10000
+
+##### ysql_cluster_level_mutation_persist_rpc_timeout_ms
+
+Timeout for the rpcs used to persist mutation counts in the auto-analyze mutations table.
+
+Default: 10000
+
+##### ysql_node_level_mutation_reporting_interval_ms
+
+Interval at which the node level table mutation counts are sent to the auto analyze service which tracks table mutation counts at the cluster level.
+
+Default: 5000
+
+##### ysql_node_level_mutation_reporting_timeout_ms
+
+Timeout for the node level mutation reporting rpc to auto-analyze service.
+
+Default: 5000
+
 ## Advanced flags
 
 ##### backfill_index_client_rpc_timeout_ms