Repository
Munin (contrib)
Last change
2020-11-26
Graph Categories
Family
contrib
Capabilities
Keywords
Language
Python (3.x)
License
GPL-3.0-only

percona_

Sadly there is no documentation for this plugin.

#!/usr/bin/env python3
#
# Munin plugin for Percona XtraDB Cluster. Monitors values of these cluster replication variables:
# percona_queues: wsrep_local_recv_queue, wsrep_local_send_queue
# percona_flow: wsrep_flow_control_sent, wsrep_flow_control_recv
# percona_transactions: wsrep_replicated, wsrep_received
# percona_transactions_bytes: wsrep_replicated_bytes, wsrep_received_bytes
# percona_replication: wsrep_local_cert_failures, wsrep_local_bf_aborts
#
# created by Sven Schliesing
# borrowed code from mysql_aggregate_ by Igor Borodikhin
#
# License : GPLv3
#
# parsed environment variables:
# host: hostname or ip-address of Mysql server (default - localhost)
# port: port number of Mysql server (default - 3306)
# user: username to access Mysql server (default - empty)
# password: password of Mysql user (default - empty)
#
# ## Requirements
# This plugin requires pythons MySQLdb module which can be installed via easy_install.
#
# ## Installation
# Copy file to directory /usr/share/munin/plugins/ and create symbolic links for each type you wish
# to monitor:
# 	percona_flow
# 	percona_queues
# 	percona_replication
# 	percona_transactions
# 	percona_transactions_bytes
#
# Minimal config for monitoring local Percona XtraDB Cluster-Server:
#
#     [percona]
#     env.user root
#     env.password vErYsEcReT
#
#  #%# capabilities=autoconf
#  #%# family=contrib

import os
import sys
from warnings import filterwarnings

import MySQLdb
import MySQLdb.cursors

filterwarnings('ignore', category=MySQLdb.Warning)

program_name = os.path.basename(__file__)

variables = {
    'percona_queues': {
        'label': 'Queue sizes',
        'vlabel': 'size',
        'fields': ['wsrep_local_recv_queue', 'wsrep_local_send_queue']
    },
    'percona_flow': {
        'label': 'Flow control',
        'vlabel': '',
        'fields': ['wsrep_flow_control_sent', 'wsrep_flow_control_recv']
    },
    'percona_transactions': {
        'label': 'Transactions in and out',
        'vlabel': 'transactions',
        'fields': ['wsrep_replicated', 'wsrep_received']
    },
    'percona_transactions_bytes': {
        'label': 'Transactions in and out in bytes',
        'vlabel': 'bytes',
        'fields': ['wsrep_replicated_bytes', 'wsrep_received_bytes']
    },
    'percona_replication': {
        'label': 'Replication conflicts',
        'vlabel': 'conflicts',
        'fields': ['wsrep_local_cert_failures', 'wsrep_local_bf_aborts'],
    }
}

# Parse environment variables
# Mysql host
if "host" in os.environ and os.environ["host"] is not None:
    server = os.environ["host"]
else:
    server = "localhost"

# Mysql port
if "port" in os.environ and os.environ["port"] is not None:
    try:
        port = int(os.environ["port"])
    except ValueError:
        port = 3306
else:
    port = 3306

# Mysql username
if "user" in os.environ and os.environ["user"] is not None:
    login = os.environ["user"]
else:
    login = ""

# Mysql password
if "password" in os.environ and os.environ["password"] is not None:
    passw = os.environ["password"]
else:
    passw = ""

# Mysql connection handler
conn = None

label = variables[program_name]['label']
vlabel = variables[program_name]['vlabel']
fields = ["'{0}'".format(x) for x in variables[program_name]['fields']]

query = "show status where Variable_name in (%s)" % ', '.join(fields)

# Connect to mysql
try:
    conn = MySQLdb.connect(host=server, user=login, passwd=passw)
    cursor = conn.cursor()
except MySQLdb.Error as e:
    print("Error %d: %s" % (e.args[0], e.args[1]))
    sys.exit(1)


values = {}

if len(sys.argv) == 2 and sys.argv[1] == "autoconf":
    print("yes")
elif len(sys.argv) == 2 and sys.argv[1] == "config":

    print("graph_title %s" % label)
    print("graph_vlabel %s" % vlabel)
    print("graph_category db")
    print()

    try:
        cursor.execute(query)
        results = cursor.fetchall()

        for result in results:
            print("%s_size.label %s" % (result[0], result[0]))

    except MySQLdb.Error as e:
        print("Error %d: %s" % (e.args[0], e.args[1]))

else:
    try:
        cursor.execute(query)
        results = cursor.fetchall()

        for result in results:
            print("%s_size.value %s" % (result[0], result[1]))

    except MySQLdb.Error as e:
        print("Error %d: %s" % (e.args[0], e.args[1]))

if conn:
    conn.close()