https://github.com/gfx/h2olog-quic-trace
Utilities to use google/quic-trace with `h2olog quic` logs
https://github.com/gfx/h2olog-quic-trace
h2o h2olog quic-trace
Last synced: 6 months ago
JSON representation
Utilities to use google/quic-trace with `h2olog quic` logs
- Host: GitHub
- URL: https://github.com/gfx/h2olog-quic-trace
- Owner: gfx
- Created: 2020-04-21T03:54:28.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2020-05-08T01:18:06.000Z (over 5 years ago)
- Last Synced: 2025-04-11T15:12:58.789Z (6 months ago)
- Topics: h2o, h2olog, quic-trace
- Language: Python
- Homepage:
- Size: 74.2 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# h2olog-quic-trace
A utility to prepare log data for `google/quic-trace`.
## Prerequisites
* Python 3.5 or later
* and its dependencies: `pip3 install -r requirements.txt`
* A BigQuery authentication file named `authn.json`
* See https://cloud.google.com/bigquery/docs/reference/libraries to setup authentication
* A BigQuery table managed by `h2olog-collector`
* See https://github.com/gfx/h2olog-collector for details
## Usage
### Fetch a specific set of logs from BigQuery
Assumed that there is a BigQuery table named `h2olog.quic`:
```console
# find by xid
$ h2olog-quic-trace 'h2olog.quic' --xid 123456 > log.jsonl
# find by quicly connection id
$ h2olog-quic-trace 'h2olog.quic' --conn 123456 > log.jsonl
```
### Transform `.jsonl` into QTR JSON files
```console
$ $QUICLY/misc/quictrace-adapter.py log.jsonl qtr
Transforming qtr/2020-04-20T13:24:49Z-250194.json
```
where `$QUICLY` is the `h2olog/quicly` repository path.
### Render a QTR JSON file
```console
$ $QUIC_TRACE/bazel-bin/tools/render/render_trace qtr/2020-04-20T13:24:49Z-250194.json
```
where `$QUIC_TRACE` is the `google/quic-trace` repository path.
Then, you'll see a QUIC trace viewer launched like this:
## See Also
* https://github.com/h2o/h2o
* https://github.com/h2o/quicly
* https://github.com/toru/h2olog
* https://github.com/gfx/h2olog-collector
* https://github.com/google/quic-trace