{ "info": { "author": "Pavle Jonoski", "author_email": "jonoski.pavle@gmail.com", "bugtrack_url": null, "classifiers": [ "Development Status :: 3 - Alpha", "Intended Audience :: Developers", "Intended Audience :: System Administrators", "License :: OSI Approved :: Apache Software License", "Programming Language :: Python :: 3", "Topic :: Internet :: Log Analysis", "Topic :: Software Development :: Libraries", "Topic :: System :: Logging", "Topic :: Utilities" ], "description": "# theia\n\n[![Build Status](https://travis-ci.org/theia-log/theia.svg?branch=master)](https://travis-ci.org/theia-log/theia)\n[![Maintainability](https://api.codeclimate.com/v1/badges/ff2ef675417026a05721/maintainability)](https://codeclimate.com/github/theia-log/theia/maintainability)\n[![Test Coverage](https://api.codeclimate.com/v1/badges/ff2ef675417026a05721/test_coverage)](https://codeclimate.com/github/theia-log/theia/test_coverage)\n[![PyPI version](https://badge.fury.io/py/theia.svg)](https://badge.fury.io/py/theia)\n[![Documentation Status](https://readthedocs.org/projects/theia/badge/?version=latest)](https://theia.readthedocs.io/en/latest/?badge=latest)\n\nSimple and lightweight log aggregator\n\n\n\n\n# Introduction\nTheia is a log aggregator that collects logs from multiple log files usually on multiple machines and provides the log entries on a single endpoint. \nEach recorded entry comes from a single source (log file) and can be tagged with multiple tags. This way you can query an filter by the source (for example /var/log/apache or /var/log/reds) and tags (for example \"production1\", \"cache-server\", \"testing\" etc), or you can just simply match a pattern against the content of the entry.\n\nTheia has three parts:\n * watcher - this is the agent process running on the machine where you have your logs. You will have multiple watchers, but usually a single watcher per node\n * collector - this is the master process, usually running on a sperate node where you're going to collect the logs. Provides the interface for pushing the log events and an interface for querying the aggregated logs.\n * client - client for querying and watching live events. This connects to the collector via websocket and\nqueries the collected events or registers a filter for live events.\n\n# Installation\n\nTheia comes as a single python package (only python3 is supported). \n\nWith ```pip```:\n```bash\npip install theia\n```\n\n# Running the collector\n\nThis process collects and stores the events. The built-in database uses text files to store the events.\n\nCreate a directory where you want to keep the events, and run the collector server:\n\n```bash\nmkdir data\n\npython -m theia.cli collect -d ./data\n\n```\n\nThis will run the server listening on port ```6433```.\n\n# Running a watcher\n\nMake sure you have the collector running.\n\nThen, run the watcher:\n\n```bash\npython -m theia.cli watch -c localhost -f /var/log/httpd/access.log -t web-access\n```\n\nThis would watch for changes in ```access.log``` and send events to the collector \ntagged with ```web-access```\n\n# Run a query\n\nTo query for all log events with tag ```web-access```:\n\n```bash\npython -m theia.cli query -c localhost -t web-access\n```\n\n# Run a live filter\n\nTo watch the events with tag ```web-access``` as they arrive in real-time:\n\n```bash\npython -m theia.cli query -l -c localhost -t web-access\n```\n\n# Note\n**This is still work in progress and is far from production ready**", "description_content_type": "text/markdown", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/theia-log/theia", "keywords": "", "license": "", "maintainer": "", "maintainer_email": "", "name": "theia", "package_url": "https://pypi.org/project/theia/", "platform": "", "project_url": "https://pypi.org/project/theia/", "project_urls": { "Homepage": "https://github.com/theia-log/theia" }, "release_url": "https://pypi.org/project/theia/0.9.2/", "requires_dist": null, "requires_python": "", "summary": "Theia is a lightweight log aggregator.", "version": "0.9.2" }, "last_serial": 3975207, "releases": { "0.9.1": [ { "comment_text": "", "digests": { "md5": "26df4e77586da363971b05011d265aa7", "sha256": "15fbcc63c5fccd76b1788070e4b15e95c938f54a0067233750cc7437b3f240f2" }, "downloads": -1, "filename": "theia-0.9.1-py3-none-any.whl", "has_sig": false, "md5_digest": "26df4e77586da363971b05011d265aa7", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 19517, "upload_time": "2018-05-21T20:41:26", "url": "https://files.pythonhosted.org/packages/26/47/0bd068ab34ea99e507427dbfb8dd13ab56183229c792c21240ec2089c197/theia-0.9.1-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "58e8851ef3beec61e85b9dec09eb07ed", "sha256": "363a9c5223e8341f5591177141fc3ca1f316fca9d9761ef6f70fc60c92e18b5c" }, "downloads": -1, "filename": "theia-0.9.1.tar.gz", "has_sig": false, "md5_digest": "58e8851ef3beec61e85b9dec09eb07ed", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 16023, "upload_time": "2018-05-21T20:41:27", "url": "https://files.pythonhosted.org/packages/7e/50/09ec6f63136909a32fdbab373d2dacdd9069e74643c42fce67d5a8ba5d7c/theia-0.9.1.tar.gz" } ], "0.9.2": [ { "comment_text": "", "digests": { "md5": "5dbe76c554db24f3ccd22f315b55b5cb", "sha256": "93e2d07e993e2f552a2a57f9d037c2989286cba93526b30131c05de4c6006497" }, "downloads": -1, "filename": "theia-0.9.2.tar.gz", "has_sig": false, "md5_digest": "5dbe76c554db24f3ccd22f315b55b5cb", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 30590, "upload_time": "2018-06-18T23:45:27", "url": "https://files.pythonhosted.org/packages/dd/da/c5844d3d99e31348e0e43e3a2d1508634c29b283bb5ff122d21fee69bc20/theia-0.9.2.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "5dbe76c554db24f3ccd22f315b55b5cb", "sha256": "93e2d07e993e2f552a2a57f9d037c2989286cba93526b30131c05de4c6006497" }, "downloads": -1, "filename": "theia-0.9.2.tar.gz", "has_sig": false, "md5_digest": "5dbe76c554db24f3ccd22f315b55b5cb", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 30590, "upload_time": "2018-06-18T23:45:27", "url": "https://files.pythonhosted.org/packages/dd/da/c5844d3d99e31348e0e43e3a2d1508634c29b283bb5ff122d21fee69bc20/theia-0.9.2.tar.gz" } ] }