merge main and resolve conflicts

Author: Blargian

contribute/autogenerated-documentation-from-source.md

@@ -61,18 +61,16 @@ TO DO
 ## Functions
 
 Documentation for functions is autogenerated from the documentation in system tables (`system.functions`) which is 
-registered along with the function registration in the C++ code.
+registered along with the function registration in the C++ code. ([Example](https://github.com/ClickHouse/ClickHouse/blob/a0216c8120f00479f50237e41c897c2bf244e1ef/src/Functions/FunctionChar.cpp#L116-L158))
 
-To add a new page:
-- add SQL to generate the markdown from system tables
-- update `autogenerate-settings.sh` in the section which specifies which markdown file contents to
-  copy to which file in between the `<!--AUTOGENERATED_START-->` and `<!--AUTOGENERATED_END-->`
+This [script](https://github.com/ClickHouse/clickhouse-docs/blob/main/scripts/settings/autogenerate-settings.sh) is used to generate
+the markdown docs for functions.
 
-The following pages are autogenerated from the source code for functions:
-- [Arithmetic](/sql-reference/functions/arithmetic-functions) ([SQL](../scripts/settings/arithmetic-functions.sql))
-- [Arrays](/sql-reference/functions/array-functions) ([SQL](../scripts/settings/array-functions.sql))
-- [Bit](/sql-reference/functions/bit-functions) ([SQL](../scripts/settings/bit-functions.sql))
-- [Bitmap](/sql-reference/functions/bitmap-functions) ([SQL](../scripts/settings/bitmap-functions.sql))
-- [Comparison](/sql-reference/functions/comparison-functions) ([SQL](../scripts/settings/comparison-functions.sql))
-- [Conditional](/sql-reference/functions/conditional-functions) ([SQL](../scripts/settings/conditional-functions.sql))
+Adding a new page can be done by:
 
+1. Adding the function [category](https://github.com/ClickHouse/ClickHouse/blob/85700c135ccad89d3651a7a92ca63bb989743ba6/src/Common/FunctionDocumentation.cpp#L222-L273) to the [list of function categories to generate](https://github.com/ClickHouse/clickhouse-docs/blob/c31d64bc5d71c6c3afc5b520dbb73386e303447b/scripts/settings/autogenerate-settings.sh#L253-L278).
+2. The docs are automatically generated for the categories defined above by [this SQL code](https://github.com/ClickHouse/clickhouse-docs/blob/main/scripts/settings/generate-functions.sql). It produces a temporary markdown file with convention: `category-functions.md`. If the category name contains spaces, e.g. "String Splitting" then the temporary file will be `string_splitting-functions.md`.
+3. Register the temporary file name [here](https://github.com/ClickHouse/clickhouse-docs/blob/c31d64bc5d71c6c3afc5b520dbb73386e303447b/scripts/settings/autogenerate-settings.sh#L372)
+4. Register the destination file you want to insert the markdown into [here](https://github.com/ClickHouse/clickhouse-docs/blob/c31d64bc5d71c6c3afc5b520dbb73386e303447b/scripts/settings/autogenerate-settings.sh#L399)
+
+The script takes the content of the temporary markdown file and inserts it into the destination file between tags `<!--AUTOGENERATED_START-->` and `<!--AUTOGENERATED_END-->`. If those tags do not exist you will get a warning.

docs/_placeholders/api/_invitations-api-reference.md

@@ -0,0 +1,21 @@
+import Image from '@theme/IdealImage';
+import clickstackTagsSearch from '@site/static/images/use-cases/observability/clickstack-tags-search.png';
+import clickstackTagsDashboard from '@site/static/images/use-cases/observability/clickstack-tags-dashboard.png';
+
+You can add tags to dashboards and saved searches to help organize them.
+Tags provide a flexible way to categorize and filter based on your needs.
+
+#### How tags work {#how-tags-work}
+
+- **Organization**: Tags appear in the left sidebar, where dashboards and saved searches are grouped by their assigned tags
+- **Multiple tags**: You can add one or more tags to a single item for better categorization
+- **Auto-creation**: If you assign a tag that doesn't exist yet, it will be automatically created
+- **Easy management**: You can add or remove tags at any time to adjust your organization structure
+
+This makes it easy to find related items and maintain an organized workspace as your collection grows.
+
+<Image img={clickstackTagsSearch} alt="Tags in saved search" size="md" border />
+
+You can also select multiple tags to filter and view items across different categories:
+
+<Image img={clickstackTagsDashboard} alt="Multiple tags selected in dashboard" size="md" border />

docs/_placeholders/api/_keys-api-reference.md

@@ -0,0 +1,7 @@
+## Community monitoring solutions {#community-monitoring}
+
+The ClickHouse community has developed comprehensive monitoring solutions that integrate with popular observability stacks. [ClickHouse Monitoring](https://github.com/duyet/clickhouse-monitoring) provides a complete monitoring setup with pre-built dashboards. This open source project offers a quick-start approach for teams looking to implement ClickHouse monitoring with established best practices and proven dashboard configurations.
+
+:::note
+Like other direct database monitoring approaches, this solution queries ClickHouse system tables directly, which prevents instances from idling and impacts cost optimization. 
+:::

docs/_placeholders/api/_members-api-reference.md

@@ -0,0 +1,40 @@
+import Image from '@theme/IdealImage';
+import AdvancedDashboard from '@site/static/images/cloud/manage/monitoring/advanced_dashboard.png';
+import NativeAdvancedDashboard from '@site/static/images/cloud/manage/monitoring/native_advanced_dashboard.png';
+
+### Direct Grafana plugin integration {#direct-grafana}
+
+The ClickHouse data source plugin for Grafana enables visualization and exploration of data directly from ClickHouse using system tables. This approach works well for monitoring performance and creating custom dashboards for detailed system analysis.
+For plugin installation and configuration details, see the ClickHouse [data source plugin](/integrations/grafana). For a complete monitoring setup using the Prometheus-Grafana mix-in with pre-built dashboards and alerting rules, see [Monitor ClickHouse with the new Prometheus-Grafana mix-in](https://clickhouse.com/blog/monitor-with-new-prometheus-grafana-mix-in).
+
+### Direct Datadog Integration {#direct-datadog}
+
+Datadog offers a Clickhouse Monitoring plugin for its agent which queries system tables directly. This integration provides comprehensive database monitoring with cluster awareness through clusterAllReplicas functionality. 
+:::note
+This integration is not recommended for ClickHouse Cloud deployments due to incompatibility with cost-optimizing idle behavior and operational limitations of the cloud proxy layer.
+:::
+
+### Using system tables directly {#system-tables}
+
+Users can perform deep query performance analysis by connecting to ClickHouse system tables, particularly `system.query_log` and querying directly. Using either the SQL console or clickhouse client, teams can identify slow queries, analyze resource usage, and track usage patterns across the organization.
+
+**Query Performance Analysis**
+
+Users can use the system table query logs to perform Query Performance Analysis.
+
+**Example query**: Find the top 5 long-running queries across all cluster replicas:
+
+```sql
+SELECT
+    type,
+    event_time, 
+    query_duration_ms,
+    query,
+    read_rows,
+    tables
+FROM clusterAllReplicas(default, system.query_log)
+WHERE event_time >= (now() - toIntervalMinute(60)) AND type='QueryFinish'
+ORDER BY query_duration_ms DESC
+LIMIT 5
+FORMAT VERTICAL
+```