> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# system_* session settings

> ClickHouse session settings in the system_* generated group.

These settings are available in [system.settings](https://clickhouse.com/docs/reference/system-tables/settings.md) and are autogenerated from [source](https://github.com/ClickHouse/ClickHouse/blob/master/src/Core/Settings.cpp).

## system\_events\_show\_zero\_values

Type

Bool

Default

0

Allows to select zero-valued events from [`system.events`](https://clickhouse.com/docs/reference/system-tables/events).

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.

**Examples**

Query

```sql theme={null}
SELECT * FROM system.events WHERE event='QueryMemoryLimitExceeded';
```

Result

```text theme={null}
Ok.
```

Query

```sql theme={null}
SET system_events_show_zero_values = 1;
SELECT * FROM system.events WHERE event='QueryMemoryLimitExceeded';
```

Result

```text theme={null}
┌─event────────────────────┬─value─┬─description───────────────────────────────────────────┐
│ QueryMemoryLimitExceeded │     0 │ Number of times when memory limit exceeded for query. │
└──────────────────────────┴───────┴───────────────────────────────────────────────────────┘
```

## system\_metric\_log\_show\_zero\_values\_in\_histograms

Type

Bool

Default

0

Controls whether zero-valued histogram data is written to the `histograms` nested column of `system.metric_log`.

By default, histograms whose total observation `count` is zero are skipped, and within each emitted histogram, bucket entries with no observations are also omitted from the `histogram` map. Enable this to write every histogram and every bucket regardless of count — useful for monitoring systems that require every metric to appear at every checkpoint.

Possible values:

* 0 — Disabled. Histograms with `count = 0` are not emitted; emitted histograms include only buckets that received at least one observation.
* 1 — Enabled. All histograms are written, and every bucket boundary appears in `histogram`.
