{ "info": { "author": "Ond\u0159ej T\u016fma", "author_email": "mcbig@zeropage.cz", "bugtrack_url": null, "classifiers": [ "Development Status :: 5 - Production/Stable", "Environment :: No Input/Output (Daemon)", "Intended Audience :: System Administrators", "License :: OSI Approved :: BSD License", "Operating System :: OS Independent", "Programming Language :: Python :: 3 :: Only", "Topic :: System :: Monitoring" ], "description": "MQTToRRD\n========\n\nLike as `MQTT2RRD `_ and it's forks,\nMQTToRRD create round robin database files from MQTT messages.\n\nTool daemon is based on ``poho-mqtt`` and ``python-daemon`` packages. All\ndependencies are listed in ``requirements.txt`` file. As Python 2.x\nis deprecated, tool is write for Python 3.5 or more only. For example\n``signal.Signals`` class is use.\n\nUsage\n-----\n\n.. code::\n\n usage: $(prog)s [options] command\n\n Create round robind database files form MQTT.\n\n positional arguments:\n command Daemon action (start|stop|restart|status)\n\n optional arguments:\n -h, --help show this help message and exit\n -c , --config \n Path to config file.\n -f, --foreground Run as script on foreground\n\nInstall\n-------\n\n.. code:: bash\n\n ~# pip3 install mqttorrd\n\nConfiguration\n-------------\n\n[daemon]\n~~~~~~~~\n:data_dir: Directory to store round robin database files. Default value is\n ``/var/lib/mqttorrd``.\n:pid_file: Path of file with pid. Default value is ``/var/run/mqttorrd.pid``.\n:user: Daemon user, default ``nobody``.\n:group: Daemon group, default ``nogroup``.\n\nData directory must be writer with user or group as pid file. Each value from\nMQTT broker is store to it's rrd file with path from topic. For example:\n``/var/lib/mqttorrd/garden/pool/temperature.rrd``.\n\n[logging]\n~~~~~~~~~\n:handler: Python logging handler. Possible values are ``file`` or ``syslog``.\n When tool is run at foreground, ``stderr`` handler is use. On UNIX\n like systems, `WatchedFileHandler\n `_\n is used. Defaults to ``syslog``.\n:syslog: Syslog connection, ``/dev/log`` by default. ``LOG_DAEMON`` facility\n is used.\n:file: Path to log file if ``file`` handler is used. Defaults to\n ``/var/log/mqttorrd.log``.\n:level: One of Python logging level: ``DEBUG, INFO, WARNING, ERROR,\n CRITICAL``. Default value is ``ERROR``.\n:format: Logging format. Default value is\n ``%(asctime)s %(levelname)s: %(name)s: %(message)s \"{%(funcName)s():%(lineno)d}``.\n\n[mqtt]\n~~~~~~\n:client_id: MQTT client id. If is not defined, it is generate automatically.\n:hostname: Broker hostname, ``localhost`` by default.\n:port: Broker port, ``1883`` is **allways** default.\n:keepalive: The keepalive timeout value for the client. Defaults to ``60``\n seconds.\n:tls: TLS connection, default ``False``.\n:ca_certs: Path to the Certificate Authority certificate. If is not set, system\n certs path is use.\n:certfile: Client public certificate file.\n:keyfile: Client primary key file.\n:username: Client username\n:password: Client password\n:subscriptions: Coma separated topics to subscribe. Default value is ``/#``.\n\n[/#]\n~~~~\nFor any topics could be defined own RRD parameters. MQTT characters like ``#``\nand ``+`` could be use. If new topic message was received,first definition,\nwhich is matched is used. If database file is exist yet, only value are update.\nFor more information see https://oss.oetiker.ch/rrdtool/doc/rrdcreate.en.html.\n\n:step: Round Robin Database step. Defaults to ``60`` seconds.\n:DS: Data source definition. Default value is\n ``DS:{topic}:GAUGE:120:U:U``, where ``{topic}`` is replaced with\n file name as last topics part.\n:RRA: Value archive definition. Default value is\n\n.. code::\n\n RRA:AVERAGE:0.5:2:30,\n RRA:AVERAGE:0.5:5:288,\n RRA:AVERAGE:0.5:30:336,\n RRA:AVERAGE:0.5:60:1488,\n RRA:AVERAGE:0.5:720:744,\n RRA:AVERAGE:0.5:1440:265\n\n", "description_content_type": "text/x-rst", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/ondratu/mqttorrd", "keywords": "", "license": "BSD", "maintainer": "", "maintainer_email": "", "name": "mqttorrd", "package_url": "https://pypi.org/project/mqttorrd/", "platform": "", "project_url": "https://pypi.org/project/mqttorrd/", "project_urls": { "Homepage": "https://github.com/ondratu/mqttorrd" }, "release_url": "https://pypi.org/project/mqttorrd/0.1.0/", "requires_dist": [ "rrdtool", "python-daemon", "lockfile", "paho-mqtt" ], "requires_python": ">=3.5", "summary": "Create round robind database files form MQTT messages.", "version": "0.1.0" }, "last_serial": 3978842, "releases": { "0.1.0": [ { "comment_text": "", "digests": { "md5": "9a9844a9c9ea56b1b689deacb5917fcc", "sha256": "613d0602797595d70ead1c73a0fb0643f336ed82b9591ffe237580d8c24c67ef" }, "downloads": -1, "filename": "mqttorrd-0.1.0-py3-none-any.whl", "has_sig": true, "md5_digest": "9a9844a9c9ea56b1b689deacb5917fcc", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.5", "size": 11647, "upload_time": "2018-06-19T19:56:39", "url": "https://files.pythonhosted.org/packages/00/88/4f74c47cbf2d4b345f9f56105e0d486a1fe1e422ba4a25d8676e1ca52393/mqttorrd-0.1.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "d25a2912146efa4830a400bb501e30ea", "sha256": "941c4afed0e5939771fd08e3d05427d0aeabc0eda5c9e0b0c1f9bfba5e71da47" }, "downloads": -1, "filename": "mqttorrd-0.1.0.tar.gz", "has_sig": true, "md5_digest": "d25a2912146efa4830a400bb501e30ea", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.5", "size": 9002, "upload_time": "2018-06-19T19:56:40", "url": "https://files.pythonhosted.org/packages/e1/73/a517fac656626153046d8897da1c64881d4b12ec2ae235e27a5e229c3563/mqttorrd-0.1.0.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "9a9844a9c9ea56b1b689deacb5917fcc", "sha256": "613d0602797595d70ead1c73a0fb0643f336ed82b9591ffe237580d8c24c67ef" }, "downloads": -1, "filename": "mqttorrd-0.1.0-py3-none-any.whl", "has_sig": true, "md5_digest": "9a9844a9c9ea56b1b689deacb5917fcc", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.5", "size": 11647, "upload_time": "2018-06-19T19:56:39", "url": "https://files.pythonhosted.org/packages/00/88/4f74c47cbf2d4b345f9f56105e0d486a1fe1e422ba4a25d8676e1ca52393/mqttorrd-0.1.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "d25a2912146efa4830a400bb501e30ea", "sha256": "941c4afed0e5939771fd08e3d05427d0aeabc0eda5c9e0b0c1f9bfba5e71da47" }, "downloads": -1, "filename": "mqttorrd-0.1.0.tar.gz", "has_sig": true, "md5_digest": "d25a2912146efa4830a400bb501e30ea", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.5", "size": 9002, "upload_time": "2018-06-19T19:56:40", "url": "https://files.pythonhosted.org/packages/e1/73/a517fac656626153046d8897da1c64881d4b12ec2ae235e27a5e229c3563/mqttorrd-0.1.0.tar.gz" } ] }