Skip to main content

MySQL/MariaDB health checker — monitor connections, slow queries, replication status, and database size

Project description

dargslan-mysql-health

MySQL/MariaDB Health Checker — Monitor connections, slow queries, replication status, and database sizes. Zero external dependencies (uses mysql CLI client).

PyPI version License: MIT

Installation

pip install dargslan-mysql-health

CLI Usage

# Full health report
dargslan-mysql report

# Connection statistics
dargslan-mysql connections

# Slow query info
dargslan-mysql slow

# Database sizes
dargslan-mysql databases

# Replication status
dargslan-mysql replication

# All issues
dargslan-mysql issues

# JSON output
dargslan-mysql json

# Custom connection
dargslan-mysql report -H 10.0.0.5 -P 3306 -u admin

Python API

from dargslan_mysql_health import MySQLHealth

mh = MySQLHealth(host='localhost', user='root')

# Full audit
issues = mh.audit()

# Specific checks
conn = mh.connection_status()
slow = mh.slow_queries()
dbs = mh.database_sizes()
repl = mh.replication_status()

# Server info
info = mh.server_info()

# Formatted report
mh.print_report()

Health Checks

Check Severity Description
Connection usage >80% Warning Too many active connections
Connection usage >95% Critical Nearly maxed out connections
Slow query log off Info Slow query logging disabled
High slow queries Warning >1000 slow queries recorded
Replication broken Critical IO/SQL thread not running
Replication lag Warning >60 seconds behind master

Environment Variables

Variable Description
MYSQL_USER Default MySQL username
MYSQL_PASSWORD Default MySQL password

More from Dargslan

License

MIT — see LICENSE

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

dargslan_mysql_health-1.0.0.tar.gz (5.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

dargslan_mysql_health-1.0.0-py3-none-any.whl (6.9 kB view details)

Uploaded Python 3

File details

Details for the file dargslan_mysql_health-1.0.0.tar.gz.

File metadata

  • Download URL: dargslan_mysql_health-1.0.0.tar.gz
  • Upload date:
  • Size: 5.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.14

File hashes

Hashes for dargslan_mysql_health-1.0.0.tar.gz
Algorithm Hash digest
SHA256 7a4fc79a19aa876a131f3fbdae0e5906d6c4968016486a29e0c4a138145d061c
MD5 0984db932fb8174111325ea236dac4e6
BLAKE2b-256 db0afbc51aab4c334823b70bc7b386fc576bc22655142b992ac4e2aa3241dc41

See more details on using hashes here.

File details

Details for the file dargslan_mysql_health-1.0.0-py3-none-any.whl.

File metadata

File hashes

Hashes for dargslan_mysql_health-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 6963d2fdffc77571a82055b7ff09c6052a710a1d6ed71d38900d0c280ff1ba29
MD5 ceb9efa9ba726f5e92e40ebee5783236
BLAKE2b-256 312cef5bbf7aa55a26dc1b907150b402633364e5cf536eefe6de29f71439956a

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page