Skip to content
This repository has been archived by the owner on Nov 6, 2023. It is now read-only.

Latest commit

 

History

History
167 lines (128 loc) · 3.78 KB

README.md

File metadata and controls

167 lines (128 loc) · 3.78 KB
Raw

httperfpy

A python port of httperfrb http://github.com/jmervine/httperfrb.

Built and tested using:

$ python --version
Python 3.6.9

$ uname -s -r -m
Linux 4.15.0-96-generic x86_64

Installing httperf

Requires httperf, of course...

  • Mac
    • sudo port install httperf
  • Debian/Ubuntu
    • sudo apt install httperf
  • Redhat/Centos
    • sudo yum install httperf

Installation / Setup

  • Preferred Method (within a container)
    • pip install git+https://github.com/librato/httperfpy#egg=httperfpy
  • From source
    • Simply clone code and add checkout location to your PYTHONPATH.

Running tests

  1. git clone git+https://github.com/librato/httperfpy.git
  2. cd httperfpy
  3. ./scripts/unit

Usage

#!/usr/bin/env python
from httperfpy import Httperf

# replace dashes ("-") with underscores ("_") in httperf options
perf = Httperf(server="www.example.com",
                port=8080,
                num_conns=100)

# setting parser to True returns parsed results instead of raw results.
perf.parser = True

results = perf.run()

print results["connection_time_avg"] + " is avg"
print results["connection_time_max"] + " is max"

You can use Httperf.display_options to print a list of all available options.

Passing variables and key-values to httperf

  #!/usr/bin/env python
  from httperfpy import Httperf

  # arguments, key-value arguments
  perf = Httperf('hog', 'ssl', path='/path/to/httperf',
          server='www.example.com'...)

  # or only key-value arguments
  perf = Httperf(hog=True, ssl=True, path='/path/to/httperf',
          server='www.example.com'...)
  ...

Stand-alone parser...

#!/usr/bin/env python
from httperfpy import HttperfParser

parser = HttperfParser()
results = parser.parse(httperf_result_string [, options = {}])
print results["connection_time_avg"] + " is avg"
print results["connection_time_max"] + " is max"

The optional options argument is a dict with only one key at this time, 'state-changes', a boolean. If true it will print each state change as it occurs. It was useful for debugging the state-aware parsing.

Parser Keys

These are the keys of the dict returned by the parser.

  • command
  • max_connect_burst_length
  • total_connections
  • total_requests
  • total_replies
  • total_test_duration
  • connection_rate_per_sec
  • connection_rate_ms_conn
  • connection_time_min
  • connection_time_avg
  • connection_time_max
  • connection_time_median
  • connection_time_stddev
  • connection_time_connect
  • connection_length
  • request_rate_per_sec
  • request_rate_ms_request
  • request_size
  • reply_rate_min
  • reply_rate_avg
  • reply_rate_max
  • reply_rate_stddev
  • reply_rate_samples
  • reply_time_response
  • reply_time_transfer
  • reply_size_header
  • reply_size_content
  • reply_size_footer
  • reply_size_total
  • reply_status_1xx
  • reply_status_2xx
  • reply_status_3xx
  • reply_status_4xx
  • reply_status_5xx
  • cpu_time_user_sec
  • cpu_time_system_sec
  • cpu_time_user_pct
  • cpu_time_system_pct
  • cpu_time_total_pct
  • net_io_kb_sec
  • net_io_bps
  • errors_total
  • errors_client_timeout
  • errors_socket_timeout
  • errors_conn_refused
  • errors_conn_reset
  • errors_fd_unavail
  • errors_addr_unavail
  • errors_ftab_full
  • errors_other

mervine's modified httperf

This is required for extended verbose handling. We don't use it because tracking the variance in connection times is only useful when there is a uniform transaction mix and that's not applicable for our uses.

If we decide to implement this at some point it should 1) probably be a different option that '--verbose' which httperf uses to provide detailed information about internal operations, not additional performance data, and 2) the lines should be prefixed with a consistent identifier so they can be processed reasonably efficiently.

It is not tested.

See: http://mervine.net/httperf-0-9-1-with-individual-connection-times.