Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Application for obtaining growth-over-time info for a MySQL cluster.
Clojure JavaScript
branch: master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
sample configuration/databases
src/data_obtainer
test/data_obtainer
.gitattributes
.gitignore
README.md
license.txt
project.clj

README.md

Data-obtainer

Application for obtaining growth-over-time info for a MySQL cluster. This application requires a java runtime being available.

License

Copyright © 2012 Matan Safriel. Distributed under the Eclipse Public License 1.0, the same as Clojure. This application redistributes the MySQL Connector/J JDBC driver under the Oracle FOSS License Exception.

Setup & Configuration

Configuration

Databases/databases.cfg should contain all configuration data, one clause per MySQL database. For making the initial configuration, see here. It's OK to change the configuration in between runs.

Prerequisite Permissions (MySQL)

To pull metadata, information_schema access for the relevant schema is necessary. This can only be accomplished by providing read access to the database schema of interest. E.g. by using: GRANT SELECT ON db-name.* TO user-name; whereas if desired, a new MySQL user can first be defined for this sake, e.g. via CREATE USER user-name IDENTIFIED BY 'password'; .

Security Considerations (Operating System)

This program needs to authenticate to MySQL. Unless certificate-based client authentication or MySQL authentication plugins are employed, a user name and password need to be available to it. At present those are supplied through the configuration file described above. They may also appear in this program's log or error traces. It is therefore highly recommended to restrict access to this program's installation directory, or to employ a stronger MySQL authentication scheme eliminating the need for password based authentication.

Usage

Each run of this program captures and appends the current state for all databases defined to it at databases/databases.cfg. The data accumulates in a simple CSV file, named data.csv. Information is time-stamped with the local time. It's OK to delete this file for cleaning up or starting a fresh accumulation. If using Excel to view its content, make sure to only view a copy, as opening the original in Excel would block accumulation of more data.

Download here, unzip and open a command-line at the directory. Execute: java -jar data-obtainer.jar

Something went wrong with that request. Please try again.