Skip to main content

Python classes to allow for tailing of multiple files via SSH.

Project description

A simple set of Python classes to facilitate tailing of one or more files via SSH. At the moment it only supports key-based SSH’ing.

Quick installation

Install from PyPI:

> easy_install -U python-sshtail

Tailing a single file

from sshtail import SSHTailer
from time import sleep

# "" is the IP address or host name you want to access
tailer = SSHTailer('', '/var/log/path/to/my/logfile.log')

    while 1:
        for line in tailer.tail():
            print line

        # wait a bit


Tailing multiple files

from sshtail import SSHMultiTailer

tailer = SSHMultiTailer({
    '': ['/path/to/log1.log', '/path/to/log2.log'],
    '': ['/path/to/log3.log'],

# will run until it receives SIGINT, after which it will
# automatically catch the exception, disconnect from the
# remote hosts and perform cleanup

for host, filename, line in tailer.tail():
    print "%s:%s - %s" % (host, filename, line)

Using a custom private key

from sshtail import SSHMultiTailer, load_dss_key

# if no path's specified for the private key file name,
# it automatically prepends /home/<current_user>/.ssh/
# and for RSA keys, import load_rsa_key instead.

tailer = SSHMultiTailer({
        '': ['/path/to/log1.log', '/path/to/log2.log'],
        '': ['/path/to/log3.log'],

for host, filename, line in tailer.tail():
    print "%s:%s - %s" % (host, filename, line)

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for python-sshtail, version 0.0.2
Filename, size File type Python version Upload date Hashes
Filename, size python_sshtail-0.0.2-py2.7.egg (7.2 kB) File type Egg Python version 2.7 Upload date Hashes View hashes
Filename, size python-sshtail-0.0.2.tar.gz (4.7 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page