jijpresolve.trace
=================

.. py:module:: jijpresolve.trace

.. autoapi-nested-parse::

   Chrome Trace Event Format utilities for OpenTelemetry spans.



Classes
-------

.. autoapisummary::

   jijpresolve.trace.ChromeTraceExporter


Functions
---------

.. autoapisummary::

   jijpresolve.trace.spans_to_chrome_trace


Module Contents
---------------

.. py:function:: spans_to_chrome_trace(spans: list[opentelemetry.sdk.trace.ReadableSpan]) -> dict[str, Any]

   Convert OpenTelemetry spans to Chrome Trace Event Format.

   The output can be viewed with:
   - Perfetto: https://ui.perfetto.dev/
   - speedscope: https://www.speedscope.app/
   - Chrome DevTools: chrome://tracing


.. py:class:: ChromeTraceExporter(output_path: pathlib.Path)

   Bases: :py:obj:`opentelemetry.sdk.trace.export.SpanExporter`


   SpanExporter that outputs spans in Chrome Trace Event Format.

   The output can be viewed with:
   - Perfetto: https://ui.perfetto.dev/
   - speedscope: https://www.speedscope.app/
   - Chrome DevTools: chrome://tracing


   .. py:attribute:: output_path


   .. py:attribute:: spans
      :type:  list[opentelemetry.sdk.trace.ReadableSpan]
      :value: []



   .. py:method:: export(spans: Sequence[opentelemetry.sdk.trace.ReadableSpan]) -> opentelemetry.sdk.trace.export.SpanExportResult

      Collect spans for later export.



   .. py:method:: shutdown() -> None

      Write collected spans to the output file.



   .. py:method:: force_flush(timeout_millis: int = 30000) -> bool

      Force flush is a no-op for this exporter.