{ "info": { "author": "Shinya Ohyanagi, Iskandar Setiadi", "author_email": "iskandarsetiadi@gmail.com", "bugtrack_url": null, "classifiers": [ "Development Status :: 4 - Beta", "Environment :: Web Environment", "Intended Audience :: Developers", "License :: OSI Approved :: BSD License", "Operating System :: OS Independent", "Programming Language :: Python" ], "description": "mackerel.clienthde\n==================\n.. image:: https://travis-ci.org/HDE/py-mackerel-client.svg?branch=hde-dev\n :target: https://travis-ci.org/HDE/py-mackerel-client\n\n.. image:: https://coveralls.io/repos/github/HDE/py-mackerel-client/badge.svg?branch=hde-dev\n :target: https://coveralls.io/github/HDE/py-mackerel-client?branch=hde-dev\n\nmackerel.clienthde is a python library to access Mackerel (https://mackerel.io/).\n\nThis project is forked from `heavenshell/py-mackerel-client `_, which is initially ported from `mackerel-client-ruby `_.\n\nInstall\n-------\n\n.. code:: shell\n\n $ pip install mackerel.clienthde\n\n\nDependency\n----------\n\nmackerel.clienthde use `requests `_, `simplejson `_ and `click `_.\n\nUsage\n-----\nGet hosts\n~~~~~~~~~\n\n.. code:: python\n\n from mackerel.clienthde import Client\n\n # Alternatively, you can set MACKEREL_APIKEY as environment variable\n # And simply call \"client = Client()\"\n client = Client(mackerel_api_key='')\n\n\nUpdate host status\n~~~~~~~~~~~~~~~~~~\n\n.. code:: python\n\n from mackerel.clienthde import Client\n\n # Alternatively, you can set MACKEREL_APIKEY as environment variable\n # And simply call \"client = Client()\"\n client = Client(mackerel_api_key='', 'poweroff')\n # Standby.\n self.client.update_host_status('', 'standby')\n # Working.\n self.client.update_host_status('', 'working')\n # Maintenance.\n self.client.update_host_status('', 'maintenance')\n\nRetire host\n~~~~~~~~~~~\n\n.. code:: python\n\n from mackerel.clienthde import Client\n\n # Alternatively, you can set MACKEREL_APIKEY as environment variable\n # And simply call \"client = Client()\"\n client = Client(mackerel_api_key='')\n\n\nGet latest metrics\n~~~~~~~~~~~~~~~~~~\n\n.. code:: python\n\n from mackerel.clienthde import Client\n\n # Alternatively, you can set MACKEREL_APIKEY as environment variable\n # And simply call \"client = Client()\"\n client = Client(mackerel_api_key='', ''],\n ['loadavg5', 'memory.free'])\n\n\n\nPost metrics\n~~~~~~~~~~~~\n.. code:: python\n\n from mackerel.clienthde import Client\n\n # Alternatively, you can set MACKEREL_APIKEY as environment variable\n # And simply call \"client = Client()\"\n client = Client(mackerel_api_key='')\n metrics = [\n {\n 'hostId': '', 'name': 'custom.metrics.loadavg',\n 'time': 1401537844, 'value': 1.4\n },\n {\n 'hostId': '', 'name': 'custom.metrics.uptime',\n 'time': 1401537844, 'value': 500\n }\n\n ]\n # Post `custom.metrics.loadavg` and `custom.metrics.uptime` to `hostId`.\n client.post_metrics(metrics)\n\n\nPost service metrics\n~~~~~~~~~~~~~~~~~~~~\n.. code:: python\n\n from mackerel.clienthde import Client\n\n # Alternatively, you can set MACKEREL_APIKEY as environment variable\n # And simply call \"client = Client()\"\n client = Client(mackerel_api_key='')\n metrics = [\n {\n 'name': 'custom.metrics.latency',\n 'time': 1401537844, 'value': 0.5\n },\n {\n 'name': 'custom.metrics.uptime',\n 'time': 1401537844, 'value': 500\n }\n ]\n # Post 'custom.metrics.latency' and 'custom.metrics.uptime' to `service_name`.\n self.client.post_service_metrics('service_name', metrics)\n\n\nGet monitors [NEW in this forked version]\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n.. code:: python\n\n from mackerel.clienthde import Client\n\n # Alternatively, you can set MACKEREL_APIKEY as environment variable\n # And simply call \"client = Client()\"\n client = Client(mackerel_api_key='',\n 'warning': 700,\n 'critical': 900\n }\n # Post params to Mackerel\n # result['id'] will give Monitor id if create operation succeeded\n result = client.create_monitor(params)\n\n\nUpdate monitor [NEW in this forked version]\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n.. code:: python\n\n from mackerel.clienthde import Client\n\n # Alternatively, you can set MACKEREL_APIKEY as environment variable\n # And simply call \"client = Client()\"\n client = Client(mackerel_api_key='