> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-parallel-read-in-order-multi-part.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> ClickHouse における割り当てプロファイリングの詳細ページ

# 割り当てプロファイリング

ClickHouse はグローバルアロケータとして [jemalloc](https://github.com/jemalloc/jemalloc) を使用しています。jemalloc には、割り当てのサンプリングやプロファイリングのためのツールが含まれています。

ClickHouse と Keeper では、設定ファイル、クエリ設定、`SYSTEM` コマンド、および Keeper の four letter word (4LW) コマンドを使ってサンプリングを制御できます。結果を確認する方法はいくつかあります。

* クエリごとの分析のために、`JemallocSample` タイプとしてサンプルを `system.trace_log` に収集します。
* 組み込みの [jemalloc web UI](#jemalloc-web-ui) を使って、リアルタイムのメモリ統計を表示し、ヒーププロファイルを取得します (26.2+) 。
* [`system.jemalloc_profile_text`](#fetching-heap-profiles-from-sql) を使用して、現在のヒーププロファイルを SQL から直接クエリできます (26.2+) 。
* [`system.jemalloc_sampled_allocations`](#analyzing-fragmentation-from-sql) を使用して、メモリの断片化を SQL から分析できます (26.9+) 。
* ヒーププロファイルをディスクに フラッシュ し、[`jeprof`](#analyzing-heap-profile-files-with-jeprof) で解析します。

<Note>
  このガイドはバージョン 25.9 以降に対応しています。
  それ以前のバージョンについては、[25.9 より前のバージョン向けの割り当てプロファイリング](/ja/concepts/features/performance/allocation-profiling-old) を参照してください。
</Note>

<h2 id="sampling-allocations">
  メモリ割り当てのサンプリング
</h2>

メモリ割り当てをサンプリングしてプロファイリングするには、`jemalloc_enable_global_profiler` 設定を有効にして ClickHouse/Keeper を起動します。

```xml theme={null}
<clickhouse>
    <jemalloc_enable_global_profiler>1</jemalloc_enable_global_profiler>
</clickhouse>
```

`jemalloc` は割り当てをサンプリングし、その情報を内部的に保存します。

`jemalloc_enable_profiler` 設定を使用すると、クエリごとにサンプリングを有効にすることもできます。

<Warning>
  **警告**

  ClickHouse はメモリ割り当てが多いアプリケーションであるため、jemalloc のサンプリングによりパフォーマンスのオーバーヘッドが発生する可能性があります。
</Warning>

<h2 id="storing-jemalloc-samples-in-system-trace-log">
  jemallocのサンプルを`system.trace_log`に保存する
</h2>

jemallocのサンプルは、`JemallocSample`タイプで`system.trace_log`に保存できます。
これをグローバルに有効化するには、`jemalloc_collect_global_profile_samples_in_trace_log`設定を使用します。

```xml theme={null}
<clickhouse>
    <jemalloc_collect_global_profile_samples_in_trace_log>1</jemalloc_collect_global_profile_samples_in_trace_log>
</clickhouse>
```

<Warning>
  **警告**

  ClickHouse はメモリ割り当てが多いアプリケーションであるため、system.trace\_log ですべてのサンプルを収集すると、大きな負荷がかかる可能性があります。
</Warning>

`jemalloc_collect_profile_samples_in_trace_log` 設定を使うと、これをクエリごとに有効にすることもできます。

<h3 id="example-analyzing-memory-usage-trace-log">
  例: クエリのメモリ使用量を分析する
</h3>

まず、jemallocプロファイラを有効にしてクエリを実行し、サンプルを `system.trace_log` に収集します:

```sql theme={null}
SELECT *
FROM numbers(1000000)
ORDER BY number DESC
SETTINGS max_bytes_ratio_before_external_sort = 0
FORMAT `Null`
SETTINGS jemalloc_enable_profiler = 1, jemalloc_collect_profile_samples_in_trace_log = 1

Query id: 8678d8fe-62c5-48b8-b0cd-26851c62dd75

Ok.

0 rows in set. Elapsed: 0.009 sec. Processed 1.00 million rows, 8.00 MB (108.58 million rows/s., 868.61 MB/s.)
Peak memory usage: 12.65 MiB.
```

<Note>
  ClickHouse が `jemalloc_enable_global_profiler` を指定して起動されている場合、`jemalloc_enable_profiler` を有効にする必要はありません。
  `jemalloc_collect_global_profile_samples_in_trace_log` と `jemalloc_collect_profile_samples_in_trace_log` についても同様です。
</Note>

`system.trace_log` をフラッシュします:

```sql theme={null}
SYSTEM FLUSH LOGS trace_log
```

次に、これに対してクエリを実行し、時間の経過に伴う累積メモリ使用量を取得します。

```sql theme={null}
WITH per_bucket AS
(
    SELECT
        event_time_microseconds AS bucket_time,
        sum(size) AS bucket_sum
    FROM system.trace_log
    WHERE trace_type = 'JemallocSample'
      AND query_id = '8678d8fe-62c5-48b8-b0cd-26851c62dd75'
    GROUP BY bucket_time
)
SELECT
    bucket_time,
    sum(bucket_sum) OVER (
        ORDER BY bucket_time ASC
        ROWS BETWEEN UNBOUNDED PRECEDING AND CURRENT ROW
    ) AS cumulative_size,
    formatReadableSize(cumulative_size) AS cumulative_size_readable
FROM per_bucket
ORDER BY bucket_time
```

メモリ使用量が最も高かった時刻を確認します:

```sql theme={null}
SELECT
    argMax(bucket_time, cumulative_size),
    max(cumulative_size)
FROM
(
    WITH per_bucket AS
    (
        SELECT
            event_time_microseconds AS bucket_time,
            sum(size) AS bucket_sum
        FROM system.trace_log
        WHERE trace_type = 'JemallocSample'
          AND query_id = '8678d8fe-62c5-48b8-b0cd-26851c62dd75'
        GROUP BY bucket_time
    )
    SELECT
        bucket_time,
        sum(bucket_sum) OVER (
            ORDER BY bucket_time ASC
            ROWS BETWEEN UNBOUNDED PRECEDING AND CURRENT ROW
        ) AS cumulative_size,
        formatReadableSize(cumulative_size) AS cumulative_size_readable
    FROM per_bucket
    ORDER BY bucket_time
)
```

その結果を使って、ピーク時に最も多くの割り当てを行っていたスタックを確認します。

```sql theme={null}
SELECT
    concat(
        '\n',
        arrayStringConcat(
            arrayMap(
                (x, y) -> concat(x, ': ', y),
                arrayMap(x -> addressToLine(x), allocation_trace),
                arrayMap(x -> demangle(addressToSymbol(x)), allocation_trace)
            ),
            '\n'
        )
    ) AS symbolized_trace,
    sum(s) AS per_trace_sum
FROM
(
    SELECT
        ptr,
        sum(size) AS s,
        argMax(trace, event_time_microseconds) AS allocation_trace
    FROM system.trace_log
    WHERE trace_type = 'JemallocSample'
      AND query_id = '8678d8fe-62c5-48b8-b0cd-26851c62dd75'
      AND event_time_microseconds <= '2025-09-04 11:56:21.737139'
    GROUP BY ptr
    HAVING s > 0
)
GROUP BY ALL
ORDER BY per_trace_sum ASC
```

<h2 id="jemalloc-web-ui">
  Jemalloc web UI
</h2>

<Note>
  このセクションはバージョン 26.2 以降に適用されます。
</Note>

ClickHouse には、`/jemalloc` HTTP エンドポイントで jemalloc のメモリ統計を表示する組み込みの web UI があります。
allocated、active、resident、mapped memory に加え、アリーナごとおよび ビン ごとの統計を含むライブのメモリメトリクスが、チャートで表示されます。
また、グローバルおよびクエリごとのヒーププロファイルを UI から直接取得することもできます。

<Tabs>
  <Tab title="ClickHouse">
    ```text theme={null}
    http://localhost:8123/jemalloc
    ```

    サーバー UI には、Summary、Allocations、Arenas、Operations、Global Profiler、Query Profiler、Fragmentation、Raw Output のすべてのタブが含まれています。
  </Tab>

  <Tab title="Keeper">
    ```text theme={null}
    http://localhost:9182/jemalloc
    ```

    Keeper UI は HTTP control port で利用できます。このポートは**デフォルトで無効**になっており、Keeper の設定で `keeper_server.http_control.port` を設定して明示的に有効にする必要があります。

    ```xml theme={null}
    <clickhouse>
        <keeper_server>
            <http_control>
                <port>9182</port>
            </http_control>
        </keeper_server>
    </clickhouse>
    ```

    有効にすると、この UI ではサーバーと同じ可視化、つまり Summary、Allocations、Arenas、Operations、Global Profiler、Raw Output が利用できます。ただし、Query Profiler および Fragmentation タブは、システムテーブルへの SQL アクセスを必要とするため除きます。

    <Warning>
      **セキュリティ**

      Keeper HTTP control port には、アプリケーションレベルの認証がありません。すべてのデータクエリが SQL HTTP ハンドラーを通り、ユーザー名/パスワードの認証情報が必要な ClickHouse Server の jemalloc UI とは異なり、Keeper の REST API エンドポイントには認証がありません。これは、他の Keeper HTTP control エンドポイント (commands、storage、dashboard) と同様です。

      このポートへのアクセスは、ネットワークレベルの制御で制限してください。Keeper を localhost にバインドする、ファイアウォールルールを使用する、または認証付きのリバースプロキシの背後に配置します。`listen_host` が設定されていない場合、Keeper はデフォルトで localhost のみで待ち受けます。
    </Warning>

    Keeper は、プログラムからアクセスするための REST API エンドポイントも公開しています。

    * `GET /jemalloc/stats` — 生の `malloc_stats_print` 出力
    * `GET /jemalloc/status` — JSON 形式の profiling state (`prof_enabled`、`prof_active`、`thread_active_init`、`lg_sample`)
    * `GET /jemalloc/profile?format={collapsed|raw}` — サーバー側で symbolization を行ってヒーププロファイルを flush し、フレームグラフの描画に適したコラプスされたスタック (デフォルト) または生の jemalloc dump を返します
  </Tab>
</Tabs>

<h2 id="fetching-heap-profiles-from-sql">
  SQL からヒーププロファイルを取得する
</h2>

<Note>
  このセクションはバージョン 26.2 以降が対象です。
</Note>

`system.jemalloc_profile_text` システムテーブルを使用すると、外部ツールを使ったり、事前にディスクへフラッシュしたりしなくても、現在の jemalloc ヒーププロファイルを SQL から直接取得して確認できます。

このテーブルには 1 つのカラムがあります。

| Column | Type | Description |
| - | - | - |
| `line` | String | シンボル化された jemalloc ヒーププロファイルの行。 |

このテーブルには直接クエリできます。事前にヒーププロファイルをフラッシュする必要はありません。

```sql theme={null}
SELECT * FROM system.jemalloc_profile_text
```

<h3 id="output-format">
  出力フォーマット
</h3>

出力フォーマットは `jemalloc_profile_text_output_format` 設定で制御され、次の 3 つの値をサポートしています。

* `raw` — jemalloc によって生成される生のヒーププロファイル。
* `symbolized` — 関数シンボルが埋め込まれた `jeprof` 互換フォーマットです。シンボルはすでに埋め込まれているため、`jeprof` は ClickHouse バイナリがなくても出力を解析できます。
* `collapsed` (デフォルト) — フレームグラフ互換のコラプスされたスタックです。各行に 1 つのスタックとバイト数が含まれます。

たとえば、生のプロファイルを取得するには次のようにします。

```sql theme={null}
SELECT * FROM system.jemalloc_profile_text
SETTINGS jemalloc_profile_text_output_format = 'raw'
```

シンボル化された出力を取得するには:

```sql theme={null}
SELECT * FROM system.jemalloc_profile_text
SETTINGS jemalloc_profile_text_output_format = 'symbolized'
```

<h3 id="fetching-heap-profiles-settings">
  追加設定
</h3>

* `jemalloc_profile_text_symbolize_with_inline` (Bool, デフォルト: `true`) — シンボル化の際にインラインフレームを含めるかどうかを指定します。これを無効にするとシンボル化は大幅に高速化されますが、インライン化された関数呼び出しがスタックに表示されなくなるため、精度は低下します。影響するのは `symbolized` および `collapsed` フォーマットのみです。
* `jemalloc_profile_text_collapsed_use_count` (Bool, デフォルト: `false`) — `collapsed` フォーマットを使用する場合、バイト数ではなく割り当て回数で集計します。

<h3 id="example-flamegraph-from-sql">
  例: SQLからフレームグラフを生成する
</h3>

デフォルトの出力フォーマットは `collapsed` なので、出力をそのまま FlameGraph に渡せます:

```sh theme={null}
clickhouse-client -q "SELECT * FROM system.jemalloc_profile_text" | flamegraph.pl --color=mem --title="Allocation Flame Graph" --width 2400 > result.svg
```

バイト数ではなく、割り当て回数ベースで flame graph を生成するには:

```sh theme={null}
clickhouse-client -q "SELECT * FROM system.jemalloc_profile_text SETTINGS jemalloc_profile_text_collapsed_use_count = 1" | flamegraph.pl --color=mem --title="Allocation Count Flame Graph" --width 2400 > result.svg
```

<h2 id="analyzing-fragmentation-from-sql">
  SQL からの断片化の分析
</h2>

<Note>
  このセクションはバージョン 26.9 以降に適用されます。
</Note>

jemalloc は小さな割り当てをスラブから提供します。スラブとは、単一の size class のリージョンに分割された固定サイズのメモリブロックです。スラブが解放されるのは、その中のすべてのリージョンが解放されたときだけです。ある size class の割り当ての大部分がすぐに解放される一方で、一部が長時間存続すると、スラブはほとんどが空きリージョンのまま固定され続けます。メモリは常駐したままですが、割り当てられてはいません。ここでいう断片化とは、この状態を指します。

その原因を突き止めるには、次の 2 つのシステムテーブルが役立ちます:

* [`system.jemalloc_arena_bins`](/ja/reference/system-tables/jemalloc_bins) は、各アリーナにおいて各 size class がどれだけメモリを無駄にしているかを示します。`waste` は、スラブに保持されているものの、生存中の割り当てには使われていないバイト数です。`purpose` は専用アリーナ (`mergetree`、`jit`、`cache`) を示します。これらは設計上、長寿命のデータを保持するため、想定外の断片化を調べる際は `purpose = ''` で除外してください。`system.jemalloc_bins` は、同じデータをアリーナ全体で合計したものです。
* `system.jemalloc_sampled_allocations` は、現在生存しているサンプリング済みの割り当てを、サンプルごとに 1 行で一覧表示します。含まれるのは、バックトレース (`trace`) 、生存期間 (`age_ns`) 、サイズと size class、およびアリーナです。このテーブルを読み取ると、新しいヒーププロファイルがフラッシュされます。

この 2 つをアリーナと size class で結合すると、無駄の多い size class において、どのコードが古いオブジェクトを割り当てたのかが分かります。

結果を読む際は、次の点に留意してください:

* プロファイラ が有効なスレッドだけがサンプルを生成します (設定ファイル内の `jemalloc_enable_global_profiler`、または `jemalloc_enable_profiler` 設定) 。
* 各行はおよそ `weight` 件の実際の割り当てを表しており、小さな割り当てがサンプリングされる頻度は低くなります。関心のある size class にサンプルが現れない場合は、`jemalloc_profiler_sampling_rate` を調整してください。
* サンプリングされた割り当てはスラブに格納されないため、それ自体が `waste` に加算されることはありません。分かるのは、その size class でどのコードが割り当てを行っているかだけです。
* 生存中のサンプルは、割り当てが解放されるまで 1 件につき追加で 2 ページ (64 KiB ページのビルドでは 128 KiB) を消費します。プロファイラ を無効にすると新しいサンプルの生成は止まりますが、既存のサンプルが解放されるわけではありません。

次のクエリは、1 MiB を超える無駄が発生している size class において、1 分より古い割り当てのバックトレースを一覧表示します:

```sql theme={null}
WITH 60e9 AS min_age_ns
SELECT
    b.arena,
    b.size AS reg_size,
    b.waste AS class_waste,
    s.est_old_objects,
    s.stack
FROM system.jemalloc_arena_bins AS b
INNER JOIN
(
    SELECT
        arena,
        size_class,
        sum(weight) AS est_old_objects,
        arrayStringConcat(arrayMap(a -> demangle(addressToSymbol(a)), arrayReverse(trace)), ';') AS stack
    FROM system.jemalloc_sampled_allocations
    WHERE age_ns > min_age_ns
    GROUP BY arena, size_class, trace
) AS s ON s.size_class = b.index AND s.arena = b.arena
WHERE b.large = 0 AND b.purpose = '' AND b.waste > 1048576
ORDER BY b.waste DESC, s.est_old_objects DESC
SETTINGS allow_introspection_functions=1
```

<h3 id="example-fragmentation-flamegraph">
  例: 断片化のフレームグラフを生成する
</h3>

同じクエリで、各 size class の無駄を、古い割り当ての数に比例させてバックトレースごとに分割し、その結果を `flamegraph.pl` 向けの collapsed フォーマットで出力することもできます。無駄はあるものの十分に古いサンプルが存在しない size class は `[unattributed]` フレームにまとめられるため、フレームグラフの合計が無駄の総量となります。`system.jemalloc_sampled_allocations` の読み取りは 1 クエリにつき 1 回にしてください。読み取るたびに新しい profile がフラッシュされるため、2 つのサブクエリからは異なるデータが見えてしまいます。

```sql theme={null}
WITH 60e9 AS min_age_ns
SELECT format('{} {}',
    if(s.est_old_objects > 0, s.stack, format('[unattributed];arena_{}_class_{}', toString(b.arena), toString(b.size))),
    toString(toUInt64(if(s.est_old_objects > 0, b.waste * s.est_old_objects / sum(s.est_old_objects) OVER (PARTITION BY b.arena, b.index), b.waste))))
FROM system.jemalloc_arena_bins AS b
LEFT JOIN
(
    SELECT
        arena,
        size_class,
        sum(weight) AS est_old_objects,
        arrayStringConcat(arrayMap(a -> demangle(addressToSymbol(a)), arrayReverse(trace)), ';') AS stack
    FROM system.jemalloc_sampled_allocations
    WHERE age_ns > min_age_ns
    GROUP BY arena, size_class, trace
) AS s ON s.size_class = b.index AND s.arena = b.arena
WHERE b.large = 0 AND b.purpose = '' AND b.waste > 0
SETTINGS allow_introspection_functions=1
```

```sh theme={null}
clickhouse-client -q "..." | flamegraph.pl --color=mem --title="Fragmentation Flame Graph" --width 2400 > result.svg
```

<h2 id="flushing-heap-profiles">
  ヒーププロファイルをディスクにフラッシュする
</h2>

`jeprof` を使ってヒーププロファイルをファイルとして保存し、オフラインで解析したい場合は、ディスクにフラッシュできます。

デフォルトでは、ヒーププロファイルファイルは `/tmp/jemalloc_clickhouse._pid_._seqnum_.heap` に生成されます。ここで、`_pid_` は ClickHouse の PID、`_seqnum_` は現在のヒーププロファイルのグローバルなシーケンス番号です。
Keeper の場合、デフォルトのファイルは `/tmp/jemalloc_keeper._pid_._seqnum_.heap` で、同じルールに従います。

現在のプロファイルをフラッシュするには、次のようにします。

<Tabs>
  <Tab title="ClickHouse">
    ```sql theme={null}
    SYSTEM JEMALLOC FLUSH PROFILE
    ```

    フラッシュされたプロファイルの保存場所が返されます。
  </Tab>

  <Tab title="Keeper">
    ```sh theme={null}
    echo jmfp | nc localhost 9181
    ```
  </Tab>
</Tabs>

別の場所を指定するには、`MALLOC_CONF` 環境変数に `prof_prefix` オプションを追加します。
たとえば、ファイル名のプレフィックスを `my_current_profile` にして `/data` フォルダにプロファイルを生成する場合は、次の環境変数を指定して ClickHouse/Keeper を実行できます。

```sh theme={null}
MALLOC_CONF=prof_prefix:/data/my_current_profile
```

生成されるファイル名には、プレフィックス、PID、シーケンス番号が付加されます。

<h2 id="analyzing-heap-profile-files-with-jeprof">
  `jeprof` によるヒーププロファイルファイルの分析
</h2>

ヒーププロファイルをディスクにフラッシュした後は、`jemalloc` のツールである [jeprof](https://github.com/jemalloc/jemalloc/blob/dev/bin/jeprof.in) を使って分析できます。インストール方法はいくつかあります。

* システムのパッケージマネージャーを使用する
* [jemalloc リポジトリ](https://github.com/jemalloc/jemalloc) をクローンし、ルートディレクトリで `autogen.sh` を実行する。これにより、`bin` フォルダー内の `jeprof` スクリプトを利用できます

利用可能な出力フォーマットは多数あります。オプションの一覧は、`jeprof --help` を実行して確認してください。

<h3 id="symbolized-heap-profiles">
  シンボル化されたヒーププロファイル
</h3>

バージョン 26.1 以降では、`SYSTEM JEMALLOC FLUSH PROFILE` を使ってフラッシュすると、ClickHouse はシンボル化されたヒーププロファイルを自動的に生成します。
シンボル化プロファイル (`.symbolized` 拡張子) には関数シンボルが埋め込まれているため、ClickHouse バイナリがなくても `jeprof` で解析できます。

たとえば、次を実行すると:

```sql theme={null}
SYSTEM JEMALLOC FLUSH PROFILE
```

ClickHouse は、シンボル化されたプロファイルのパス (例: `/tmp/jemalloc_clickhouse.12345.0.heap.symbolized`) を返します。

続いて、`jeprof` を使って直接解析できます:

```sh theme={null}
jeprof /tmp/jemalloc_clickhouse.12345.0.heap.symbolized --output_format [ > output_file]
```

<Note>
  **バイナリは不要**: シンボル化済みプロファイル (`.symbolized` ファイル) を使用する場合、`jeprof` に ClickHouse バイナリのパスを指定する必要はありません。これにより、別のマシン上でも、あるいはバイナリ更新後でも、プロファイルの解析がはるかに容易になります。
</Note>

古い未シンボル化のヒーププロファイルがあり、なおかつ ClickHouse バイナリに引き続きアクセスできる場合は、従来の方法を使用できます。

```sh theme={null}
jeprof path/to/clickhouse path/to/heap/profile --output_format [ > output_file]
```

<Note>
  シンボル化されていないプロファイルでは、`jeprof` はスタックトレースの生成に `addr2line` を使用するため、かなり時間がかかることがあります。
  その場合は、このツールの[代替実装](https://github.com/gimli-rs/addr2line)をインストールすることをおすすめします。

  ```bash theme={null}
  git clone https://github.com/gimli-rs/addr2line.git --depth=1 --branch=0.23.0
  cd addr2line
  cargo build --features bin --release
  cp ./target/release/addr2line path/to/current/addr2line
  ```

  あるいは、`llvm-addr2line` も同様に使用できます (ただし、`llvm-objdump` は `jeprof` と互換性がない点に注意してください) 。

  以降は、次のように使用します `jeprof --tools addr2line:/usr/bin/llvm-addr2line,nm:/usr/bin/llvm-nm,objdump:/usr/bin/objdump,c++filt:/usr/bin/llvm-cxxfilt`
</Note>

2 つのプロファイルを比較する場合は、`--base` 引数を使用できます。

```sh theme={null}
jeprof --base /path/to/first.heap.symbolized /path/to/second.heap.symbolized --output_format [ > output_file]
```

<h3 id="examples">
  例
</h3>

シンボル化済みのプロファイルを使用する場合 (推奨) :

* 各プロシージャを1行に1つずつ記述したテキストファイルを生成します:

```sh theme={null}
jeprof /tmp/jemalloc_clickhouse.12345.0.heap.symbolized --text > result.txt
```

* コールグラフ付きのPDFファイルを生成します:

```sh theme={null}
jeprof /tmp/jemalloc_clickhouse.12345.0.heap.symbolized --pdf > result.pdf
```

シンボル化されていないプロファイルを使用する場合 (バイナリが必要です) :

* 各プロシージャを1行に1つずつ記述したテキストファイルを生成します:

```sh theme={null}
jeprof /path/to/clickhouse /tmp/jemalloc_clickhouse.12345.0.heap --text > result.txt
```

* コールグラフを含むPDFファイルを生成します:

```sh theme={null}
jeprof /path/to/clickhouse /tmp/jemalloc_clickhouse.12345.0.heap --pdf > result.pdf
```

<h3 id="generating-flame-graph">
  フレームグラフの生成
</h3>

`jeprof` を使うと、フレームグラフの作成に使うコラプスされたスタックを生成できます。

`--collapsed` 引数を使用する必要があります。

```sh theme={null}
jeprof /tmp/jemalloc_clickhouse.12345.0.heap.symbolized --collapsed > result.collapsed
```

または、シンボル化されていないプロファイルの場合:

```sh theme={null}
jeprof /path/to/clickhouse /tmp/jemalloc_clickhouse.12345.0.heap --collapsed > result.collapsed
```

その後、コラプスされたスタックを可視化するために、さまざまなツールを利用できます。

最も一般的なのは [FlameGraph](https://github.com/brendangregg/FlameGraph) で、`flamegraph.pl` というスクリプトが含まれています。

```sh theme={null}
cat result.collapsed | /path/to/FlameGraph/flamegraph.pl --color=mem --title="Allocation Flame Graph" --width 2400 > result.svg
```

もう 1 つの便利なツールとして、収集したスタックをよりインタラクティブに分析できる [speedscope](https://www.speedscope.app/) があります。

<h2 id="additional-options-for-profiler">
  プロファイラの追加オプション
</h2>

`jemalloc` では、プロファイラに関連するさまざまなオプションを利用できます。これらは `MALLOC_CONF` 環境変数を変更することで制御できます。
たとえば、割り当てサンプルの間隔は `lg_prof_sample` で制御できます。
heap profile を N バイトごとにダンプする場合は、`lg_prof_interval` を使用して有効にできます。

オプションの完全な一覧については、`jemalloc` の[リファレンスページ](https://jemalloc.net/jemalloc.3.html)を確認することをお勧めします。

<h2 id="other-resources">
  その他のリソース
</h2>

ClickHouse/Keeper では、`jemalloc` 関連のメトリクスがさまざまな形で公開されています。

<Warning>
  **警告**

  これらのメトリクスはいずれも互いに同期されておらず、値にずれが生じる可能性がある点に注意してください。
</Warning>

<h3 id="system-table-asynchronous_metrics">
  システムテーブル `asynchronous_metrics`
</h3>

```sql theme={null}
SELECT *
FROM system.asynchronous_metrics
WHERE metric LIKE '%jemalloc%'
FORMAT Vertical
```

[リファレンス](/ja/reference/system-tables/asynchronous_metrics)

<h3 id="system-table-jemalloc_bins">
  システムテーブル `jemalloc_bins`
</h3>

すべてのアリーナから集計した、異なるサイズクラス (ビン) ごとの jemalloc アロケータによるメモリ割り当てに関する情報を含みます。

[リファレンス](/ja/reference/system-tables/jemalloc_bins)

<h3 id="system-table-jemalloc_stats">
  システムテーブル `jemalloc_stats` (26.2+)
</h3>

`malloc_stats_print()` の出力全体を、単一の文字列として返します。`SYSTEM JEMALLOC STATS` コマンドと同等です。

```sql theme={null}
SELECT * FROM system.jemalloc_stats
```

<h3 id="prometheus">
  Prometheus
</h3>

`asynchronous_metrics` の `jemalloc` 関連のすべてのメトリクスは、ClickHouse と Keeper の両方で Prometheus エンドポイント経由でも公開されています。

[リファレンス](/ja/reference/settings/server-settings/settings/other#prometheus)

<h3 id="jmst-4lw-command-in-keeper">
  Keeper の `jmst` 4LW コマンド
</h3>

Keeper は `jmst` 4LW コマンドをサポートしており、[基本的なアロケータ統計情報](https://github.com/jemalloc/jemalloc/wiki/Use-Case%3A-Basic-Allocator-Statistics)を返します:

```sh theme={null}
echo jmst | nc localhost 9181
```