main
ply4 git calls208 ms43 KiB2 cachedprotocol v2
53 lines3.2 KiBRaw
1// The input distributions calibration reads (issue #73), per /v1 route. Each name is a numeric attribute ply records on
2// a span of that route (ply's own span contract), which src/edge-trace.ts mirrors onto Workers tracing with the route
3// (`ply.route`) and Workers version (`ply.script_version`) stamped beside it. test/worker-spans.test.js drives every
4// route under workerd and asserts each listed attribute reaches Workers tracing as a number, so this table is a floor
5// the telemetry is known to carry, not a wish list. scripts/calibrate reports every numeric attribute it sees; these
6// are the ones a threshold in scripts/calibrate/thresholds.json may name.
7import type { ApiRoute } from '../../src/api-routes.ts'
9/** Wire spans of every route that talks to the remote: how many bytes came back. */
10const WIRE = ['git.response.bytes'] as const
11/** Routes that list refs first. */
12const REFS = ['git.ls_refs.count'] as const
13/** Routes that fetch a pack. */
14const PACK = ['git.pack.bytes', 'git.pack.objects', 'git.pack.inflated.bytes'] as const
15/** Routes that push. */
16const PUSH = ['git.push.pack.bytes', 'git.push.pack.objects'] as const
18export const ROUTE_INPUTS: Readonly<Record<ApiRoute, readonly string[]>> = {
19 'GET /v1/refs': [...WIRE, ...REFS],
20 'GET /v1/discover': [...WIRE],
21 'GET /v1/tree': [...WIRE, ...REFS, ...PACK, 'git.ls_tree.entries', 'git.ls_tree.path.depth'],
22 'GET /v1/commit': [...WIRE, ...REFS, ...PACK, 'git.read_commit.parents'],
23 'GET /v1/read': [...WIRE, ...REFS, ...PACK, 'git.read.blob.bytes', 'git.read.blob.size', 'git.read.path.depth', 'git.read.tree.entries', 'git.read.tree.depth'],
24 'POST /v1/edit': [...WIRE, ...REFS, ...PACK, ...PUSH, 'git.edit.tree.entries', 'git.edit.tree.depth', 'git.edit.path.depth', 'git.edit.blob.delta.bytes', 'git.edit.blob.new_len'],
25 'POST /v1/branch': [...WIRE, ...REFS, ...PUSH],
26 'DELETE /v1/branch': [...WIRE, ...REFS, ...PUSH],
27 'POST /v1/tag': [...WIRE, ...REFS, ...PUSH],
28 'DELETE /v1/tag': [...WIRE, ...REFS, ...PUSH],
29 'POST /v1/merge': [...WIRE, ...REFS, ...PACK, ...PUSH, 'git.pack.chain.max', 'git.merge.base.depth', 'git.merge.conflicts.count'],
30 'POST /v1/rebase': [...WIRE, ...REFS, ...PACK, ...PUSH, 'git.pack.chain.max', 'git.rebase.commits'],
31 'POST /v1/cherry-pick': [...WIRE, ...REFS, ...PACK, ...PUSH],
32 'POST /v1/revert': [...WIRE, ...REFS, ...PACK, ...PUSH],
35/** Numeric attributes on the request span of every /v1 request (src/edge-trace.ts REQUEST_ATTR). */
36export const REQUEST_INPUTS = ['ply.spans', 'ply.round_trips', 'ply.wide_fetches', 'ply.cache_hits'] as const
38/**
39 * String-valued attributes counted per value rather than as a distribution: the error taxonomy and cache status.
40 * `error.type`/`error.kind` are ply's (otel.ts); the `ply.error.*` pair is the request span's.
41 */
42export const CATEGORICAL = [
43 'error.type',
44 'error.kind',
45 'ply.error.code',
46 'ply.error.kind',
47 'git.response.cache',
48 'git.pack.cache',
49 'http.response.status_code',
50] as const
52/** Numeric attributes that are identifiers, protocol constants, or echoed configuration, not an input distribution. */
53export const NOT_INPUTS: readonly string[] = ['git.protocol.version', 'git.limits.request_timeout_ms', 'git.pack.version', 'ply.duration_ms', 'http.response.status_code']
Diagnostics4 git calls · 208 ms
CallStatusSizeTime0208 ms
discover200152 B3 ms
git.upload-pack discover
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=ls-refs
git.upstream.dur_ms=3
git.response.bytes=152
git.server.agent=gitty/1.0
git.server.object_format=sha1
git.server.caps=agent ls-refs fetch object-format
git.server.fetch=shallow filter sideband-all
git.protocol.version=2
git.pkt.frames=8
git.pkt.data=6
git.pkt.flush=2
git.pkt.delim=0
git.pkt.bytes=152
git.pkt.payload.max=34
ls-refs200145 B · hit3 ms
git.upload-pack ls-refs
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=ls-refs
git.upstream.dur_ms=3
git.response.bytes=145
git.response.cache=HIT
git.response.duration_ms=3
git.protocol.version=2
git.pkt.frames=3
git.pkt.data=2
git.pkt.flush=1
git.pkt.delim=0
git.pkt.bytes=145
git.pkt.payload.max=76
git.ls_refs.count=2
git.ls_refs.head=refs/heads/main
fetchblob:none · deepen 1020042 KiB · hit3 ms
git.upload-pack fetch
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=3
git.response.bytes=42585
git.response.cache=HIT
git.response.duration_ms=3
git.fetch.filter=blob:none
git.fetch.filter.requested=tree:0
git.fetch.filter.fallback=blob:none
git.fetch.filter.learned=false
git.fetch.wants=262b639aa1b258fc1777c3a66ba8f811df3a3da2
git.fetch.haves.count=0
git.fetch.deepen=10
git.fetch.thin_pack=false
git.fetch.ofs_delta=true
git.protocol.version=2
git.pkt.frames=6
git.pkt.data=4
git.pkt.flush=1
git.pkt.delim=1
git.pkt.bytes=42585
git.pkt.payload.max=42490
git.sideband.band1.bytes=42489
git.sideband.band2.bytes=0
git.sideband.band3.bytes=0
git.pack.objects=61
git.pack.bytes=42489
git.pack.ofs_delta=0
git.pack.ref_delta=0
git.pack.chain.max=0
git.pack.trailer=7dbf576d97429022615f79aa46b440d9da603496
git.pack.full=61
Open pack map
fetch2001.3 KiB202 ms
git.upload-pack fetch
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=202
git.response.bytes=1292
git.response.cache=MISS
git.response.duration_ms=202
git.fetch.wants=183fe2d6756e78a39981da9705404b7a006ed31e
git.fetch.haves.count=0
git.fetch.deepen=0
git.fetch.thin_pack=false
git.fetch.ofs_delta=true
git.protocol.version=2
git.pkt.frames=3
git.pkt.data=2
git.pkt.flush=1
git.pkt.delim=0
git.pkt.bytes=1292
git.pkt.payload.max=1271
git.sideband.band1.bytes=1270
git.sideband.band2.bytes=0
git.sideband.band3.bytes=0

Each row is one HTTP round trip ply made to the git server for this page, on one timeline. discover asks what the server speaks, ls-refs lists branch tips, fetch brings objects by id. A hit was served by Workers Cache. Tap a row for its wire details.

Remote
https://5ad2236b39de4c8bd8f6270ea63f3ea9.artifacts.cloudflare.net/git/public-v0/ply-web.git
Ref
refs/heads/main
Commit
262b639aa1b258fc1777c3a66ba8f811df3a3da2
cf-ray
a5e1e29bbcb3d96e
Request
4f53accc…
Protocol
v2 · sha1
Agent
gitty/1.0
Filter
advertised
Fetch
shallow filter sideband-all
Capabilities
agent ls-refs fetch object-format