From 84cf91d7ab5b8738cc851aae11c39a55081a6b62 Mon Sep 17 00:00:00 2001 From: Timur Torubarov Date: Wed, 17 Feb 2016 15:57:35 +0300 Subject: [PATCH] documentation update --- docs/.configuration.rst.swp | Bin 0 -> 57344 bytes docs/configuration.rst | 4 +++- docs/tutorial.rst | 15 ++++++++++++++- 3 files changed, 17 insertions(+), 2 deletions(-) create mode 100644 docs/.configuration.rst.swp diff --git a/docs/.configuration.rst.swp b/docs/.configuration.rst.swp new file mode 100644 index 0000000000000000000000000000000000000000..196a15298830de96567520bd92815bde751c6a10 GIT binary patch literal 57344 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 literal 0 HcmV?d00001 diff --git a/docs/configuration.rst b/docs/configuration.rst index e7e776b..e9a28d6 100644 --- a/docs/configuration.rst +++ b/docs/configuration.rst @@ -7,7 +7,9 @@ Command line options Yandex.Tank has an obviously named executable ``yandex-tank``. Here are available command line options: -- **-h, --help** - show command line options +*-h, --help* + show command line options + - **-c CONFIG, --config=CONFIG** - read options from INI file. It is possible to set multiple INI files by specifying the option serveral times. Default: ``./load.ini`` - **-i, --ignore-lock** - ignore lock files - **-f, --fail-lock** - don't wait for lock file, quit if it's busy. The default behaviour is to wait for lock file to become free. diff --git a/docs/tutorial.rst b/docs/tutorial.rst index 239ff19..69c4de9 100644 --- a/docs/tutorial.rst +++ b/docs/tutorial.rst @@ -4,6 +4,8 @@ Usage So, you've installed Yandex.Tank to a proper machine, it is close to target, access is permitted and server is tuned. How to make a test? +Note + This guide is for ``phantom`` load generator. First Steps @@ -79,6 +81,8 @@ large files will be readed from stream. address=203.0.113.1 ; Target's address ammofile=https://yourhost.tld/path/to/ammofile.txt +Note + If ammo type is uri-style or request-style, tank will try to guess it. Use ``ammo_type`` option to explicitly specify ammo format. Don't forget to change ``ammo_type`` option @@ -125,6 +129,9 @@ Update configuration file with HTTP headers and URIs: /sdfbv/swdfvs/ssfsf Parameter ``uris`` contains uri, which should be used for requests generation. + +Note + Pay attention to sample above, because whitespaces in ``uris`` and ``headers`` options are important. URI-style, URIs in file @@ -199,6 +206,8 @@ where ``size_of_request`` – request size in bytes. '\r\n' symbols after include them in a file after each request. Pay attention to the sample above because '\r' symbols are strictly required. +Note + Parameter ``ammo_type`` is unnecessary, request-style is default ammo type. **sample GET requests (null body)** @@ -465,7 +474,9 @@ HTTP and Net codes conditions There is an option to define specific codes (404,503,100) as well as code groups (3xx, 5xx, xx). Also you can define relative threshold (percent from the whole amount of answer per second) or absolute (amount of -answers with specified code per second). Examples: +answers with specified code per second). + +Examples: * ``autostop = http(4xx,25%,10)`` – stop test, if amount of 4xx http codes in every second of last 10s period exceeds 25% of answers (relative @@ -644,6 +655,8 @@ parser could be switched off, providing ability to generate load with any data, receiving any answer in return. To do that add ``tank_type = 2`` to ``load.ini``. +Note + **Indispensable condition: Connection close must be initiated by remote side** ::