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 is 8090). by default the HTTP recorder is started. with the -p option, 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 says tsunami_recorder, not tsung_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 πŸ‘‘

  • -l logfile β€” specifies the log file to use. the default log file name is ~/tsung/log/tsung.log
  • -p plugin β€” specifies the plugin used for the recorder. default is http, available: http, pgsql, webdav
  • -L port β€” listening port for the recorder. default is 8090
  • -I IP β€” for the pgsql recorder (or parent proxy): server IP. default is 127.0.0.1
  • -P port β€” for the pgsql recorder (or parent proxy): server port. default is 5432
  • -u β€” for the http recorder: 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. πŸ’–