go/

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

Links

Open Source Insights

README ¶

Go debuglets

Go is the supported language for writing debuglets. Build a normal main package for GOOS=wasip1 GOARCH=wasm and use pkg/debuglet for network operations.

Start here

Example	What it shows
`hello-local`	Arguments and output, with no network access.
`latency`	TCP round-trip time.
`http_get`	A plaintext HTTP request.
`dns`	A DNS lookup over UDP.
`throughput`	Sending data to a TCP sink.
`listen_tcp`, `listen_udp`	Inbound listeners.

ping, send_tcp, and download need capabilities or a target that a normal local setup may not provide. They are references, not quickstarts.

Build and submit

make wasm SAMPLE_DIR=examples/debuglets/go/latency
dbl run --wasm examples/debuglets/go/latency/debuglet.wasm \
  --allow 127.0.0.1 --wait -- -addr 127.0.0.1:8080 -count 3

The debuglet can reach only destinations permitted by both the submitted policy and the executor configuration. Write progress to standard output: it becomes the measurement log.

See Write a debuglet for the SDK and runtime model, and the shared examples guide for language support.

Directories ¶

Path	Synopsis
demo
dns dns — DNS A lookup over UDP, written with the Debuglet Go SDK.	dns — DNS A lookup over UDP, written with the Debuglet Go SDK.
download
hello-local
helloworld Minimal "hello world" debuglet in Go.	Minimal "hello world" debuglet in Go.
http_get http_get — plaintext HTTP/1.0 request, written with the Debuglet Go SDK.	http_get — plaintext HTTP/1.0 request, written with the Debuglet Go SDK.
latency latency — TCP round-trip latency, written with the Debuglet Go SDK.	latency — TCP round-trip latency, written with the Debuglet Go SDK.
evaluation command latency measures nonce-matched UDP echoes.	latency measures nonce-matched UDP echoes.
listen_tcp listen_tcp — inbound TCP echo server, written with the Debuglet Go SDK.	listen_tcp — inbound TCP echo server, written with the Debuglet Go SDK.
listen_udp listen_udp — inbound UDP receiver, written with the Debuglet Go SDK.	listen_udp — inbound UDP receiver, written with the Debuglet Go SDK.
loop
ping ping — ICMPv4 latency probe, written with the Debuglet Go SDK.	ping — ICMPv4 latency probe, written with the Debuglet Go SDK.
send_tcp send_tcp — one TCP request over the raw host imports.	send_tcp — one TCP request over the raw host imports.
send_udp send_udp — UDP sender, written with the Debuglet Go SDK.	send_udp — UDP sender, written with the Debuglet Go SDK.
throughput throughput — TCP throughput sender, written with the Debuglet Go SDK.	throughput — TCP throughput sender, written with the Debuglet Go SDK.

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL