httperfpy 0.0.5

Python wrapper for httperf.

=========
httperfpy
=========

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

Built and tested using:

$ python --version
Python 2.7.3

$ uname -s -r -m
Linux 3.2.0-29-generic x86_64



Installing 'httperf'
====================

Requires httperf, of course...

Mac
------

sudo port install httperf

Debian / Ubuntu
---------------

sudo apt-get install httperf

Redhat / CentOS
---------------

sudo yum install httperf

My 'httperf'
------------

** This is required for proper verbose handling. **

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


Installation / Setup
====================

Perferred Method
----------------

$ sudo pip install httperfpy

See: http://pypi.python.org/pypi/httperfpy/

From Source
-----------

Simply clone code and add checkout location to your PYTHONPATH.

Running tests...
----------------

1. sudo apt-get install python-unit
2. git clone https://github.com/jmervine/httperfpy.git
3. cd httperfpy
4. ./scripts/unit


Usage
-----

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

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

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

results = HttperfParser.parse(httperf_result_string)
print results["connection_time_avg"] + " is avg"
print results["connection_time_max"] + " is max"



Parser Keys:
------------

- 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