{ "info": { "author": "Marcin Bachry", "author_email": "hegel666@gmail.com", "bugtrack_url": null, "classifiers": [ "Development Status :: 4 - Beta", "Intended Audience :: Developers", "License :: OSI Approved :: MIT License", "Natural Language :: English", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.5", "Programming Language :: Python :: 3.6" ], "description": "awslogs-sd\n==========\n\n.. image:: https://travis-ci.org/mbachry/awslogs-sd.svg?branch=master\n :alt: Build status\n :target: https://travis-ci.org/mbachry/awslogs-sd\n\nForward systemd journal logs to CloudWatch.\n\nA log forwarder daemon similar to Amazon's awslogs agent, but using\nper systemd unit journal output instead of text log files.\n\nInstalling\n----------\n\nUse your system package manager to install systemd Python 3\nbinding. The required package is named ``python3-systemd`` both in\nUbuntu and Fedora::\n\n dnf install python3-systemd\n\nIf on Ubuntu, install ``python3-venv`` too::\n\n apt install python3-venv\n\nCreate dedicated virtualenv for awslogs-sd::\n\n python3 -m venv --system-site-packages /opt/awslogs-sd\n /opt/awslogs-sd/bin/pip install wheel\n\nAnd finally::\n\n /opt/awslogs-sd/bin/pip install awslogs-sd\n\nDaemon binary will be available under\n``/opt/awslogs-sd/bin/awslogs-sd``.\n\nAWS setup\n---------\n\nSimilarly to Amazon's awslogs, ``awslogs-sd`` requires an IAM policy\nattached to EC2 instance. Configuration is the same as in `Amazon\nawslogs documentation`_.\n\n.. _Amazon awslogs documentation: https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/QuickStartEC2Instance.html\n\nUsage\n-----\n\n``awslogs-sd`` requires path to configuration file as a positional\nargument.\n\nYou can use ``--logging-conf`` to pass optional YAML logging\nconfiguration in ``dictConfig`` format. See `Python logging\ndocumentation`_. Following loggers can be configured:\n\n* ``awslogs``: main daemon logger\n\n* ``metrics``: daemon statistics printed at ``INFO`` level every 10\n seconds\n\n.. _Python logging documentation: https://docs.python.org/2/library/logging.config.html#configuration-dictionary-schema\n\nConfiguration\n-------------\n\nConfiguration file uses ini format and is designed to be similar to\nAmazon `awslogs configuration`_.\n\nThere are two main ini sections ``general`` and ``include``. Every\nother section has arbitrary name and contains a single systemd unit\nconfiguration.\n\n.. _awslogs configuration: https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AgentReference.html\n\n``general``\n~~~~~~~~~~~\n\nFollowing option is required:\n\n* ``state_file``: path to daemon database. Must be in persistent storage.\n\nExample::\n\n [general]\n state_file = /var/lib/awslogs-sd/state\n\n``include``\n~~~~~~~~~~~\n\nOptional section with a single option:\n\n* ``path``: an Unix glob pattern to specify locations of additional\n configuration files to load and merge with main one. Used mostly to\n support popular ``conf.d`` drop-in pattern.\n\nExample::\n\n [include]\n path = /etc/awslogs-sd.conf.d/*.conf\n\nUnit sections\n~~~~~~~~~~~~~\n\nExample::\n\n [httpd_error]\n unit = httpd.service\n priority = ERR\n syslog_ident = httpd_error\n syslog_facility = local1\n log_group_name = httpd-access\n log_stream_name = {instance_id}\n\nFollowing options are supported:\n\n* ``unit`` (required): systemd unit name\n\n* ``log_group_name`` (required): destination CloudWatch log group\n\n* ``log_stream_name`` (required): CloudWatch stream name inside group;\n support basic variable interpolation (see below)\n\n* ``priority``: minimum journal priority to match (default:\n ``INFO``). See `Arch wiki`_.\n\n* ``format``: output log format, one of ``text`` or ``json`` (default:\n ``text``)\n\n* ``datetime_format``: datetime format in strftime format if text\n output is used (default: ``%b %d %H:%M:%S``)\n\n* ``syslog_ident``: match by syslog ident (aka \"tag\") if syslog\n transport is used\n\n* ``syslog_facility``: match by syslog facility if syslog transport is\n used\n\n.. _Arch wiki: https://wiki.archlinux.org/index.php/systemd#Journal\n\nStream name variables\n~~~~~~~~~~~~~~~~~~~~~\n\nStream names support variable interpolation with ``{var}``\nsyntax. Following variables are available:\n\n* ``instance_id``: local EC2 instance id\n\n* ``hostname``: machine hostname\n\n\n", "description_content_type": null, "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/mbachry/awslogs-sd", "keywords": "", "license": "MIT", "maintainer": "", "maintainer_email": "", "name": "awslogs-sd", "package_url": "https://pypi.org/project/awslogs-sd/", "platform": "", "project_url": "https://pypi.org/project/awslogs-sd/", "project_urls": { "Homepage": "https://github.com/mbachry/awslogs-sd" }, "release_url": "https://pypi.org/project/awslogs-sd/0.5/", "requires_dist": [ "awscli-cwlogs", "boto3", "gevent", "pyyaml", "requests", "retrying", "systemd-python" ], "requires_python": "", "summary": "Forward systemd journal logs to cloudwatch", "version": "0.5" }, "last_serial": 3553181, "releases": { "0.1": [ { "comment_text": "", "digests": { "md5": "6deb7f133064bd7a3bb8d0489c2aa36f", "sha256": "b9f8ad75d7513e01bc1ba9e0a900da2dc9e28c8226e9c0d68ac9047060644b18" }, "downloads": -1, "filename": "awslogs_sd-0.1-py3-none-any.whl", "has_sig": true, "md5_digest": "6deb7f133064bd7a3bb8d0489c2aa36f", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 10677, "upload_time": "2018-01-25T17:23:53", "url": "https://files.pythonhosted.org/packages/9c/b7/e18daff5bd5aba43b2715cef327ab39a3d6e0a3cbd5fea8564ef93902822/awslogs_sd-0.1-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "6e65a78f471ced411258e57bb22d2a45", "sha256": "511b4022b81e5ccec3d35261ca196bb2c5bcc6e46d24584a87037cb79b947661" }, "downloads": -1, "filename": "awslogs-sd-0.1.tar.gz", "has_sig": true, "md5_digest": "6e65a78f471ced411258e57bb22d2a45", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 11615, "upload_time": "2018-01-25T17:23:55", "url": "https://files.pythonhosted.org/packages/c3/2c/84e2d233512a0b19ecc75ad703bfc08590e2919b2108b90d6e9ea4862614/awslogs-sd-0.1.tar.gz" } ], "0.2": [ { "comment_text": "", "digests": { "md5": "6f57f5994c7ea4c63a610effe4f0de0f", "sha256": "dd090f3391be68375da722a891cc6428ae8c6a597689823c2acbd79222e266b6" }, "downloads": -1, "filename": "awslogs_sd-0.2-py3-none-any.whl", "has_sig": true, "md5_digest": "6f57f5994c7ea4c63a610effe4f0de0f", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 10752, "upload_time": "2018-01-25T17:33:53", "url": "https://files.pythonhosted.org/packages/61/ba/55d0017612a4792131e02cd28b76ac9385514ae53cad73a749a42178f03d/awslogs_sd-0.2-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "b3bf0faf0f9446f247d1df719c505075", "sha256": "27ea2ac9dfbed1a45123b11a967108bb2bc58e71fab4ea2205e0799d7f3d9514" }, "downloads": -1, "filename": "awslogs-sd-0.2.tar.gz", "has_sig": true, "md5_digest": "b3bf0faf0f9446f247d1df719c505075", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 11715, "upload_time": "2018-01-25T17:33:55", "url": "https://files.pythonhosted.org/packages/27/12/da5529330190c969b65a56c27d39c408e6782f3b995326f3686e2a6cfcd7/awslogs-sd-0.2.tar.gz" } ], "0.3": [ { "comment_text": "", "digests": { "md5": "2de0e05bcc35b485022d17988336d122", "sha256": "e3dd3b11b026d835447ac5ab3763dd4679ec350de9fafef65545e3d4f2d41b53" }, "downloads": -1, "filename": "awslogs_sd-0.3-py3-none-any.whl", "has_sig": true, "md5_digest": "2de0e05bcc35b485022d17988336d122", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 10755, "upload_time": "2018-01-25T19:13:14", "url": "https://files.pythonhosted.org/packages/37/d7/91433c3196bb8a7620497a7c2b00716cc60166e3d58aaa33dcd3eea422e0/awslogs_sd-0.3-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "7023a1cfa7b56f09e1bd435cd6c06972", "sha256": "4f8f89a504d789bee8ce7841c22596210a50941204cbafdc3bb36b802c412e13" }, "downloads": -1, "filename": "awslogs-sd-0.3.tar.gz", "has_sig": true, "md5_digest": "7023a1cfa7b56f09e1bd435cd6c06972", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 11728, "upload_time": "2018-01-25T19:13:16", "url": "https://files.pythonhosted.org/packages/8b/41/b679be9813b6034c8ad66cfc6685b295275aa0dd69d33e3a86fe57f3778c/awslogs-sd-0.3.tar.gz" } ], "0.4": [ { "comment_text": "", "digests": { "md5": "67f9955e813bd49e8cec0f8bb7aeae5e", "sha256": "d5be7fe80afd139b6d04beb10bc6257327eed198a45289830464b60516014357" }, "downloads": -1, "filename": "awslogs_sd-0.4-py3-none-any.whl", "has_sig": true, "md5_digest": "67f9955e813bd49e8cec0f8bb7aeae5e", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 10824, "upload_time": "2018-01-27T12:10:35", "url": "https://files.pythonhosted.org/packages/88/29/5d9acd7624e92442f3dfef242d76be20fdec7cbe42e123bd50a92b634f92/awslogs_sd-0.4-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "bc41e4832959772a6e1df13156512e35", "sha256": "3ccb11f36a54b422d27cfdfefcb9edbb0b02d50dbdd32cd486ca79e9ca2267eb" }, "downloads": -1, "filename": "awslogs-sd-0.4.tar.gz", "has_sig": true, "md5_digest": "bc41e4832959772a6e1df13156512e35", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 11847, "upload_time": "2018-01-27T12:10:36", "url": "https://files.pythonhosted.org/packages/3c/e4/eabfd13bfc401c9b0174a487f477dcc96294e7eeda8fa6506d3684341672/awslogs-sd-0.4.tar.gz" } ], "0.5": [ { "comment_text": "", "digests": { "md5": "394ef52b3bd704ecd6e781bcdc049c3b", "sha256": "b9f8e13ca249a7a1d24831b806b271dec8409906dcd38909d5d6f2f9a63546ca" }, "downloads": -1, "filename": "awslogs_sd-0.5-py3-none-any.whl", "has_sig": true, "md5_digest": "394ef52b3bd704ecd6e781bcdc049c3b", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 10832, "upload_time": "2018-02-05T12:31:12", "url": "https://files.pythonhosted.org/packages/fe/87/f0ea89b8b96dc3c0ccfe7ede5c4aeb441765c7199fb805cdab7dc581b385/awslogs_sd-0.5-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "4a8c4a67bc5958e1b28b9d9d6e7b128d", "sha256": "6d37e2396abb76fefef563ed9528c702becff6dd2428123ea439c003af54cdf2" }, "downloads": -1, "filename": "awslogs-sd-0.5.tar.gz", "has_sig": true, "md5_digest": "4a8c4a67bc5958e1b28b9d9d6e7b128d", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 11893, "upload_time": "2018-02-05T12:31:15", "url": "https://files.pythonhosted.org/packages/71/52/037f1b25cd4024274c5b31b291a0e998fb17105ef82ee5336438fdd059e7/awslogs-sd-0.5.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "394ef52b3bd704ecd6e781bcdc049c3b", "sha256": "b9f8e13ca249a7a1d24831b806b271dec8409906dcd38909d5d6f2f9a63546ca" }, "downloads": -1, "filename": "awslogs_sd-0.5-py3-none-any.whl", "has_sig": true, "md5_digest": "394ef52b3bd704ecd6e781bcdc049c3b", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 10832, "upload_time": "2018-02-05T12:31:12", "url": "https://files.pythonhosted.org/packages/fe/87/f0ea89b8b96dc3c0ccfe7ede5c4aeb441765c7199fb805cdab7dc581b385/awslogs_sd-0.5-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "4a8c4a67bc5958e1b28b9d9d6e7b128d", "sha256": "6d37e2396abb76fefef563ed9528c702becff6dd2428123ea439c003af54cdf2" }, "downloads": -1, "filename": "awslogs-sd-0.5.tar.gz", "has_sig": true, "md5_digest": "4a8c4a67bc5958e1b28b9d9d6e7b128d", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 11893, "upload_time": "2018-02-05T12:31:15", "url": "https://files.pythonhosted.org/packages/71/52/037f1b25cd4024274c5b31b291a0e998fb17105ef82ee5336438fdd059e7/awslogs-sd-0.5.tar.gz" } ] }