{ "info": { "author": "Rollbar, Inc.", "author_email": "support@rollbar.com", "bugtrack_url": null, "classifiers": [ "Development Status :: 4 - Beta", "Environment :: Web Environment", "Intended Audience :: Developers", "License :: OSI Approved :: MIT License", "Programming Language :: Python", "Topic :: Internet :: WWW/HTTP", "Topic :: Internet :: WWW/HTTP :: WSGI :: Middleware", "Topic :: Software Development", "Topic :: Software Development :: Bug Tracking", "Topic :: Software Development :: Quality Assurance", "Topic :: Software Development :: Testing" ], "description": "rollbar-agent\n=============\n\nrollbar-agent is a Python daemon that can monitor log files and push messages to Rollbar. It can monitor:\n\n- ``.rollbar`` files written by a Rollbar notifier library (currently supported in rollbar-php, pyrollbar, and rollbar-agent)\n- Python-style log files\n\n(Other log files formats are currently not supported out of the box.)\n\nWho Should Use rollbar-agent\n----------------------------\n\nIf you are trying to monitor your application's log files, we recommend using a Rollbar notifier library instead\n(or in addition, in the case of PHP--see next paragraph). The Rollbar notifiers are easier to install and use and will gather more\ncontext about each error. See https://rollbar.com/docs for a list of supported languages and links to notifiers.\n\nToday, the primary use of rollbar-agent is to provide durable, asynchronous reporting from PHP applications\nthat are instrumented with rollbar-php. If you are using PHP and performance is important, you'll want to set up\nrollbar-agent.\n\nFor almost everyone else, rollbar-agent is more complexity than needed when getting started; most other platforms\nprovide easier ways to do asynchronous reporting that don't require running a separate process. However, rollbar-agent\nmay still be desirable if:\n\n- you want to minimize work done in your application process, even if it's in a background thread\n- durability is important (i.e. it's important that reports to Rollbar succeed even if the main process dies, or that they eventually succeed if the network is temporarily unavailable)\n\nInstalling and configuring rollbar-agent will be much easier if you have a basic understanding of\nPython virtualenvs and are comfortable editing the configuration files that control services\non your OS.\n\n\nRequirements\n------------\nrollbar-agent requires:\n\n- A unix-like system (tested on Fedora and Ubuntu Linux and Mac OS X)\n- Python 2.6+\n- requests 0.13.1+ (will be installed by pip or setup.py, below)\n- a Rollbar_ account\n\n\nSet up a virtualenv\n-------------------\n\nYou can install rollbar-agent by using pip, by checking out the code from the GitHub repository, or by\ndownloading a tar file. In each case, you'll be installing rollbar-agent into a Python virtualenv. If\nyou don't already have an appropriate virtualenv set up, you should create one now. For more information\non Python virtual environments, see http://docs.python-guide.org/en/latest/dev/virtualenvs/\n\nInstall rollbar-agent\n---------------------\n\nOnce you've created and activated your virualenv, install the rollbar-agent code and configuration files\ninto that environment using your preferred method below. Each method will install the rollbar-agent library\nand put the configuration and service start up files you'll need into the root directory of your virtualenv. \n\n**Installing with pip**\n\nIf you're familiar with pip, you can install rollbar-agent with::\n\n pip install rollbar-agent\n\n**Installing from source**\n\nIf you're comfortable with Git::\n\n git clone https://github.com/rollbar/rollbar-agent.git\n cd rollbar-agent\n\nOr just grab the .tar.gz::\n\n wget https://github.com/rollbar/rollbar-agent/archive/v0.4.3.tar.gz\n tar -xzf v0.4.3\n cd rollbar-agent-0.4.3\n\nThen install (may require sudo)::\n\n python setup.py install\n\n\nSet up the rollbar-agent service\n--------------------------------\n\nSymlink the rollbar-agent executable to /usr/local/rollbar-agent::\n\n ln -s /path/to/virtualenv/rollbar-agent /usr/local/rollbar-agent\n\nand symlink the rollbar-agent configuration file to /etc/rollbar-agent.conf::\n\n ln -s /path/to/virtualenv/rollbar-agent.conf /etc/rollbar-agent.conf\n\n**init.d script**\n\nrollbar-agent comes with an example init.d script, chkconfig compatible and tested on Fedora Linux, update-rc.d on Ubuntu Linux. You'll need\nto edit this script and make sure the ``VIRTUALENV`` environment variable contains the path to the virtual environment you set up.\n\nOnce you've edited the rollbar-agent-init.sh script, symlink ``rollbar-agent-init.sh`` to ``/etc/init.d/rollbar-agent``::\n\n chmod +x /path/to/virtualenv/rollbar-agent-init.sh\n ln -s /path/to/virtualenv/rollbar-agent-init.sh /etc/init.d/rollbar-agent\n\nOn Ubuntu, you'll need to add to rc.d. Run the following::\n\n update-rc.d rollbar-agent defaults\n\nOn Fedora, add to chkconfig::\n\n chkconfig --add rollbar-agent\n chkconfig on rollbar-agent\n \nOn other systems, check your system's documentation for its equivalent of chkconfig.\n\nNow, start the service::\n\n service rollbar-agent start\n\nTo check that it's running, tail its log file::\n\n tail -f /var/log/rollbar-agent.log\n\nConfiguration\n-------------\nConfiguration options for rollbar-agent itself are in `rollbar-agent.conf`. If you're using the init script, it has a few of its own configuration variables inside which control how it runs.\n\n**rollbar-agent.conf**\nAt the bare minimum, you will want to change the following variables:\n\n- ``params.access_token`` -- your Rollbar access token, specifically an API token that allows \"post_server_item\"\n- ``targets`` -- white-space-separated list of files or directories (non-recursive) to process.\n- ``statefile`` -- path to a file where the state will be stored. File does not need to exist, but the directory does. This file should *not* be placed somewhere it is likely to be deleted, as that will trigger all files to be re-processed. ``/tmp`` is not a good location.\n\nThere are several parameters about formats, etc.; you do NOT need to do anything with these if you're only using rollbar-agent as a relay in combination with one of our other libraries.\n\nSetting the following variables will improve integration:\n\n- ``params.root`` -- path to your code root\n- ``params.branch`` -- the current branch\n\nIf you're using rollbar-agent alongside rollbar-php, you'll want to enable:\n\n- ``delete_processed_files`` -- when true, files are deleted once processing is complete. Default false.\n\nIf your logs are capturing terminal escape sequences such as color / boldness, you may want to set\n``filter_chr_attr_sequences = true``. This will clean all output of character attribute terminal sequences.\n\nOther options are documented in the sample config file.\n\n**rollbar-agent-init.sh**\nConfiguration variables should be self-explanatory. If you're not using a virtualenv, set ``VIRTUALENV=\"\"``.\n\n\nContributing\n------------\n\nContributions are welcome. The project is hosted on github at http://github.com/rollbar/rollbar-agent\n\n\nAdditional Help\n---------------\nIf you have any questions, feedback, etc., drop us a line at team@rollbar.com\n\n\n.. _Rollbar: http://rollbar.com/\n.. _`download the zip`: https://github.com/rollbar/pyrollbar/zipball/master\n.. _rollbar-agent: http://github.com/rollbar/rollbar-agent\n.. _pip: http://www.pip-installer.org/en/latest/installing.html", "description_content_type": "", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "http://github.com/rollbar/rollbar-agent", "keywords": "", "license": "", "maintainer": "", "maintainer_email": "", "name": "rollbar-agent", "package_url": "https://pypi.org/project/rollbar-agent/", "platform": "", "project_url": "https://pypi.org/project/rollbar-agent/", "project_urls": { "Homepage": "http://github.com/rollbar/rollbar-agent" }, "release_url": "https://pypi.org/project/rollbar-agent/0.4.3/", "requires_dist": null, "requires_python": "", "summary": "Rollbar server-side agent", "version": "0.4.3" }, "last_serial": 3674262, "releases": { "0.2.4": [], "0.3.0": [ { "comment_text": "", "digests": { "md5": "9828a8152278998bd446c90738cbd4dd", "sha256": "d0d7b3524aa2c0b75417b176c44089ee6eb54325d6e976378c95c9e9ac2dbcfe" }, "downloads": -1, "filename": "rollbar-agent-0.3.0.tar.gz", "has_sig": false, "md5_digest": "9828a8152278998bd446c90738cbd4dd", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 12399, "upload_time": "2013-02-26T06:38:15", "url": "https://files.pythonhosted.org/packages/26/c8/c0454053b2e445b8a6a76c77b3d01eb3ebcde978b671ed04059444501cf3/rollbar-agent-0.3.0.tar.gz" } ], "0.3.1": [ { "comment_text": "", "digests": { "md5": "9b2602f909fb5740bf51455826b1a732", "sha256": "8971b70c360f39dff2d795b7e1ebe1be4352f06fdcc2d6773b75619033bfa462" }, "downloads": -1, "filename": "rollbar-agent-0.3.1.tar.gz", "has_sig": false, "md5_digest": "9b2602f909fb5740bf51455826b1a732", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 11437, "upload_time": "2013-03-01T02:23:30", "url": "https://files.pythonhosted.org/packages/18/ce/e2ac3366826f1bdb239c9b8cdaabcb538fd16cb2c25de7a694d5fd9a397a/rollbar-agent-0.3.1.tar.gz" } ], "0.3.10": [ { "comment_text": "", "digests": { "md5": "d330145fcbe014e03568160d244f5c09", "sha256": "6f3dce345adbf7636920f0ca1f1e4afd1179212c8da67722676cd20efc46f94a" }, "downloads": -1, "filename": "rollbar-agent-0.3.10.tar.gz", "has_sig": false, "md5_digest": "d330145fcbe014e03568160d244f5c09", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 14599, "upload_time": "2014-08-22T17:43:14", "url": "https://files.pythonhosted.org/packages/e2/7b/39c651ffba059eb8b57a2ce0a54d964d6ac593ba559c54188c238a7a6b7a/rollbar-agent-0.3.10.tar.gz" } ], "0.3.11": [ { "comment_text": "", "digests": { "md5": "b355a703e918d07549f63b35b4120535", "sha256": "c571b921b89d4313385979bd4a289c6619de0aee38ca24156fe4c5596b46d956" }, "downloads": -1, "filename": "rollbar-agent-0.3.11.tar.gz", "has_sig": false, "md5_digest": "b355a703e918d07549f63b35b4120535", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 13273, "upload_time": "2015-05-06T23:35:56", "url": "https://files.pythonhosted.org/packages/f1/c6/d782f12b24640ac9dea28e4cf0dfa9f1e2bb88597498f8e1dd6f26ecd188/rollbar-agent-0.3.11.tar.gz" } ], "0.3.12": [ { "comment_text": "", "digests": { "md5": "06dbba8a1668c4d44bbe3c94cb21458a", "sha256": "33caa9bb621e1f6f920c6109630dfdd5f247c682f1844075468b07bc99f6b43c" }, "downloads": -1, "filename": "rollbar-agent-0.3.12.tar.gz", "has_sig": false, "md5_digest": "06dbba8a1668c4d44bbe3c94cb21458a", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 14892, "upload_time": "2015-05-08T00:38:39", "url": "https://files.pythonhosted.org/packages/02/ab/84f910a56b62b6f2d624ba96776d3d25606f0677eda06890c185975f82d7/rollbar-agent-0.3.12.tar.gz" } ], "0.3.2": [ { "comment_text": "", "digests": { "md5": "f3b06f5e9d9285410eac112b229cc402", "sha256": "14b039dd923133a2a5e9557c8c8c59f93935a9786ecfb61db8425be608c85a07" }, "downloads": -1, "filename": "rollbar-agent-0.3.2.tar.gz", "has_sig": false, "md5_digest": "f3b06f5e9d9285410eac112b229cc402", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 13368, "upload_time": "2013-03-05T03:41:30", "url": "https://files.pythonhosted.org/packages/99/04/5bf5a1d595841bdc86eefb8b5e67831211de578dd2587bb4be029c63c98c/rollbar-agent-0.3.2.tar.gz" } ], "0.3.4": [ { "comment_text": "", "digests": { "md5": "e0b1e9872ca1d0973a83dd474e505b36", "sha256": "9917f156b64f862d30be02b5f7249e56fa46d4ff6d353b19883121d977fd3799" }, "downloads": -1, "filename": "rollbar-agent-0.3.4.tar.gz", "has_sig": false, "md5_digest": "e0b1e9872ca1d0973a83dd474e505b36", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 12352, "upload_time": "2014-01-08T06:03:50", "url": "https://files.pythonhosted.org/packages/e7/d6/fc5a5f82e4f517a2ee205f55a1ab46dfbd2a070685db27f2d9a4b37684be/rollbar-agent-0.3.4.tar.gz" } ], "0.3.5": [ { "comment_text": "", "digests": { "md5": "27b332d29f3de7aa4d5c6b031361b08a", "sha256": "24acd75d98d0d78e867dc66dbaf72ca2556c47b00b8a0a39f782b7ccdcdd1797" }, "downloads": -1, "filename": "rollbar-agent-0.3.5.tar.gz", "has_sig": false, "md5_digest": "27b332d29f3de7aa4d5c6b031361b08a", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 14060, "upload_time": "2014-02-07T00:27:43", "url": "https://files.pythonhosted.org/packages/21/00/997a2700296ec1ee67a43ca3f51e5c959f4246c7b8388e70de5d003e941c/rollbar-agent-0.3.5.tar.gz" } ], "0.3.6": [ { "comment_text": "", "digests": { "md5": "3740a9a395d9a1e40d78462d1f2efcc8", "sha256": "05221b0829e0d1290f4a5ce1bfadf174e79381a3a9ccfb67060a5a66bf88c5e5" }, "downloads": -1, "filename": "rollbar-agent-0.3.6.tar.gz", "has_sig": false, "md5_digest": "3740a9a395d9a1e40d78462d1f2efcc8", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 14122, "upload_time": "2014-03-17T19:27:05", "url": "https://files.pythonhosted.org/packages/b9/6c/0a9d0f4ad74c32f79b431a3215111881d51479ec352136bf0d11862cf646/rollbar-agent-0.3.6.tar.gz" } ], "0.3.7": [ { "comment_text": "", "digests": { "md5": "d39472e4de5ccd2ae3a816a7fd3b8eff", "sha256": "84178ccead2b81685a8ed34368ca4d9f6c452fbc320ef6c42d2afde1f6466bf5" }, "downloads": -1, "filename": "rollbar-agent-0.3.7.tar.gz", "has_sig": false, "md5_digest": "d39472e4de5ccd2ae3a816a7fd3b8eff", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 12686, "upload_time": "2014-04-30T18:24:08", "url": "https://files.pythonhosted.org/packages/96/53/76655eed96c284d1f50ef395ada71b3ecbe6ca351ea9acc5bbe3881b2423/rollbar-agent-0.3.7.tar.gz" } ], "0.3.8": [ { "comment_text": "", "digests": { "md5": "193dff82f4679149401e98e725d79860", "sha256": "9b1a1491ce690145eafee23ffda5333de3660c6be7b611010c7a57e59d18c586" }, "downloads": -1, "filename": "rollbar-agent-0.3.8.tar.gz", "has_sig": false, "md5_digest": "193dff82f4679149401e98e725d79860", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 14536, "upload_time": "2014-06-24T00:43:07", "url": "https://files.pythonhosted.org/packages/c4/ee/6a86f7675a9f72ef48bacf606ecd62fa0a0d5a8967b11ad05f58f80a7dab/rollbar-agent-0.3.8.tar.gz" } ], "0.3.9": [ { "comment_text": "", "digests": { "md5": "e8a1aed0f0d0f13988860fc768e0c37b", "sha256": "75d9ac906c8d45ccd48ed6e234fb2f4176c6bd6076b7d024402d21eb1a9c08a9" }, "downloads": -1, "filename": "rollbar-agent-0.3.9.tar.gz", "has_sig": false, "md5_digest": "e8a1aed0f0d0f13988860fc768e0c37b", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 14609, "upload_time": "2014-06-24T22:46:20", "url": "https://files.pythonhosted.org/packages/41/d9/06fc97df3d37a52486cad7d7fc800a857ba262f202372ab836270aa339e2/rollbar-agent-0.3.9.tar.gz" } ], "0.4.0": [ { "comment_text": "", "digests": { "md5": "1484db46079a661ed4e2ba20c0009366", "sha256": "a09e92ae759391b5164f4bcd94507f5ae4b363a52c8ce4b7b2050e0abd9554ed" }, "downloads": -1, "filename": "rollbar-agent-0.4.0.tar.gz", "has_sig": false, "md5_digest": "1484db46079a661ed4e2ba20c0009366", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 13835, "upload_time": "2015-06-30T21:42:31", "url": "https://files.pythonhosted.org/packages/da/4a/de832cab479b6e617287af3bf1abb23262fe0f8a7364a7a1bf98ff9d466d/rollbar-agent-0.4.0.tar.gz" } ], "0.4.1": [ { "comment_text": "", "digests": { "md5": "887ced181f424997f604a1481020435e", "sha256": "0662dc83d2a096c485c37ea65391c2e95b3a21e8ab9010d27d69b88e5ddb7724" }, "downloads": -1, "filename": "rollbar-agent-0.4.1.tar.gz", "has_sig": false, "md5_digest": "887ced181f424997f604a1481020435e", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 16843, "upload_time": "2018-01-09T01:53:19", "url": "https://files.pythonhosted.org/packages/7e/2a/082d10f373d8587f37295370074037731325f24927be9862117ba1b89486/rollbar-agent-0.4.1.tar.gz" } ], "0.4.2": [ { "comment_text": "", "digests": { "md5": "6763831160d61d0be7358040a2c3a513", "sha256": "391645b5feb7ed86ade06663b1203ef4effe1f98a4ff0b6a15351cc607b764a2" }, "downloads": -1, "filename": "rollbar-agent-0.4.2.tar.gz", "has_sig": false, "md5_digest": "6763831160d61d0be7358040a2c3a513", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 17214, "upload_time": "2018-01-25T19:52:32", "url": "https://files.pythonhosted.org/packages/3c/09/03c1bb1bf3d4997ce02c15e994327f9e5986763c8526d1b4883271efcb73/rollbar-agent-0.4.2.tar.gz" } ], "0.4.3": [ { "comment_text": "", "digests": { "md5": "84d94b051471fb49bc19b0e914d04a90", "sha256": "7fc71dbbca34ac9e416dcdba95c1220db5c2996b7f173f68cc4b1490425e68f8" }, "downloads": -1, "filename": "rollbar-agent-0.4.3.tar.gz", "has_sig": false, "md5_digest": "84d94b051471fb49bc19b0e914d04a90", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 16718, "upload_time": "2018-03-15T21:42:15", "url": "https://files.pythonhosted.org/packages/32/f7/9c032c97f21fa4713fb34c4a817f3d4ed8dd8858202f543396831ed9601c/rollbar-agent-0.4.3.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "84d94b051471fb49bc19b0e914d04a90", "sha256": "7fc71dbbca34ac9e416dcdba95c1220db5c2996b7f173f68cc4b1490425e68f8" }, "downloads": -1, "filename": "rollbar-agent-0.4.3.tar.gz", "has_sig": false, "md5_digest": "84d94b051471fb49bc19b0e914d04a90", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 16718, "upload_time": "2018-03-15T21:42:15", "url": "https://files.pythonhosted.org/packages/32/f7/9c032c97f21fa4713fb34c4a817f3d4ed8dd8858202f543396831ed9601c/rollbar-agent-0.4.3.tar.gz" } ] }