TSUNG-RECORDER(1)
π TSUNG-RECORDER β the proxy recorder bestie π
okay so this is the manual page for tsung-recorder, part of section 1 of the manual. it's the little sibling of tsung that literally sits there and records your sessions so you can replay them later. yes, it's giving spy but make it load testing π΅οΈβοΈβ¨
β¨ NAME β¨
tsung-recorder β the proxy recorder for the tsung load testing tool. that's it, that's the name, she's a recorder, she's a proxy, she's iconic π
π SYNOPSIS π
tsung-recorder [ -l log file ] [ -r command ] [ -p plugin ] [ -L
listen port ] [ -I IP ] [ -P port ] [ -u ] [
start|stop|restart|record_tag ]
like... she takes a bunch of flags and then one little command at the end. that's the whole vibe. no cap.
π¦ DESCRIPTION π¦
so tsung is a distributed load testing tool. it's protocol-independent, which is a fancy way of saying she does NOT pick favourites, and right now she can be used to stress and benchmark HTTP, WebDAV, LDAP, PostgreSQL, MySQL and Jabber/XMPP servers. versatile queen π
tsung-recorder can be used to record sessions β and heads up bestie, only for HTTP, WebDAV and Postgresql β that can be edited and replayed later by tsung. so you record now, you replay later, it's a whole content pipeline πΌ
tsung-recorder is a proxy that records a session in the tsung native XML format; it can be used by your favorite client (browser in the case of the http plugin). yes, your browser. just point your fave client at it and let her cook π³
here's the commands she takes, and yes each one matters:
startβ start the proxy recorder (listening port is8090). by default the HTTP recorder is started. with the-poption, you can select another plugin. the resulting files will be created as~/.tsung/tsung_recorderYYYMMDD-HH:MM.xml; and if it doesn't work, take a look at~/.tsung/log/tsung.log-tsunami_recorder@hostnameπ (yes that saystsunami_recorder, nottsung_recorder, no I'm not joking, that's literally what the manpage says, copy it exactly bestie)stopβ stop the proxy recorder. she rests π΄record_tag valueβ add a string (comment or tag) while recording a session. this is useful for example to add transaction tag while recording a session. so like, you're mid-recording and you're like "okay THIS part is the transaction" and you tag it. obsessed π·οΈ
πΈ MANUAL πΈ
a manual should be available at /usr/share/doc/tsung/user_manual.html. it is also available online at
http://tsung.erlang-projects.org/user_manual.html
like go read it, she wrote a whole book π
π OPTIONS π
-llogfile β specifies the log file to use. the default log file name is~/tsung/log/tsung.log-pplugin β specifies the plugin used for the recorder. default ishttp, available:http,pgsql,webdav-Lport β listening port for the recorder. default is8090-IIP β for thepgsqlrecorder (or parent proxy): server IP. default is127.0.0.1-Pport β for thepgsqlrecorder (or parent proxy): server port. default is5432-uβ for thehttprecorder: use a parent proxy
and yes, the synopsis up top also shows -r command, so don't come for me, I'm just telling you what the page says π
π BUGS π
found a bug? please reports bugs to the mailing list <tsung-users@process-one.net>, see
https://lists.process-one.net/mailman/listinfo/tsung-users
for archives. (yes, the original says "reports bugs", we keep it verbatim, that's the rule π«Ά)
π SEE ALSO π
erlang(3) and tsung(1). go read those too, expand your horizons bestie π§
π AUTHORS π
Tsung is written by Nicolas Niclausse <nicolas@niclux.org>. the contributors list is available in /usr/share/doc/tsung/CONTRIBUTORS. give them their flowers, they earned them π
okay that's the whole page, you're officially educated, go record something iconic β¨ this was the tsung-recorder(1) page from March 2009, and yeah, she's been slaying since 2009 and she's still not done π periodt. π
π¦ where this page comes from
- debian bookworm: tsung 1.7.0-3.1 Β· GPL-2.0-or-later
- fedora 43: tsung 1.8.0-7.fc43 Β· GPL-2.0-only
- fedora 44: tsung 1.8.0-8.fc44 Β· GPL-2.0-only
- nixos 26.05: tsung 1.8.0
- nixpkgs unstable: tsung 1.8.0
- ubuntu jammy: tsung 1.7.0-3.1 Β· GPL-2.0-or-later
- ubuntu noble: tsung 1.7.0-3.1 Β· GPL-2.0-or-later
- ubuntu questing: tsung 1.7.0-3.1
- ubuntu resolute: tsung 1.8.0-0.1 Β· GPL-2.0-or-later
- ubuntu stonking: tsung 1.8.0-0.2 Β· GPL-2.0-or-later
- π girlified by deepseek-ai/DeepSeek-V4.1-Flash on : a language model's rewrite of the original, under its terms