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

> Función de agregación que crea un flamegraph a partir de una lista de stacktraces.

# flameGraph

<div id="flameGraph">
  ## flameGraph
</div>

Introducido en: v23.8.0

Crea un [flamegraph](https://www.brendangregg.com/flamegraphs.html) a partir de la lista de stacktraces.
Devuelve un array de cadenas que puede usarse con la utilidad [flamegraph.pl](https://github.com/brendangregg/FlameGraph) para generar un SVG del flamegraph.

<Note>
  Cuando `ptr != 0`, flameGraph asociará asignaciones (size > 0) y desasignaciones (size \< 0) que tengan el mismo tamaño y ptr.
  Solo se muestran las asignaciones que no se liberaron.
  Las desasignaciones no asociadas se ignoran.
</Note>

**Sintaxis**

```sql theme={null}
flameGraph(traces[, size[, ptr]])
```

**Argumentos**

* `traces` — Un stacktrace, ya sea como direcciones sin procesar o como cadenas ya simbolizadas (p. ej., `arrayMap(addressToSymbol, trace)`). [`Array(UInt64)`](/es/reference/data-types/array) o [`Array(String)`](/es/reference/data-types/array)
* `size` — Opcional. Un tamaño de asignación para el perfilado de memoria (valor predeterminado: 1). [`UInt64`](/es/reference/data-types/int-uint)
* `ptr` — Opcional. Una dirección de asignación (valor predeterminado: 0). [`UInt64`](/es/reference/data-types/int-uint)

**Valor devuelto**

Devuelve un array de cadenas para usarlo con la utilidad flamegraph.pl. [`Array(String)`](/es/reference/data-types/array)

**Ejemplos**

**Creación de un flamegraph a partir de un perfilador de consultas de CPU**

```sql title=Query theme={null}
SET query_profiler_cpu_time_period_ns=10000000;
SELECT SearchPhrase, COUNT(DISTINCT UserID) AS u FROM hits WHERE SearchPhrase <> '' GROUP BY SearchPhrase ORDER BY u DESC LIMIT 10;
```

```response title=Response theme={null}
clickhouse client --allow_introspection_functions=1 -q "select arrayJoin(flameGraph(arrayReverse(trace))) from system.trace_log where trace_type = 'CPU' and query_id = 'xxx'" | ~/dev/FlameGraph/flamegraph.pl  > flame_cpu.svg
```

**Creación de un flamegraph basado en un perfilador de consultas de memoria, que muestra todas las asignaciones de memoria**

```sql title=Query theme={null}
SET memory_profiler_sample_probability=1, max_untracked_memory=1;
SELECT SearchPhrase, COUNT(DISTINCT UserID) AS u FROM hits WHERE SearchPhrase <> '' GROUP BY SearchPhrase ORDER BY u DESC LIMIT 10;
```

```response title=Response theme={null}
clickhouse client --allow_introspection_functions=1 -q "select arrayJoin(flameGraph(trace, size)) from system.trace_log where trace_type = 'MemorySample' and query_id = 'xxx'" | ~/dev/FlameGraph/flamegraph.pl --countname=bytes --color=mem > flame_mem.svg
```

**Construcción de un flamegraph a partir de un perfilador de consultas de memoria, que muestra asignaciones de memoria que no se liberaron**

```sql title=Query theme={null}
SET memory_profiler_sample_probability=1, max_untracked_memory=1, use_uncompressed_cache=1, merge_tree_max_rows_to_use_cache=100000000000, merge_tree_max_bytes_to_use_cache=1000000000000;
SELECT SearchPhrase, COUNT(DISTINCT UserID) AS u FROM hits WHERE SearchPhrase <> '' GROUP BY SearchPhrase ORDER BY u DESC LIMIT 10;
```

```response title=Response theme={null}
clickhouse client --allow_introspection_functions=1 -q "SELECT arrayJoin(flameGraph(trace, size, ptr)) FROM system.trace_log WHERE trace_type = 'MemorySample' AND query_id = 'xxx'" | ~/dev/FlameGraph/flamegraph.pl --countname=bytes --color=mem > flame_mem_untracked.svg
```

**Cree un flamegraph basado en el perfilador de consultas de memoria que muestre las asignaciones activas en un momento dado**

```sql title=Query theme={null}
SET memory_profiler_sample_probability=1, max_untracked_memory=1;
SELECT SearchPhrase, COUNT(DISTINCT UserID) AS u FROM hits WHERE SearchPhrase <> '' GROUP BY SearchPhrase ORDER BY u DESC LIMIT 10;

-- 1. Uso de memoria por segundo
SELECT event_time, m, formatReadableSize(max(s) AS m) FROM (SELECT event_time, sum(size) OVER (ORDER BY event_time) AS s FROM system.trace_log WHERE query_id = 'xxx' AND trace_type = 'MemorySample') GROUP BY event_time ORDER BY event_time;

-- 2. Encontrar un punto en el tiempo con el uso máximo de memoria
SELECT argMax(event_time, s), max(s) FROM (SELECT event_time, sum(size) OVER (ORDER BY event_time) AS s FROM system.trace_log WHERE query_id = 'xxx' AND trace_type = 'MemorySample');
```

```response title=Response theme={null}
-- 3. Fijar asignaciones activas en un punto fijo en el tiempo
clickhouse client --allow_introspection_functions=1 -q "SELECT arrayJoin(flameGraph(trace, size, ptr)) FROM (SELECT * FROM system.trace_log WHERE trace_type = 'MemorySample' AND query_id = 'xxx' AND event_time <= 'yyy' ORDER BY event_time\)\" | ~/dev/FlameGraph/flamegraph.pl --countname=bytes --color=mem > flame_mem_time_point_pos.svg

-- 4. Encontrar desasignaciones en un punto fijo en el tiempo
clickhouse client --allow_introspection_functions=1 -q "SELECT arrayJoin(flameGraph(trace, -size, ptr)) FROM (SELECT * FROM system.trace_log WHERE trace_type = 'MemorySample' AND query_id = 'xxx' AND event_time > 'yyy' ORDER BY event_time desc\)\" | ~/dev/FlameGraph/flamegraph.pl --countname=bytes --color=mem > flame_mem_time_point_neg.svg
```