Merge pull request #1906 from siggy/siggy/fix-urls

Slach · web-flow · commit c5aaf3e9b8df · 2026-01-15T16:29:44.000+05:00
Fix doc URLs in alerts and dashboards
diff --git a/deploy/helm/clickhouse-operator/files/Altinity_ClickHouse_Operator_dashboard.json b/deploy/helm/clickhouse-operator/files/Altinity_ClickHouse_Operator_dashboard.json
@@ -1282,7 +1282,7 @@
         {
           "targetBlank": true,
           "title": "max_concurent_queries",
-          "url": "https://clickhouse.com/docs/en/operations/server-configuration-parameters/settings#max_concurrent_queries"
+          "url": "https://clickhouse.com/docs/operations/server-configuration-parameters/settings#max_concurrent_queries"
         },
         {
           "targetBlank": true,
@@ -1412,7 +1412,7 @@
         {
           "targetBlank": true,
           "title": "max_concurent_queries",
-          "url": "https://clickhouse.com/docs/en/operations/server-configuration-parameters/settings#max-concurrent-queries"
+          "url": "https://clickhouse.com/docs/operations/server-configuration-parameters/settings#max_concurrent_queries"
         },
         {
           "targetBlank": true,
@@ -1727,7 +1727,7 @@
         {
           "targetBlank": true,
           "title": "max_concurent_queries",
-          "url": "https://clickhouse.com/docs/en/operations/server-configuration-parameters/settings#max_concurrent_queries"
+          "url": "https://clickhouse.com/docs/operations/server-configuration-parameters/settings#max_concurrent_queries"
         },
         {
           "targetBlank": true,
@@ -2253,7 +2253,7 @@
         {
           "targetBlank": true,
           "title": "max_replica_delay_for_distributed_queries",
-          "url": "https://clickhouse.com/docs/en/operations/settings/settings#settings-max_replica_delay_for_distributed_queries"
+          "url": "https://clickhouse.com/docs/operations/settings/settings#max_replica_delay_for_distributed_queries"
         }
       ],
       "options": {
@@ -4298,7 +4298,7 @@
         {
           "targetBlank": true,
           "title": "mark_cache_size",
-          "url": "https://clickhouse.com/docs/en/operations/server-configuration-parameters/settings/#server-mark-cache-size"
+          "url": "https://clickhouse.com/docs/operations/server-configuration-parameters/settings#mark_cache_size"
         },
         {
           "targetBlank": true,
@@ -5335,12 +5335,12 @@
         {
           "targetBlank": true,
           "title": "max_connections",
-          "url": "https://clickhouse.com/docs/en/operations/server-configuration-parameters/settings#max-connections"
+          "url": "https://clickhouse.com/docs/operations/server-configuration-parameters/settings#max_connections"
         },
         {
           "targetBlank": true,
           "title": "max_distributed_connections",
-          "url": "https://clickhouse.com/docs/en/operations/settings/settings#max-distributed-connections"
+          "url": "https://clickhouse.com/docs/operations/settings/settings#max_distributed_connections"
         },
         {
           "targetBlank": true,
diff --git a/deploy/prometheus/prometheus-alert-rules-clickhouse.yaml b/deploy/prometheus/prometheus-alert-rules-clickhouse.yaml
@@ -72,8 +72,8 @@ spec:
               `increase(chi_clickhouse_event_DNSError[1m])` = {{ with printf "increase(chi_clickhouse_event_DNSError{hostname='%s',exported_namespace='%s'}[1m]) or increase(chi_clickhouse_event_NetworkErrors{hostname='%s',exported_namespace='%s'}[1m])" .Labels.hostname .Labels.exported_namespace .Labels.hostname .Labels.exported_namespace | query }}{{ . | first | value | printf "%.2f" }} errors{{ end }}
               Please check DNS settings in `/etc/resolve.conf` and `<remote_servers>` part of `/etc/clickhouse-server/`
               See documentation:
-              - https://clickhouse.com/docs/en/operations/server-configuration-parameters/settings/#server-settings-remote-servers
-              - https://clickhouse.com/docs/en/operations/server-configuration-parameters/settings/#server-settings-disable-internal-dns-cache
+              - https://clickhouse.com/docs/operations/server-configuration-parameters/settings#remote_servers
+              - https://clickhouse.com/docs/operations/server-configuration-parameters/settings#disable_internal_dns_cache
               - https://clickhouse.com/docs/en/sql-reference/statements/system/
 
         - alert: ClickHouseDistributedFilesToInsertHigh
@@ -112,7 +112,7 @@ spec:
               `increase(chi_clickhouse_event_DistributedConnectionFailAtAll[1m])` = {{ with printf "increase(chi_clickhouse_event_DistributedConnectionFailAtAll{hostname='%s',exported_namespace='%s'}[1m])" .Labels.hostname .Labels.exported_namespace | query }}{{ . | first | value | printf "%.2f" }} errors{{ end }}
 
               Please, check communications between clickhouse server and host `remote_servers` in `/etc/clickhouse-server/`
-              https://clickhouse.com/docs/en/operations/server-configuration-parameters/settings/#server-settings-remote-servers
+              https://clickhouse.com/docs/operations/server-configuration-parameters/settings#remote_servers
 
               Also, you can check logs:
               ```kubectl logs -n {{ $labels.exported_namespace }} $( echo {{ $labels.hostname }} | cut -d '.' -f 1)-0 -f```
@@ -178,7 +178,7 @@ spec:
               Please use Buffer table
               https://clickhouse.com/docs/en/engines/table-engines/special/buffer/
               or
-              https://clickhouse.com/docs/en/operations/settings/settings/#async-insert
+              https://clickhouse.com/docs/operations/settings/settings#async_insert
 
         - alert: ClickHouseLongestRunningQuery
           expr: chi_clickhouse_metric_LongestRunningQuery > 600
@@ -259,7 +259,7 @@ spec:
               The ClickHouse is adapted to run not a very large number of parallel SQL requests, not every HTTP/TCP(Native)/MySQL protocol connection means a running SQL request, but a large number of open connections can cause a spike in sudden SQL requests, resulting in performance degradation.
 
               Also read documentation:
-              - https://clickhouse.com/docs/en/operations/server-configuration-parameters/settings/#max-concurrent-queries
+              - https://clickhouse.com/docs/operations/server-configuration-parameters/settings#max_concurrent_queries
 
 
         - alert: ClickHouseTooManyRunningQueries
@@ -279,7 +279,7 @@ spec:
               Look at following documentation parts:
               - https://clickhouse.com/docs/en/operations/settings/query-complexity/
               - https://clickhouse.com/docs/en/operations/quotas/
-              - https://clickhouse.com/docs/en/operations/server-configuration-parameters/settings/#max-concurrent-queries
+              - https://clickhouse.com/docs/operations/server-configuration-parameters/settings#max_concurrent_queries
               - https://clickhouse.com/docs/en/operations/system-tables/query_log/
 
         - alert: ClickHouseSystemSettingsChanged
@@ -527,7 +527,7 @@ spec:
               chi_clickhouse_metric_BackgroundMessageBrokerSchedulePoolTask = {{ with printf "chi_clickhouse_metric_BackgroundMessageBrokerSchedulePoolTask{exported_namespace='%s',chi='%s',hostname='%s'}" .Labels.exported_namespace .Labels.chi .Labels.hostname | query }}{{ . | first | value | printf "%.0f" }}{{ end }}
               chi_clickhouse_metric_BackgroundMessageBrokerSchedulePoolSize = {{ with printf "chi_clickhouse_metric_BackgroundMessageBrokerSchedulePoolSize{exported_namespace='%s',chi='%s',hostname='%s'}" .Labels.exported_namespace .Labels.chi .Labels.hostname | query }}{{ . | first | value | printf "%.0f" }}{{ end }}
               - https://kb.altinity.com/altinity-kb-integrations/altinity-kb-kafka/background_message_broker_schedule_pool_size/
-              - https://clickhouse.com/docs/en/operations/server-configuration-parameters/settings#background_message_broker_schedule_pool_size
+              - https://clickhouse.com/docs/operations/server-configuration-parameters/settings#background_message_broker_schedule_pool_size
               - https://clickhouse.com/docs/en/operations/system-tables/metrics#backgroundmessagebrokerschedulepoolsize
               This pool is used for tasks related to message streaming from Apache Kafka or other message brokers.
               You need to increase `background_message_broker_schedule_pool_size` to fix the problem.
diff --git a/grafana-dashboard/Altinity_ClickHouse_Operator_dashboard.json b/grafana-dashboard/Altinity_ClickHouse_Operator_dashboard.json
@@ -1282,7 +1282,7 @@
         {
           "targetBlank": true,
           "title": "max_concurent_queries",
-          "url": "https://clickhouse.com/docs/en/operations/server-configuration-parameters/settings#max_concurrent_queries"
+          "url": "https://clickhouse.com/docs/operations/server-configuration-parameters/settings#max_concurrent_queries"
         },
         {
           "targetBlank": true,
@@ -1412,7 +1412,7 @@
         {
           "targetBlank": true,
           "title": "max_concurent_queries",
-          "url": "https://clickhouse.com/docs/en/operations/server-configuration-parameters/settings#max-concurrent-queries"
+          "url": "https://clickhouse.com/docs/operations/server-configuration-parameters/settings#max_concurrent_queries"
         },
         {
           "targetBlank": true,
@@ -1727,7 +1727,7 @@
         {
           "targetBlank": true,
           "title": "max_concurent_queries",
-          "url": "https://clickhouse.com/docs/en/operations/server-configuration-parameters/settings#max_concurrent_queries"
+          "url": "https://clickhouse.com/docs/operations/server-configuration-parameters/settings#max_concurrent_queries"
         },
         {
           "targetBlank": true,
@@ -2253,7 +2253,7 @@
         {
           "targetBlank": true,
           "title": "max_replica_delay_for_distributed_queries",
-          "url": "https://clickhouse.com/docs/en/operations/settings/settings#settings-max_replica_delay_for_distributed_queries"
+          "url": "https://clickhouse.com/docs/operations/settings/settings#max_replica_delay_for_distributed_queries"
         }
       ],
       "options": {
@@ -4298,7 +4298,7 @@
         {
           "targetBlank": true,
           "title": "mark_cache_size",
-          "url": "https://clickhouse.com/docs/en/operations/server-configuration-parameters/settings/#server-mark-cache-size"
+          "url": "https://clickhouse.com/docs/operations/server-configuration-parameters/settings#mark_cache_size"
         },
         {
           "targetBlank": true,
@@ -5335,12 +5335,12 @@
         {
           "targetBlank": true,
           "title": "max_connections",
-          "url": "https://clickhouse.com/docs/en/operations/server-configuration-parameters/settings#max-connections"
+          "url": "https://clickhouse.com/docs/operations/server-configuration-parameters/settings#max_connections"
         },
         {
           "targetBlank": true,
           "title": "max_distributed_connections",
-          "url": "https://clickhouse.com/docs/en/operations/settings/settings#max-distributed-connections"
+          "url": "https://clickhouse.com/docs/operations/settings/settings#max_distributed_connections"
         },
         {
           "targetBlank": true,

Original file line number	Diff line number	Diff line change
`@@ -1282,7 +1282,7 @@`
`1282`	`1282`	`{`
`1283`	`1283`	`"targetBlank": true,`
`1284`	`1284`	`"title": "max_concurent_queries",`
`1285`		`- "url": "https://clickhouse.com/docs/en/operations/server-configuration-parameters/settings#max_concurrent_queries"`
	`1285`	`+ "url": "https://clickhouse.com/docs/operations/server-configuration-parameters/settings#max_concurrent_queries"`
`1286`	`1286`	`},`
`1287`	`1287`	`{`
`1288`	`1288`	`"targetBlank": true,`
`@@ -1412,7 +1412,7 @@`
`1412`	`1412`	`{`
`1413`	`1413`	`"targetBlank": true,`
`1414`	`1414`	`"title": "max_concurent_queries",`
`1415`		`- "url": "https://clickhouse.com/docs/en/operations/server-configuration-parameters/settings#max-concurrent-queries"`
	`1415`	`+ "url": "https://clickhouse.com/docs/operations/server-configuration-parameters/settings#max_concurrent_queries"`
`1416`	`1416`	`},`
`1417`	`1417`	`{`
`1418`	`1418`	`"targetBlank": true,`
`@@ -1727,7 +1727,7 @@`
`1727`	`1727`	`{`
`1728`	`1728`	`"targetBlank": true,`
`1729`	`1729`	`"title": "max_concurent_queries",`
`1730`		`- "url": "https://clickhouse.com/docs/en/operations/server-configuration-parameters/settings#max_concurrent_queries"`
	`1730`	`+ "url": "https://clickhouse.com/docs/operations/server-configuration-parameters/settings#max_concurrent_queries"`
`1731`	`1731`	`},`
`1732`	`1732`	`{`
`1733`	`1733`	`"targetBlank": true,`
`@@ -2253,7 +2253,7 @@`
`2253`	`2253`	`{`
`2254`	`2254`	`"targetBlank": true,`
`2255`	`2255`	`"title": "max_replica_delay_for_distributed_queries",`
`2256`		`- "url": "https://clickhouse.com/docs/en/operations/settings/settings#settings-max_replica_delay_for_distributed_queries"`
	`2256`	`+ "url": "https://clickhouse.com/docs/operations/settings/settings#max_replica_delay_for_distributed_queries"`
`2257`	`2257`	`}`
`2258`	`2258`	`],`
`2259`	`2259`	`"options": {`
`@@ -4298,7 +4298,7 @@`
`4298`	`4298`	`{`
`4299`	`4299`	`"targetBlank": true,`
`4300`	`4300`	`"title": "mark_cache_size",`
`4301`		`- "url": "https://clickhouse.com/docs/en/operations/server-configuration-parameters/settings/#server-mark-cache-size"`
	`4301`	`+ "url": "https://clickhouse.com/docs/operations/server-configuration-parameters/settings#mark_cache_size"`
`4302`	`4302`	`},`
`4303`	`4303`	`{`
`4304`	`4304`	`"targetBlank": true,`
`@@ -5335,12 +5335,12 @@`
`5335`	`5335`	`{`
`5336`	`5336`	`"targetBlank": true,`
`5337`	`5337`	`"title": "max_connections",`
`5338`		`- "url": "https://clickhouse.com/docs/en/operations/server-configuration-parameters/settings#max-connections"`
	`5338`	`+ "url": "https://clickhouse.com/docs/operations/server-configuration-parameters/settings#max_connections"`
`5339`	`5339`	`},`
`5340`	`5340`	`{`
`5341`	`5341`	`"targetBlank": true,`
`5342`	`5342`	`"title": "max_distributed_connections",`
`5343`		`- "url": "https://clickhouse.com/docs/en/operations/settings/settings#max-distributed-connections"`
	`5343`	`+ "url": "https://clickhouse.com/docs/operations/settings/settings#max_distributed_connections"`
`5344`	`5344`	`},`
`5345`	`5345`	`{`
`5346`	`5346`	`"targetBlank": true,`