Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
tree: 3c5d4c306d
Fetching contributors…

Cannot retrieve contributors at this time

file 156 lines (145 sloc) 5.365 kb
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156
<!doctype refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN">
<refentry>
  <refentryinfo>
    <address>
      <email>nicolas.niclausse@niclux.org</email>
    </address>
    <author>
      <firstname>Nicolas</firstname>
      <surname>Niclausse</surname>
    </author>
    <date>March 2009</date>
    <copyright>
      <year>2009</year>
      <holder>Nicolas Niclausse</holder>
    </copyright>
  </refentryinfo>

  <refmeta>
    <refentrytitle>tsung-recorder</refentrytitle>
    <manvolnum>1</manvolnum>
  </refmeta>

  <refnamediv>
    <refname>tsung-recorder</refname>
    <refpurpose>
Proxy recorder for the tsung load testing tool.
    </refpurpose>
  </refnamediv>

  <refsynopsisdiv>
    <cmdsynopsis>
      <command>tsung-recorder</command>
      <arg><option>-l</option> log file</arg>
      <arg><option>-r</option> command</arg>
      <arg><option>-p</option> plugin</arg>
      <arg><option>-L</option> listen port</arg>
      <arg><option>-I</option> IP</arg>
      <arg><option>-P</option> port</arg>
      <arg><option>-u</option> </arg>
      <arg>start|stop|restart|record_tag</arg>
    </cmdsynopsis>
  </refsynopsisdiv>

  <refsect1>
    <title>description</title>
    <para>
      <command>tsung</command> is a distributed load testing
      tool. It is protocol-independent and can currently be used to
      stress and benchmark HTTP, WebDAV, LDAP, PostgreSQL, MySQL and
      Jabber/XMPP servers. <command>tsung-recorder</command> can be
      used to record sessions (only for HTTP, WebDAV and Postgresql) that can be edited and replayed later by tsung</para>

    <para> 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). </para>

    <variablelist>
       <varlistentry>
        <term><option>start</option></term>
        <listitem>
          <para>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 <filename>~/.tsung/tsung_recorderYYYMMDD-HH:MM.xml</filename>; if it doesn't work, take a look at <filename>~/.tsung/log/tsung.log-tsunami_recorder@hostname</filename> </para>
        </listitem>
      </varlistentry>
       <varlistentry>
        <term><option>stop</option></term>
        <listitem>
          <para>stop the proxy recorder</para>
        </listitem>
       </varlistentry>
       <varlistentry>
        <term><option>record_tag</option> value</term>
        <listitem>
          <para>add a string (comment or tag) while recording a
          session. This is useful for example to add transaction tag
          while recording a session. </para>
        </listitem>
      </varlistentry>
    </variablelist>

  </refsect1>
  <refsect1>
    <title>manual</title> <para>A manual should be available at
    <filename>/usr/share/doc/tsung/user_manual.html</filename>. It
    is also available online at
    <address>http://tsung.erlang-projects.org/user_manual.html</address>
    </para>
  </refsect1>

  <refsect1>
    <title>options</title>
    <variablelist>
      <varlistentry>
        <term><option>-l logfile</option></term>
        <listitem>
          <para>Specifies the log file to use. The default log file name is <filename>~/tsung/log/tsung.log</filename></para>
        </listitem>
      </varlistentry>
      <varlistentry>
      <term><option>-p plugin</option></term>
      <listitem>
        <para> Specifies the plugin used for the recorder. Default is
        http, available: http, pgsql, webdav</para>
      </listitem>
    </varlistentry>
      <varlistentry>
      <term><option>-L port</option></term>
      <listitem>
        <para> Listening port for the recorder. Default is 8090</para>
      </listitem>
    </varlistentry>
      <varlistentry>
      <term><option>-I IP</option></term>
      <listitem>
        <para> For the pgsql recorder (or parent proxy): server IP. default is 127.0.0.1 </para>
      </listitem>
    </varlistentry>
      <varlistentry>
      <term><option>-P port</option></term>
      <listitem>
        <para> For the pgsql recorder (or parent proxy): server port. Default is 5432</para>
      </listitem>
    </varlistentry>
      <varlistentry>
      <term><option>-u</option></term>
      <listitem>
        <para> For the http recorder: use a parent proxy</para>
      </listitem>
    </varlistentry>
  </variablelist>
  </refsect1>

  <refsect1>
    <title>Bugs</title> <para> Please reports bugs to the mailing list
    <email>tsung-users@process-one.net</email>, see
    <address>https://lists.process-one.net/mailman/listinfo/tsung-users</address> for
    archives.
    </para>
  </refsect1>

  <refsect1>
    <title>see also</title>
    <para>
    <citerefentry><refentrytitle>erlang</refentrytitle><manvolnum>3</manvolnum></citerefentry>
 and <citerefentry><refentrytitle>tsung</refentrytitle><manvolnum>1</manvolnum></citerefentry>
    </para>
  </refsect1>

  <refsect1>
    <title>Authors</title>
    <para>
        <command>Tsung</command> is written by <author><firstname>Nicolas</firstname> <surname>Niclausse</surname></author>
      <email>nicolas@niclux.org</email>. Contributors list
      is available in
      <filename>/usr/share/doc/tsung/CONTRIBUTORS</filename>
</para>
  </refsect1>
</refentry>
Something went wrong with that request. Please try again.