- Repository
- Munin (contrib)
- Last change
- 2020-10-24
- Graph Categories
- Family
- contrib
- Capabilities
- Keywords
- Language
- Python (2.x)
- License
- GPL-3.0-or-later
nanopool_
Name
nanopool_ - Munin plugin to monitor nanopool ethereum user data.
Configuration
[nanopool_*]
    - Copy to /usr/share/munin/plugins
    - Create symlinks in /etc/munin/plugins to nanopool_<graph type>_<account_address>,
      e.g. ln -s /usr/share/munin/plugins/nanopool_ /etc/munin/plugins/nanopool_hashrate_0x1234567890abcdef1234567890
      Please use the account address in the format "0x<address>".
    - To enable graphs, link to one or more of the graph types available
    - Then restart munin-node
Graph types and their links: balance: link to nanopool_balance Show current balance hashrate: link to nanopool_hashrate Show current calculated hashrate avghashrate: link to nanopool_avghashrate Show average hashrate of last hour worker: link to nanopool_worker Show worker data
Thanks to the authors of other Python munin plugins. I’ve used some of them as inspiring example.
Version
1.0.1
Author
License
This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program. If not, see <http://www.gnu.org/licenses/>.
SPDX-License-Identifier: GPL-3.0-or-later
Magic Markers
#%# family=contrib
#%# capabilities=suggest
#!/usr/bin/env python
# -*- coding: utf-8 -*-
# vim: set fileencoding=utf-8
"""
=head1 NAME
nanopool_ - Munin plugin to monitor nanopool ethereum user data.
=head1 CONFIGURATION
[nanopool_*]
        - Copy to /usr/share/munin/plugins
        - Create symlinks in /etc/munin/plugins to nanopool_<graph type>_<account_address>,
          e.g. ln -s /usr/share/munin/plugins/nanopool_ /etc/munin/plugins/nanopool_hashrate_0x1234567890abcdef1234567890
          Please use the account address in the format "0x<address>".
        - To enable graphs, link to one or more of the graph types available
        - Then restart munin-node
Graph types and their links:
        balance: link to nanopool_balance           Show current balance
        hashrate: link to nanopool_hashrate         Show current calculated hashrate
        avghashrate: link to nanopool_avghashrate   Show average hashrate of last hour
        worker: link to nanopool_worker             Show worker data
Thanks to the authors of other Python munin plugins. I've used some of
them as inspiring example.
=head1 VERSION
1.0.1
=head1 AUTHOR
L<Ralf Geschke|https://github.com/geschke>
=head1 LICENSE
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program.  If not, see <http://www.gnu.org/licenses/>.
SPDX-License-Identifier: GPL-3.0-or-later
=head1 MAGIC MARKERS
 #%# family=contrib
 #%# capabilities=suggest
=cut
"""
from __future__ import print_function
import os
import sys
import json
try:
    # Python 3
    from urllib.request import Request
    from urllib.request import urlopen
    from urllib.request import URLError
except:
    # Python 2
    from urllib2 import Request
    from urllib2 import urlopen
    from urllib2 import URLError
def define_graph_types():
    graph_types = {
        "balance" : [
            {
                "title" : "Balance of {0}".format(account_address),
                "type" : "GAUGE",
                "args" : "--base 1000 -l 0",
                "fields" : ["ETH"],
                "scale": "no",
                "info": "Balance in ETH"
            }
        ],
        "hashrate" : [
            {
                "title" : "Hashrate of {0}".format(account_address),
                "type" : "GAUGE",
                "args" : "--base 1000 -l 0",
                "fields" : ["hashrate"],
                "info": "Current Calculated Hashrate in Mh/s"
            }
        ],
        "avghashrate" : [
            {
                "title" : "Average Hashrate of {0}".format(account_address),
                "type" : "GAUGE",
                "args" : "--base 1000 -l 0",
                "fields" : ["avg_hashrate"],
                "info": "Average Hashrate of last hour in Mh/s"
            }
        ],
        "worker" : [
            {
                "title" : "Worker"
            }
        ]
    }
    return graph_types
def request_data():
    url = "https://api.nanopool.org/v1/eth/user/{0}".format(account_address)
    req = Request(url)
    # this fake is necessary to get values, otherwise the request ends in a 403 error
    req.add_header('User-Agent', 'Nozilla/5.0')
    try:
        txt = urlopen(req).read()
    except URLError as err:
        print("API request error: {0}". format(err), file=sys.stderr)
        exit(1)
    except:
        print("Unhandled error:", sys.exc_info()[0])
        exit(1)
    try:
        result = json.loads(txt.decode("utf-8"))
    except ValueError as err:
        print("Could not decode JSON error: {0}". format(err), file=sys.stderr)
        exit(1)
    return result
def write_config_worker():
    data = request_data()
    worker_data = sorted(data["data"]["workers"], key=lambda element: element["id"])
    print("multigraph worker_hashrate_{0}".format(account_address))
    print("graph_title Hashrate in Mh/s per worker ({0})".format(account_address))
    print("graph_args --base 1000 -l 0")
    print("graph_vlabel Mh/s")
    print("graph_category htc")
    print("graph_scale no")
    for val in worker_data:
        worker_name = "_".join(val["id"].split())
        print("worker_{0}_hashrate.label {1}".format(worker_name, val["id"]))
        print("worker_{0}_hashrate.type GAUGE".format(worker_name))
        print("worker_{0}_hashrate.info Hashrate of worker '{1}'".format(worker_name, val["id"]))
        print("worker_{0}_hashrate.min 0".format(worker_name))
        print("worker_{0}_hashrate.draw LINE1".format(worker_name))
    for val in worker_data:
        print("")
        worker_name = "_".join(val["id"].split())
        print("multigraph worker_hashrate_{0}.worker_{1}".format(account_address, worker_name))
        print("graph_title Hashrate in Mh/s of worker {0}".format(worker_name))
        print("graph_args --base 1000 -l 0")
        print("graph_vlabel Mh/s")
        print("graph_category htc")
        print("graph_scale no")
        print("whashrate.label hashrate")
        print("whashrate.type GAUGE")
        print("whashrate.info Hashrate of worker {0}".format(val["id"]))
        print("whashrate.min 0")
        print("whashrate.draw LINE1")
    print("")
    print("multigraph worker_shares_{0}".format(account_address))
    print("graph_title Number of accepted shares ({0})".format(account_address))
    print("graph_args --base 1000 -l 0")
    print("graph_vlabel Shares per ${graph_period}")
    print("graph_category htc")
    print("graph_scale no")
    print("graph_period minute")
    for val in worker_data:
        worker_name = "_".join(val["id"].split())
        print("worker_{0}_shares.label {1} ".format(worker_name, val["id"]))
        print("worker_{0}_shares.type COUNTER".format(worker_name))
        print("worker_{0}_shares.info Accepted shares of worker '{1}'".format(worker_name, val["id"]))
        print("worker_{0}_shares.min 0".format(worker_name))
        print("worker_{0}_shares.draw LINE1".format(worker_name))
    for val in worker_data:
        worker_name = "_".join(val["id"].split())
        print("")
        print("multigraph worker_shares_{0}.worker_{1}".format(account_address, worker_name))
        print("graph_title Number of accepted shares {0}".format(worker_name))
        print("graph_args --base 1000 -l 0")
        print("graph_vlabel Shares per ${graph_period}")
        print("graph_category htc")
        print("graph_scale no")
        print("graph_period minute")
        print("wshares.label shares")
        print("wshares.type COUNTER")
        print("wshares.info Accepted shares of worker '{0}'".format(val["id"]))
        print("wshares.min 0")
        print("wshares.draw LINE1")
def write_data_worker(data):
    worker_data = sorted(data["data"]["workers"], key=lambda element: element["id"])
    print("multigraph worker_hashrate_{0}".format(account_address))
    for val in worker_data:
        worker_name = "_".join(val["id"].split())
        print("worker_{0}_hashrate.value {1}".format(worker_name, val["hashrate"]))
    for val in worker_data:
        print("")
        worker_name = "_".join(val["id"].split())
        print("multigraph worker_hashrate_{0}.worker_{1}".format(account_address, worker_name))
        print("whashrate.value {0}".format(val["hashrate"]))
    print("")
    print("multigraph worker_shares_{0}".format(account_address))
    for val in worker_data:
        worker_name = "_".join(val["id"].split())
        print("worker_{0}_shares.value {1}".format(worker_name, val["rating"]))
    for val in worker_data:
        worker_name = "_".join(val["id"].split())
        print("")
        print("multigraph worker_shares_{0}.worker_{1}".format(account_address, worker_name))
        print("wshares.value {0} ".format(val["rating"]))
def write_config():
    if graph_type not in GRAPH_TYPES.keys():
        print("Unknown graph type '{0}'".format(graph_type), file=sys.stderr)
        exit(1)
    if graph_type == "worker":
        write_config_worker()
        return
    params = GRAPH_TYPES[graph_type]
    for item in params:
        print("graph_title {0}".format(item["title"]))
        print("graph_category htc")
        if "info" in item:
            print("graph_info {0}".format(item["info"]))
        if "scale" in item:
            print("graph_scale {0}".format(item["scale"]))
        if "args" in item:
            print("graph_args {0}".format(item["args"]))
        for field in item["fields"]:
            print("{0}.label {1}".format(field, field))
            print("{0}.type {1}".format(field, item["type"]))
def write_suggest():
    for item in GRAPH_TYPES.keys():
        print(item)
def write_data():
    data = request_data()
    if graph_type == "balance":
        print("ETH.value {0}".format(data['data']['balance']))
    elif graph_type == "hashrate":
        print("hashrate.value {0}".format(data["data"]["hashrate"]))
    elif graph_type == "avghashrate":
        print("avg_hashrate.value {0}".format(data["data"]["avgHashrate"]["h1"]))
    elif graph_type == "worker":
        write_data_worker(data)
    else:
        pass
if __name__ == "__main__":
    program = sys.argv[0]
    try:
        graph_type, account_address = program.split("_")[1:]
    except ValueError:
        print("Please configure the plugin as described in the configuration section.")
        exit(1)
    GRAPH_TYPES = define_graph_types()
    if len(sys.argv) > 1 and sys.argv[1] == "config":
        write_config()
    elif len(sys.argv) > 1 and sys.argv[1] == "suggest":
        write_suggest()
    else:
        write_data()