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
Filename, size python-sshtail-0.0.2.tar.gz (4.7 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page