DOCSUP-2956 system events show zero values setting

docs/en/introduction/adopters.md

@@ -23,6 +23,7 @@ toc_title: Adopters
 | <a href="https://www.bigo.sg/" class="favicon">BIGO</a> | Video | Computing Platform | — | — | [Blog Article, August 2020](https://www.programmersought.com/article/44544895251/) |
 | <a href="https://www.bloomberg.com/" class="favicon">Bloomberg</a>                             | Finance, Media                  | Monitoring            | 102 servers                                                | —                                                                            | [Slides, May 2018](https://www.slideshare.net/Altinity/http-analytics-for-6m-requests-per-second-using-clickhouse-by-alexander-bocharov)                                                                                |
 | <a href="https://bloxy.info" class="favicon">Bloxy</a>                                         | Blockchain                      | Analytics             | —                                                          | —                                                                            | [Slides in Russian, August 2018](https://github.com/ClickHouse/clickhouse-presentations/blob/master/meetup17/4_bloxy.pptx)                                                                                              |
+| <a href="https://www.bytedance.com" class="favicon">Bytedance</a>                                              | Social platforms                            |  — | —                                                          | —                                                                            | [The ClickHouse Meetup East, October 2020](https://www.youtube.com/watch?v=ckChUkC3Pns)                                                                                                |
 | <a href="https://cardsmobile.ru/" class="favicon">CardsMobile</a> | Finance | Analytics | — | — | [VC.ru](https://vc.ru/s/cardsmobile/143449-rukovoditel-gruppy-analiza-dannyh) |
 | <a href="https://carto.com/" class="favicon">CARTO</a>                                         | Business Intelligence           | Geo analytics         | —                                                          | —                                                                            | [Geospatial processing with ClickHouse](https://carto.com/blog/geospatial-processing-with-clickhouse/)                                                                                                                  |
 | <a href="http://public.web.cern.ch/public/" class="favicon">CERN</a>                           | Research                        | Experiment            | —                                                          | —                                                                            | [Press release, April 2012](https://www.yandex.com/company/press_center/press_releases/2012/2012-04-10/)                                                                                                                |

docs/en/operations/settings/settings.md

@@ -2293,6 +2293,47 @@ Result:
    └─────────────────────────┴─────────┘
 ```
 
+## system_events_show_zero_values {#system_events_show_zero_values}
+
+Allows to select zero-valued events from [`system.events`](../../operations/system-tables/events.md).
+
+Some monitoring systems require passing all the metrics values to them for each checkpoint, even if the metric value is zero.
+
+Possible values:
+
+-   0 — Disabled.
+-   1 — Enabled.
+
+Default value: `0`.
+
+**Examples**
+
+Query
+
+```sql
+SELECT * FROM system.events WHERE event='QueryMemoryLimitExceeded';
+```
+
+Result
+
+```text
+Ok.
+```
+
+Query
+```sql
+SET system_events_show_zero_values = 1;
+SELECT * FROM system.events WHERE event='QueryMemoryLimitExceeded';
+```
+
+Result
+
+```text
+┌─event────────────────────┬─value─┬─description───────────────────────────────────────────┐
+│ QueryMemoryLimitExceeded │     0 │ Number of times when memory limit exceeded for query. │
+└──────────────────────────┴───────┴───────────────────────────────────────────────────────┘
+```
+
 ## allow_experimental_bigint_types {#allow_experimental_bigint_types}
 
 Enables or disables integer values exceeding the range that is supported by the int data type.

docs/ru/operations/settings/settings.md

@@ -2099,6 +2099,48 @@ SELECT TOP 3 name, value FROM system.settings;
    └─────────────────────────┴─────────┘
 ```
 
+## system_events_show_zero_values {#system_events_show_zero_values}
+
+Позволяет выбрать события с нулевыми значениями из таблицы [`system.events`](../../operations/system-tables/events.md).
+
+В некоторые системы мониторинга вам нужно передать значения всех измерений (для каждой контрольной точки), даже если в результате — "0".
+
+Возможные значения:
+
+-   0 — настройка отключена — вы получите все события.
+-   1 — настройка включена — вы сможете отсортировать события по нулевым и остальным значениям.
+
+Значение по умолчанию: `0`.
+
+**Примеры**
+
+Запрос
+
+```sql
+SELECT * FROM system.events WHERE event='QueryMemoryLimitExceeded';
+```
+
+Результат
+
+```text
+Ok.
+```
+
+Запрос
+
+```sql
+SET system_events_show_zero_values = 1;
+SELECT * FROM system.events WHERE event='QueryMemoryLimitExceeded';
+```
+
+Результат
+
+```text
+┌─event────────────────────┬─value─┬─description───────────────────────────────────────────┐
+│ QueryMemoryLimitExceeded │     0 │ Number of times when memory limit exceeded for query. │
+└──────────────────────────┴───────┴───────────────────────────────────────────────────────┘
+```
+
 ## allow_experimental_bigint_types {#allow_experimental_bigint_types}
 
 Включает или отключает поддержку целочисленных значений, превышающих максимальное значение, допустимое для типа `int`.