ocaml-catapult/test/ at main · gazagnaire.org/ocaml-catapult · Tangled

gazagnaire.org / ocaml-catapult

0

Trace Event Format summary CLI

0

ocaml-catapult / test

2 folders 16 files

at main

Thomas Gazagnaire catapult: expose equality on event identifiers 9d ago

catapult: expose equality on event identifiers A trace event id is a number or a string, and the sample-frame test compared two of them with the polymorphic (=). Publish equal_id so the comparison lives with the type: a number and a string are never equal, even when the string spells the number.

1 week ago

docs: reflow comments across the tree

1 month ago

catapult: add a Protocol Buffers trace codec A binary encoding of the same Trace.t as the JSON codec: the typed event members are native protobuf fields and the open-ended args/extra/metadata are carried as their JSON text, so a trace round-trips unchanged while decoding without the JSON tokenizer -- markedly cheaper to read and write. Adds the Pb codec and a streaming Pb_writer, wires protobuf in and out through the summary CLI, with its own tests and a bench against the JSON path.

1 month ago

catapult: add a Protocol Buffers trace codec A binary encoding of the same Trace.t as the JSON codec: the typed event members are native protobuf fields and the open-ended args/extra/metadata are carried as their JSON text, so a trace round-trips unchanged while decoding without the JSON tokenizer -- markedly cheaper to read and write. Adds the Pb codec and a streaming Pb_writer, wires protobuf in and out through the summary CLI, with its own tests and a bench against the JSON path.

1 month ago

test_catapult.ml

catapult: expose equality on event identifiers A trace event id is a number or a string, and the sample-frame test compared two of them with the polymorphic (=). Publish equal_id so the comparison lives with the type: a number and a string are never equal, even when the string spells the number.

1 week ago

test_catapult.mli

catapult: new nox-catapult package for the Trace Event Format Typed values and nox-json codecs for the JSON trace format consumed by chrome://tracing, Perfetto and the Catapult tools: - Phase: the ph character enumeration; unknown phases decode to Other and round-trip verbatim, the legacy instant 'I' normalizes to 'i'. - Event: a flat record of the common members (name, cat, ts, pid, tid, dur, args, id, ...); members the library does not type are kept in source order in an extra field and round-trip unchanged. Helpers cover the common producer shapes (complete, instant, counter, process_name, thread_name). - Catapult.t: a whole trace in either container format. Decoding accepts both; encoding picks the array format when the trace is events-only and the object format otherwise (stack frames, samples, displayTimeUnit, free-form metadata). - of_string repairs the crash-tolerant array tail the spec allows (missing ']', trailing comma); Writer streams events one at a time so producers get that property for free. No existing package covers this: the opam catapult and trace-tef libraries are runtime tracing clients that emit the format with hand-rolled printf JSON and provide no decoder; both are credited in the README. Tests use the spec's examples as vectors; alcobar fuzz covers decode totality and roundtrips; README and mli examples are mdx-checked.

1 month ago

*: relicense author-original packages MIT -> ISC Standardise on ISC (matching irmin and mirage, and the repo majority): flip (license MIT) to (license ISC) in each dune-project, regenerate the opam files, swap LICENSE.md to the ISC text, and update the SPDX-License-Identifier headers. memtrace and ocaml-xdg keep their license: they are vendored Jane Street code, not ours to relicense.

1 month ago

catapult: new nox-catapult package for the Trace Event Format Typed values and nox-json codecs for the JSON trace format consumed by chrome://tracing, Perfetto and the Catapult tools: - Phase: the ph character enumeration; unknown phases decode to Other and round-trip verbatim, the legacy instant 'I' normalizes to 'i'. - Event: a flat record of the common members (name, cat, ts, pid, tid, dur, args, id, ...); members the library does not type are kept in source order in an extra field and round-trip unchanged. Helpers cover the common producer shapes (complete, instant, counter, process_name, thread_name). - Catapult.t: a whole trace in either container format. Decoding accepts both; encoding picks the array format when the trace is events-only and the object format otherwise (stack frames, samples, displayTimeUnit, free-form metadata). - of_string repairs the crash-tolerant array tail the spec allows (missing ']', trailing comma); Writer streams events one at a time so producers get that property for free. No existing package covers this: the opam catapult and trace-tef libraries are runtime tracing clients that emit the format with hand-rolled printf JSON and provide no decoder; both are credited in the README. Tests use the spec's examples as vectors; alcobar fuzz covers decode totality and roundtrips; README and mli examples are mdx-checked.

1 month ago

catapult: fold protobuf events into the summary aggregator summary decoded a protobuf trace into a full trace and its event list before aggregating; fold the events straight off the wire instead, one at a time into the aggregator, so a large trace never lands in memory as a list. Tail-tolerant like the array path.

1 month ago

catapult: add a Protocol Buffers trace codec A binary encoding of the same Trace.t as the JSON codec: the typed event members are native protobuf fields and the open-ended args/extra/metadata are carried as their JSON text, so a trace round-trips unchanged while decoding without the JSON tokenizer -- markedly cheaper to read and write. Adds the Pb codec and a streaming Pb_writer, wires protobuf in and out through the summary CLI, with its own tests and a bench against the JSON path.

1 month ago

*: relicense author-original packages MIT -> ISC Standardise on ISC (matching irmin and mirage, and the repo majority): flip (license MIT) to (license ISC) in each dune-project, regenerate the opam files, swap LICENSE.md to the ISC text, and update the SPDX-License-Identifier headers. memtrace and ocaml-xdg keep their license: they are vendored Jane Street code, not ours to relicense.

1 month ago

catapult: new nox-catapult package for the Trace Event Format Typed values and nox-json codecs for the JSON trace format consumed by chrome://tracing, Perfetto and the Catapult tools: - Phase: the ph character enumeration; unknown phases decode to Other and round-trip verbatim, the legacy instant 'I' normalizes to 'i'. - Event: a flat record of the common members (name, cat, ts, pid, tid, dur, args, id, ...); members the library does not type are kept in source order in an extra field and round-trip unchanged. Helpers cover the common producer shapes (complete, instant, counter, process_name, thread_name). - Catapult.t: a whole trace in either container format. Decoding accepts both; encoding picks the array format when the trace is events-only and the object format otherwise (stack frames, samples, displayTimeUnit, free-form metadata). - of_string repairs the crash-tolerant array tail the spec allows (missing ']', trailing comma); Writer streams events one at a time so producers get that property for free. No existing package covers this: the opam catapult and trace-tef libraries are runtime tracing clients that emit the format with hand-rolled printf JSON and provide no decoder; both are credited in the README. Tests use the spec's examples as vectors; alcobar fuzz covers decode totality and roundtrips; README and mli examples are mdx-checked.

1 month ago

docs: reflow comments across the tree

1 month ago

catapult: Slice pairing, and a summary CLI for traces Catapult.Slice pairs the events of a trace into the intervals a viewer draws: complete events carry their duration, duration events pair as a per-thread stack, nestable async events pair by identifier across interleavings, and a begin without an end (a crashed producer) surfaces as an unterminated slice rather than disappearing. The Perfetto interop test now derives its expected slices from Slice.of_trace, so the reference consumer's slice table validates the pairing semantics directly. The new catapult binary closes the tooling gap found while profiling merlint: captures could be recorded and opened in Perfetto, but there was no way to summarize one from the terminal. catapult summary prints a span tree with hdr-histogram latency quantiles (p50/p99/max per name), nesting derived from interval containment and from ocaml-probe parent args; counter min/mean/max tables; instant-event counts; and capture-health warnings for ring drops and decode errors. Output is cram-tested; styling follows the formatter's style renderer so piped output is plain.

1 month ago

docs: reflow comments across the tree

1 month ago

catapult: new nox-catapult package for the Trace Event Format Typed values and nox-json codecs for the JSON trace format consumed by chrome://tracing, Perfetto and the Catapult tools: - Phase: the ph character enumeration; unknown phases decode to Other and round-trip verbatim, the legacy instant 'I' normalizes to 'i'. - Event: a flat record of the common members (name, cat, ts, pid, tid, dur, args, id, ...); members the library does not type are kept in source order in an extra field and round-trip unchanged. Helpers cover the common producer shapes (complete, instant, counter, process_name, thread_name). - Catapult.t: a whole trace in either container format. Decoding accepts both; encoding picks the array format when the trace is events-only and the object format otherwise (stack frames, samples, displayTimeUnit, free-form metadata). - of_string repairs the crash-tolerant array tail the spec allows (missing ']', trailing comma); Writer streams events one at a time so producers get that property for free. No existing package covers this: the opam catapult and trace-tef libraries are runtime tracing clients that emit the format with hand-rolled printf JSON and provide no decoder; both are credited in the README. Tests use the spec's examples as vectors; alcobar fuzz covers decode totality and roundtrips; README and mli examples are mdx-checked.

1 month ago

docs: reflow comments across the tree

1 month ago

test_writer.mli

catapult: new nox-catapult package for the Trace Event Format Typed values and nox-json codecs for the JSON trace format consumed by chrome://tracing, Perfetto and the Catapult tools: - Phase: the ph character enumeration; unknown phases decode to Other and round-trip verbatim, the legacy instant 'I' normalizes to 'i'. - Event: a flat record of the common members (name, cat, ts, pid, tid, dur, args, id, ...); members the library does not type are kept in source order in an extra field and round-trip unchanged. Helpers cover the common producer shapes (complete, instant, counter, process_name, thread_name). - Catapult.t: a whole trace in either container format. Decoding accepts both; encoding picks the array format when the trace is events-only and the object format otherwise (stack frames, samples, displayTimeUnit, free-form metadata). - of_string repairs the crash-tolerant array tail the spec allows (missing ']', trailing comma); Writer streams events one at a time so producers get that property for free. No existing package covers this: the opam catapult and trace-tef libraries are runtime tracing clients that emit the format with hand-rolled printf JSON and provide no decoder; both are credited in the README. Tests use the spec's examples as vectors; alcobar fuzz covers decode totality and roundtrips; README and mli examples are mdx-checked.

1 month ago