blob: 8fce490ce9a05ad5a9bf967e97d3ab3cd4898475 [file] [view]
# QUIC trace utilities
This repository contains a format for recording a trace of QUIC connection,
together with the tools for analyzing the resulting traces. This format of
traces is currently partially supported by Chromium, and we hope for more
implementations to adopt it in the future.
The primary focus of this format is debugging congestion-control related
issues, but other transport aspects (e.g. flow control) and transport-related
aspects of the application (e.g. annotations for the types of data carried by
the streams) are also within the scope.
## How to record this format
The traces are represented as a Protocol Buffer, which is completely described
in `lib/quic_trace.proto`. Projects that use Bazel can embed this repository
directly and use the provided Bazel rules.
## How to render the resulting trace
Currently, we only support a simple visualization that uses gnuplot.
1. Build the helper tool by running `bazel build
//tools/quic_trace_to_time_sequence_gnuplot`.
1. Generate the graph by running `tools/time_sequence_gnuplot.sh trace_file
trace.png`.