Mackerel client implemented by Python. (This version is similar with upstream)
Project description
mackerel.clienthde is a python library to access Mackerel (https://mackerel.io/).
This project is forked from heavenshell/py-mackerel-client, which is initially ported from mackerel-client-ruby.
Install
$ pip install mackerel.clienthdeDependency
mackerel.clienthde use requests, simplejson and click.
Usage
Get hosts
from mackerel.clienthde import Client
client = Client(mackerel_api_key='<Put your API key')
host = client.get_hosts()Get host
from mackerel.clienthde import Client
client = Client(mackerel_api_key='<Put your API key')
host = client.get_host('<hostId>')Update host status
from mackerel.clienthde import Client
client = Client(mackerel_api_key='<Put your API key')
# Poweroff.
self.client.update_host_status('<hostId>', 'poweroff')
# Standby.
self.client.update_host_status('<hostId>', 'standby')
# Working.
self.client.update_host_status('<hostId>', 'working')
# Maintenance.
self.client.update_host_status('<hostId>', 'maintenance')Retire host
from mackerel.clienthde import Client
client = Client(mackerel_api_key='<Put your API key')
self.client.retire_host('<hostId>')Get latest metrics
from mackerel.clienthde import Client
client = Client(mackerel_api_key='<Put your API key')
# Get hostId A's and hostId B's loadavg5, memory.free value.
metrics = self.client.get_latest_metrics(['<hostId A>', '<hostId B>'],
['loadavg5', 'memory.free'])Post metrics
from mackerel.clienthde import Client
client = Client(mackerel_api_key='<Put your API key>')
metrics = [
{
'hostId': '<hostId>', 'name': 'custom.metrics.loadavg',
'time': 1401537844, 'value': 1.4
},
{
'hostId': '<hostId>', 'name': 'custom.metrics.uptime',
'time': 1401537844, 'value': 500
}
]
# Post `custom.metrics.loadavg` and `custom.metrics.uptime` to `hostId`.
client.post_metrics(metrics)Post service metrics
from mackerel.clienthde import Client
client = Client(mackerel_api_key='<Put your API key>')
metrics = [
{
'name': 'custom.metrics.latency',
'time': 1401537844, 'value': 0.5
},
{
'name': 'custom.metrics.uptime',
'time': 1401537844, 'value': 500
}
]
# Post 'custom.metrics.latency' and 'custom.metrics.uptime' to `service_name`.
self.client.post_service_metrics('service_name', metrics)CLI
Get host(s) information from hostname or service, role.
$ mkr.py info [--name foo] [--service service] [--role role]Set status of a host.
$ mkr.py status --host-id foo --status workingRetire a host.
$ mkr.py retire --host-id fooGet status of a host.
$ mkr.py status --host-id fooAuthentication
$ export MACKEREL_APIKEY=foobar
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Close
Hashes for mackerel.clienthde-0.0.1-py2.7.egg
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 5c8db8fff409a3bbc56ac70d50015cf88e2cc9a5f55dbb9d7088c13dd574a316 |
|
| MD5 | c3d3cddec4595a0262bb9f453bb22f05 |
|
| BLAKE2b-256 | e22e3c4d6f68b6b501c128e7b4d7d43653d20ee969bf82ce9a373cde7fcbc640 |
