11// utils.py
22
33import gc
44import time
55
66from opentelemetry import metrics
77
88
99def collect_gc_metrics():
1010    meter = metrics.get_meter("monitor", "1.0.0")
1111
1212    gc_duration = meter.create_counter(
1313        name="process.runtime.cpython.gc.duration",
1414        description="Runtime cpython GC duration per generation",
1515        unit="s",
1616    )
1717    gc_counter = meter.create_counter(
1818        name="process.runtime.cpython.gc.collections",
1919        description="Number of GC collections per generation",
2020    )
2121
2222    gc_start_times = {}
2323
2424    def gc_callback(phase, info):
2525        gen = info.get("generation")
2626        if phase == "start":
2727            gc_start_times[gen] = time.perf_counter()
2828        elif phase == "stop":
2929            start = gc_start_times.pop(gen, None)
3030            gc_counter.add(1, attributes={"count": gen})
3131            if start is not None:
3232                duration = time.perf_counter() - start
3333                gc_duration.add(duration, attributes={"count": gen})
3434
3535    gc.callbacks.append(gc_callback)