{ "info": { "author": "Malte Harder", "author_email": "malte.harder@blue-yonder.com", "bugtrack_url": null, "classifiers": [ "Development Status :: 3 - Alpha", "Programming Language :: Python", "Topic :: Utilities" ], "description": "=======\nbonfire\n=======\n\nBonfire is a command line interface to query Graylog searches via the REST API. It tries to emulate the feeling of using tail on a local file.\n\nUsage\n=====\n\nExamples::\n\n > bonfire -h logserver -u jdoe -@ \"10 minutes ago\" \"*\"\n ...\n\n > bonfire -h logserver -u jdoe -f \"source:localhost AND level:2\"\n ...\n\nBonfire usage::\n\n Usage: bonfire [OPTIONS] [QUERY]\n\n Bonfire - An interactive graylog cli client\n\n Options:\n --node TEXT Label of a preconfigured graylog node\n -h, --host TEXT Your graylog node's host\n -s, --tls Use HTTPS\n --port INTEGER Your graylog port (default: 12900)\n -u, --username TEXT Your graylog username\n -p, --password TEXT Your graylog password (default: prompt)\n -k, --keyring / -nk, --no-keyring\n Use keyring to store/retrieve password\n -@, --search-from TEXT Query range from\n -#, --search-to TEXT Query range to (default: now)\n -t, --tail Show the last n lines for the query\n (default)\n -d, --dump Print the query result as a csv\n -o, --output TEXT Output logs to file (only tail/dump mode)\n -f, --follow Poll the logging server for new logs\n matching the query (sets search from to now,\n limit to None)\n -l, --interval INTEGER Polling interval in ms (default: 1000)\n -n, --limit INTEGER Limit the number of results (default: 10)\n -a, --latency INTEGER Latency of polling queries (default: 2)\n -r, --stream TEXT Stream ID of the stream to query (default:\n no stream filter)\n -e, --field TEXT Fields to include in the query result\n -x, --template-option TEXT Template options for the stored query\n -s, --sort TEXT Field used for sorting (default: timestamp)\n --asc / --desc Sort ascending / descending\n --help Show this message and exit.\n\nConfiguration\n=============\n\nBonfire can be configured. It will look for a ``~/.bonfire.cfg`` or a ``bonfire.cfg`` (in the current directory). The\nconfiguration file can specify API nodes. If no host is specified a node with the name ``default`` will be used. You can\nalso configure queries which can be referenced by starting your query with a colon::\n\n [node:default]\n host=1.2.3.4\n port=12900\n username=jdoe\n\n [node:dev]\n host=4.3.2.1\n port=12900\n username=jdoe\n\n [query:example]\n query=facility:*foo* AND source:*bar*\n from=2015-03-01 15:00:00\n limit=100\n fields=message,name,facility,source\n\nNow you can run queries via such as::\n\n > bonfire --node=dev :example\n ... runs the example query on the node dev\n\n > bonfire :example\n ... runs the example query on the default node\n\nQuery Templates\n---------------\n\nOptions\n=======\n\nQueries\n=======\n\nKnown Bugs\n==========\n\n* bonfire expects graylog's timezone to be UTC.\n\nRelease Notes\n=============\n\n* v0.0.7: Issues fixes, TLS and Proxy support\n * Adds support for proxies\n * Adds support for https urls\n * Add timestamps to the dump format\n* v0.0.6: Documentation fix\n * Change of README.rst\n* v0.0.5: Clean up\n * Removed terminal UI ideas\n * Added first tests\n * Fixed date and time handling with timezones\n * Added python3 compatibility\n* v0.0.4: Extended documentation & stream access\n * Use the first stream the user has access to if no stream is specified and the user has no global search rights\n* v0.0.3: Small fixes\n * Use accept header in GET requests.\n * Fix bug when querying specific fields\n* v0.0.1: Initial release\n * Limited feature set.", "description_content_type": null, "docs_url": null, "download_url": null, "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "http://...", "keywords": null, "license": "new BSD", "maintainer": null, "maintainer_email": null, "name": "bonfire", "package_url": "https://pypi.org/project/bonfire/", "platform": "UNKNOWN", "project_url": "https://pypi.org/project/bonfire/", "project_urls": { "Homepage": "http://..." }, "release_url": "https://pypi.org/project/bonfire/0.0.7/", "requires_dist": null, "requires_python": null, "summary": "A CLI Graylog Client with Follow Mode", "version": "0.0.7" }, "last_serial": 3853836, "releases": { "0.0.5": [ { "comment_text": "", "digests": { "md5": "5e8fb8afcc18dcce3991f13a55cda939", "sha256": "4aef6567a951c0d4bab4383598c9069cf60b3253c9c77d27993a65ccd74c67f5" }, "downloads": -1, "filename": "bonfire-0.0.5.tar.gz", "has_sig": false, "md5_digest": "5e8fb8afcc18dcce3991f13a55cda939", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 14762, "upload_time": "2015-04-22T16:13:22", "url": "https://files.pythonhosted.org/packages/de/53/50d119ad8bcf06fb21e5fcf77124ae7b90d68c95bd5a85bcbdf33ead675a/bonfire-0.0.5.tar.gz" } ], "0.0.6": [ { "comment_text": "", "digests": { "md5": "ca7a42c350b42c6825c96e79009aaba9", "sha256": "1b5073d94df26965be963aa8341c34141df2133e9b5f08d72b5bd08d31dde6a6" }, "downloads": -1, "filename": "bonfire-0.0.6.tar.gz", "has_sig": false, "md5_digest": "ca7a42c350b42c6825c96e79009aaba9", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 14811, "upload_time": "2015-04-23T12:24:15", "url": "https://files.pythonhosted.org/packages/79/b4/4ec8a74ac4bef0036ba094653b31f5939ce85d55de1700b2b5ec23bd0e9f/bonfire-0.0.6.tar.gz" } ], "0.0.7": [ { "comment_text": "", "digests": { "md5": "9fb34f7003c05f7f4da64026479b88b7", "sha256": "c86ae11d716d899bcb2335dd6035f585e7e9126f43ec43a69d086c426eab369c" }, "downloads": -1, "filename": "bonfire-0.0.7.tar.gz", "has_sig": false, "md5_digest": "9fb34f7003c05f7f4da64026479b88b7", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 15051, "upload_time": "2016-09-13T15:41:12", "url": "https://files.pythonhosted.org/packages/d1/c1/7e48534f05dda345796088276a6a163bc21f0a0b11489b833fc0432a8c66/bonfire-0.0.7.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "9fb34f7003c05f7f4da64026479b88b7", "sha256": "c86ae11d716d899bcb2335dd6035f585e7e9126f43ec43a69d086c426eab369c" }, "downloads": -1, "filename": "bonfire-0.0.7.tar.gz", "has_sig": false, "md5_digest": "9fb34f7003c05f7f4da64026479b88b7", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 15051, "upload_time": "2016-09-13T15:41:12", "url": "https://files.pythonhosted.org/packages/d1/c1/7e48534f05dda345796088276a6a163bc21f0a0b11489b833fc0432a8c66/bonfire-0.0.7.tar.gz" } ] }