{ "info": { "author": "Dan Buch", "author_email": "d.buch@modcloth.com", "bugtrack_url": null, "classifiers": [ "Development Status :: 4 - Beta", "Environment :: Console", "Intended Audience :: Developers", "Intended Audience :: Information Technology", "Intended Audience :: System Administrators", "License :: OSI Approved :: MIT License", "Natural Language :: English", "Operating System :: MacOS :: MacOS X", "Operating System :: POSIX :: Linux", "Operating System :: POSIX :: SunOS/Solaris", "Programming Language :: Python :: 2.7", "Programming Language :: Python :: 3.3", "Topic :: System :: Logging", "Topic :: System :: Monitoring", "Topic :: System :: Systems Administration", "Topic :: Utilities" ], "description": "``loggly-pipe``\n===============\n\n.. image:: https://travis-ci.org/modcloth-labs/loggly-pipe.png?branch=master\n :target: https://travis-ci.org/modcloth-labs/loggly-pipe\n\n* Eats lines from stdin.\n* Sends batches to Loggly (or compatible).\n* Poops unaltered lines to stdout.\n* Poops ``mark`` JSON to stdout.\n\nInstallation\n------------\n\n``loggly-pipe`` is built to be executed as a standalone file, so installing\ndirectly from the raw github URL works great:\n\n.. code-block:: bash\n\n curl -L -o loggly-pipe https://raw.github.com/modcloth-labs/loggly-pipe/master/loggly_pipe.py\n chmod +x loggly-pipe\n \nYou can also grab it via ``pip``, which will install a ``loggly-pipe`` executable:\n\n.. code-block:: bash\n\n pip install loggly_pipe\n\n\nConfiguration\n-------------\n\nConfiguration may be given via the command line or the env. The latest command line\noptions are available like one might expect:\n\n.. code-block:: bash\n\n loggly-pipe --help\n\nHere's a list of the environment variables that are used as the option defaults:\n\n* ``LOGGLY_TOKEN`` **REQUIRED** one of the tokens from your Loggly account\n* ``LOGGLY_SERVER`` the base server URI (default\n ``https://logs-01.loggly.com``)\n* ``LOGGLY_SHIPPER_COUNT`` number of shipper threads (default ``1``)\n* ``LOGGLY_TAGS`` comma-delimited tags to apply to the shipped records.\n This is passed directly as the last member of ``PATH_INFO``, so it\n should be URL-encoded if necessary. (default ``python``)\n* ``LOGGLY_BATCH_SIZE`` number of records to accumulate before shipping\n over HTTP (default ``100``)\n* ``LOGGLY_MAX_LINES`` exit after consuming this many lines (default ``0``,\n which disables)\n* ``LOGGLY_STDIN_SLEEP_INTERVAL`` interval in seconds to sleep when line\n read from stdin is empty (default ``0.1``)\n* ``LOGGLY_FLUSH_INTERVAL`` interval in seconds at which to flush the line\n buffer so that low activity doesn't cause records to back up (default\n ``10.0``)\n* ``LOGGLY_SHIP_ATTEMPTS`` number of times to retry each batch over HTTP\n (default ``1``)\n* ``LOGGLY_ON_ERROR`` behavior when exceptions are caught, which is\n usually around shipping over HTTP, and will only take effect once\n ``LOGGLY_SHIP_ATTEMPTS`` has been reached (choices are ``raise``, ``ignore``;\n default ``raise``)\n* ``LOGGLY_DEBUG`` print some debuggy stuff if non-empty\n\nUsage\n-----\n\nGiven a stdin stream made of line-based JSON records, ``loggly-pipe`` will\nemit each record unaltered as well as a record with a single ``_mark`` key\nfor each batch.\n\nHere's an example of a node app that uses bunyan for logging as well as\nthe ``bunyan`` command line tool for human readability:\n\n.. code-block:: bash\n\n node server.js | loggly-pipe | bunyan\n\nA trivial example that's used in the black-box test of ``loggly-pipe``\nitself can be found in the `examples dir <./examples>`_.", "description_content_type": null, "docs_url": null, "download_url": "UNKNOWN", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/modcloth-labs/loggly-pipe", "keywords": "loggly logging http logs", "license": "MIT", "maintainer": null, "maintainer_email": null, "name": "loggly_pipe", "package_url": "https://pypi.org/project/loggly_pipe/", "platform": "any", "project_url": "https://pypi.org/project/loggly_pipe/", "project_urls": { "Download": "UNKNOWN", "Homepage": "https://github.com/modcloth-labs/loggly-pipe" }, "release_url": "https://pypi.org/project/loggly_pipe/0.2.1/", "requires_dist": null, "requires_python": null, "summary": "Pipe stuff to Loggly.", "version": "0.2.1" }, "last_serial": 1205659, "releases": { "0.1.0": [ { "comment_text": "", "digests": { "md5": "8ee3d63eae346979b7fba05d1185c0eb", "sha256": "653a1a635f2f8e1f2acba62255a1c054774f8b7d6aad6567934fba46663ca07d" }, "downloads": -1, "filename": "loggly_pipe-0.1.0.tar.gz", "has_sig": false, "md5_digest": "8ee3d63eae346979b7fba05d1185c0eb", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 4959, "upload_time": "2013-11-29T01:09:31", "url": "https://files.pythonhosted.org/packages/3f/5b/f43b47058dfd7674a474f4ea379ed1b72ce3cbc555fef0e361b87a367835/loggly_pipe-0.1.0.tar.gz" } ], "0.2.0": [ { "comment_text": "", "digests": { "md5": "c5249333b1c4cd08047e28d54aba4189", "sha256": "66ef9fd1484610bad174c262f0bb5743b81ec0e8d1334a4cf28ebf4cdcaaf73a" }, "downloads": -1, "filename": "loggly_pipe-0.2.0.tar.gz", "has_sig": false, "md5_digest": "c5249333b1c4cd08047e28d54aba4189", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 5707, "upload_time": "2013-11-30T04:30:52", "url": "https://files.pythonhosted.org/packages/f2/49/0ccf479528679a37ab3c8357b9f5bba47264d0c99e3a320c24f38374bdbb/loggly_pipe-0.2.0.tar.gz" } ], "0.2.1": [ { "comment_text": "", "digests": { "md5": "f3441e7941b0d6e95b70f8636e992917", "sha256": "6f8139592da65a631b5910c6060ca39ae7d75369f42ea1ed4f933c828f97d904" }, "downloads": -1, "filename": "loggly_pipe-0.2.1.tar.gz", "has_sig": false, "md5_digest": "f3441e7941b0d6e95b70f8636e992917", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 5718, "upload_time": "2013-11-30T18:04:30", "url": "https://files.pythonhosted.org/packages/01/67/5b882d43a3a5b89e60051094b2474418eea047fdfd2cc11f6fcce8c19544/loggly_pipe-0.2.1.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "f3441e7941b0d6e95b70f8636e992917", "sha256": "6f8139592da65a631b5910c6060ca39ae7d75369f42ea1ed4f933c828f97d904" }, "downloads": -1, "filename": "loggly_pipe-0.2.1.tar.gz", "has_sig": false, "md5_digest": "f3441e7941b0d6e95b70f8636e992917", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 5718, "upload_time": "2013-11-30T18:04:30", "url": "https://files.pythonhosted.org/packages/01/67/5b882d43a3a5b89e60051094b2474418eea047fdfd2cc11f6fcce8c19544/loggly_pipe-0.2.1.tar.gz" } ] }