Thuum Playground

Metric Broker

A programmer's calculator for the Metric Broker: build Tags, encode values, compose and decode frames byte by byte, then publish, subscribe and query the real broker.

Group 383B Open a second window ↗ New sandbox Docs ↗

Fields: count op group id x digit y digit x y code

Type x and y the way people write them, and see the bytes the Tag's dtype puts on the wire. Docs ↗

dtype tag hex

x sns time in ns, set by the server, rounded down to the nanosecond

The server sets x when the pub arrives, rounded down to the nanosecond.

If the pub arrives at

Required.

y f32 float, 4 B

Number

on the wire (4 B, little-endian) CDCCCC3D

as read (most significant first) 3D CC CC CD

in JSON 0.10000000149011612 Docs ↗

You may write what you typed: the broker rounds it to the nearest f32, and its replies carry this.

0 sign 01111011 exponent (8 bits) 10011001100110011001101 mantissa (23 bits) = 0x3DCCCCCD

kind: normal
sign: 0 ⇒ +
exponent (8 bits): 123 − 127 ⇒ 2^-4
significand: 1 + 5033165 / 2²³ = 1.60000002384185791015625
value stored: +2^-4 × 1.60000002384185791015625 = 0.100000001490116119384765625
typed: 0.1
stored − typed: 0.000000001490116119384765625

Compose a message from ops and see it whole: count, then each op, every byte annotated. Next to it, the same message in JSON, and the size of each. Docs ↗

[0] op ack group tag sns_f32 x none: the server sets it y

address "383B:3E01" in JSON: Group and Tag in one field
[1] op ack group

bytes 14 B json 79 B bytes is 82% smaller

bytes · the binary encoding, byte by byte

0200013B38013 E0000BC41053B38

[0] pub · 9 B
count	0200	2 bytes 0–1
op	01	pub byte 2
group	3B38	14395 bytes 3–4
tag	013 E	3E01 · sns_f32 · id 1 x 3 sns y E f32 id 01 bytes 5–6
x	—	none: the server sets it
y	0000BC41	23.5 bytes 7–10
[1] sub-group · 3 B
op	05	sub-group byte 11
group	3B38	14395 bytes 12–13

json · the same message as text Docs ↗

[

{ "op": "pub", "address": "383B:3E01", "y": 23.5 },

{ "op": "sub-group", "group": "383B" }

]

[0] pub
op		pub
address	3B38013 E the same value as bytes	"383B:3E01" group 383B (14395) x 3 sns y E f32 id 01 sns_f32
x	—	none: the server sets it
y	0000BC41 the same value as bytes	23.5
[1] sub-group
op		sub-group
group	3B38 the same value as bytes	"383B" ⇄ 383B (14395)

Paste a frame, as hex, bits or JSON, and get it back field by field. A malformed frame is decoded up to its first error, which is pointed at: the byte, the field and why. Docs ↗

Frame

Read as

bytes · 14 B

0200010C00013 E0000BC41050C00

[0] pub · 9 B
count	0200	2 bytes 0–1
op	01	pub byte 2
group	0C00	12 bytes 3–4
tag	013 E	3E01 · sns_f32 · id 1 x 3 sns y E f32 id 01 bytes 5–6
x	—	none: the server sets it
y	0000BC41	23.5 bytes 7–10
[1] sub-group · 3 B
op	05	sub-group byte 11
group	0C00	12 bytes 12–13

A shared demo on Thuum's own Domain: data is kept for 24 hours, at most 1000 points per Group. Don't put anything private here. Docs ↗

Metric Broker

x sns time in ns, set by the server, rounded down to the nanosecond

y f32 float, 4 B

bytes · the binary encoding, byte by byte

json · the same message as text Docs ↗

Send ops

Send a frame by hand

Measurements received

REST

Frames