parallel-ssh Clients

paramiko vs libssh2

In a previous post a comparison was shown between two SSH library options for Python, with emphasis on their performance using native threads for scaling purposes.

For this post, their non-blocking performance using the gevent library will be compared as the two SSH library options available now in parallel-ssh.

Post has been updated with further scaling graphs for both clients.

Test Setup

Test script (see appendix) consists of identical parallel-ssh code for the two available parallel clients in the library, using paramiko and libssh2 via ssh2-python respectively as the underlying SSH libraries. The latest version of the library as of this time of writing was used - 1.2.0 - with latest underlying libraries as installed by its requirements and latest version of gevent - 1.2.2.

The script creates SSH sessions in parallel to a local to the client SSH server via loop back device, with concurrencystarting from one and increasing by one until completion.

A maximum concurrency of two hundred sessions is used for the comparison tests.

A single remote command, cat of a 26KB static file, is performed and standard output read one line at a time as parsed by the respective libraries.

Timings are shown for:

  • Auth and execute - connection, authentication and execute command sent for all hosts
  • Close and exit status - wait for execute completion, close execute channel and get exit status (SSH session remains open)
  • Execute - same remote command executed again on the same SSH session
  • Channel read - read complete remote output line by line

All durations are in milliseconds (ms) or multiples of. All tests performed on Linux, kernel version 4.4 on a six core CPU and OpenSSH 7.5r1 with OpenSSL 1.0.2l.

Click on images for larger versions.

Test Results

Graphs show median values per five second intervals.

Here is how the two SSH clients compare on the above timings plus total time spent.

Clients Comparison

Shown below is time taken for all hosts in total.

Two hundred concurrent sessions

Separate graphs for the two clients for up to two hundred concurrent sessions.

parallel-ssh ssh2 paramiko

One hundred concurrent sessions combined graph

parallel-ssh ssh2 paramiko

Individual Results

Results for the clients individually up to one hundred concurrent sessions, including CPU and memory usage graphs.

parallel-ssh ssh2

parallel-ssh paramiko

The ssh2-python based client is shown to use about 250MB less memory and fully utilising a little more than three cores at one hundred concurrency, with the paramiko client a little more than one core.


Further scaling of the ssh2 client is possible, though gevent and event loop overhead leads to diminishing returns, seen in the highest concurrency graph as intermittent spikes in latency that increase in frequency as concurrency ramps up. No limit was found as to how far concurrency could be increased.

On already authenticated sessions, executing new commands remains fairly low latency on the ssh2 client even at high concurrency levels.

The paramiko client shows worse than linear scaling against number of concurrent sessions, continually increasing up to the two hundred concurrent sessions tested. It would also often experience dead locks at all concurrency levels.

Performance gap between the two clients continues increasing as concurrency ramps up with similar scaling for the respective clients as seen in previous graphs.

Relative Performance

Relative performance of average times of the two libraries for the duration of the test at one hundred concurrent sessions.

For example if a paramiko operation were twice as fast as the equivalent ssh2-python operation, its relative performance would be x0.5 of ssh2-python whereas identical durations would result in x1 relative performance.

Operation paramiko average ssh2 average paramiko/ssh2 relative average 100 concurrency 200 concurrency
auth and execute 7.1 sec 1.71 sec 4.15x 2.98x 7.08x
close and exit status 10 ms 1 ms 10x 2.25x 3.57x
execute 466 ms 174 ms 2.67x 3.38x 3.44x
channel read 379 ms 173 ms 2.19x 2.07x 2.35x
total 7.95 sec 1.71 sec 4.64x 2.86x 6.16x


At one hundred concurrent sessions, the ssh2 client is shown to be 2.86 times faster.

At two hundred concurrent sessions, the ssh2 client is shown to be 6.16 times faster.

On average for the duration of the test ranging from one to two hundred (1-200) concurrent sessions, the ssh2-python (libssh2) based client in parallel-ssh is shown to be a little more than four and a half times faster than the paramiko based client.

Latency for gevent based non-blocking clients compared to previous threading tests is, as expected, much lower for both clients while also allowing for much higher scaling.

The ssh2 client in particular has lower latency at two hundred concurrent sessions in the non-blocking test - 2.72 sec - as the threading test has at fifty concurrent sessions - 3.62 sec. The paramiko client also shows lower latency in the non-blocking test, though still taking over 16 sec in total at two hundred concurrency.

Note that SFTP operations which were previously shown to benefit the most are not shown here as tests are against a single, local, SSH server and parallel-ssh SFTP operations are for copying files which would overwrite each other if copied to/from the same server.

It is also worth pointing out that this test puts a lot of strain on gevent and the event loop as the commands are short lived, causing contention on the event loop from all the coroutines wanting to execute. This can be seen in the graphs by the intermittent spikes in latency for both clients which increase in frequency as concurrency ramps up.

For longer lived remote commands, scaling can continue before diminishing returns stemming from event loop and gevent overhead.

In all, tests show good scaling for the native library based client and the benefits of using native code extensions in Python libraries.

Combining native code extensions for network libraries with a non-blocking mode and non-blocking network libraries like gevent allows for very good performance while at the same time benefiting from the ease of use and conciseness of the Python language.

In future it would be interesting to examine further scaling of gevent and the event loop via native threads which is only possible with native code extensions that release Python’s GIL, putting parallel-ssh in a good position to take advantage of.


Test script and dashboard used can be found below:

Docker compose file can be used as-is to easily setup the dashboard, API and DB services as described below.

The test script writes data to a local InfluxDB via its Graphite service using a measurement.field* template.

Graphs were generated by Grafana, as queried from InfluxDB by InfluxGraph using the same template configuration as InfluxDB.

To replicate results, take care to use the exact versions of the libraries used here, including libssh2.