{"id":20119613,"url":"https://github.com/box/raingauge","last_synced_at":"2025-05-06T14:32:42.226Z","repository":{"id":4163441,"uuid":"5278423","full_name":"box/RainGauge","owner":"box","description":"RainGauge","archived":false,"fork":false,"pushed_at":"2021-12-08T23:40:03.000Z","size":284,"stargazers_count":106,"open_issues_count":18,"forks_count":33,"subscribers_count":54,"default_branch":"develop","last_synced_at":"2024-05-14T00:02:50.644Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/box.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2012-08-02T22:01:49.000Z","updated_at":"2023-12-25T06:32:06.000Z","dependencies_parsed_at":"2022-09-09T08:22:42.701Z","dependency_job_id":null,"html_url":"https://github.com/box/RainGauge","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/box%2FRainGauge","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/box%2FRainGauge/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/box%2FRainGauge/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/box%2FRainGauge/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/box","download_url":"https://codeload.github.com/box/RainGauge/tar.gz/refs/heads/develop","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":224509404,"owners_count":17323079,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-13T19:16:18.444Z","updated_at":"2024-11-13T19:16:20.174Z","avatar_url":"https://github.com/box.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n\nBox Rain Gauge\n==============\n[![Project Status](http://opensource.box.com/badges/maintenance.svg)](http://opensource.box.com/badges)\n[![Travis](https://img.shields.io/travis/box/RainGauge.svg?maxAge=2592000)](https://travis-ci.org/box/RainGauge)\n[![Join the chat at https://gitter.im/box/Anemometer](https://badges.gitter.im/box/RainGauge.svg)](https://gitter.im/box/RainGauge?utm_source=badge\u0026utm_medium=badge\u0026utm_campaign=pr-badge\u0026utm_content=badge)\n\n\nRain Gauge is a tool to simplify the process of collecting detailed information from mysql database servers when specific conditions are triggered.  Collections are packaged and centralised in one place, with a convenient web interface to let you explore the data easily.  This tool uses a modified version of the percona toolkit script pt-stalk to handle collecting data from remote servers.\n\n## Quickstart\n\nInstallation consists of two parts: setting up the web interface, and setting up the collector.\n\n### Setting up the web interface\n\nInstallation of the web interface is super simple!  Just clone the RainGauge project in the document root of your webserver:\n\n\tgit clone git://github.com/box/RainGauge.git\n\nThere are a few things to configure in the conf/config.inc.php file if you want, but those aren't necessary\n\n### Installing the collection scripts\n\nThe collection scripts are a bit more involved. You'll want to create a separate user account in mysql.  You'll also need to customise a couple of the scripts to put in the address of the web server where you installed the web interface, and change and options you may want to send to pt-stalk.  Then you'll install a service and start it.\n\n#### Install the scripts\n\n    cp RainGauge/scripts/raingauge_package_and_send.sh /usr/bin/\n    cp RainGauge/scripts/pt-stalk-raingauge /usr/bin/\n\n#### Set up the package and send script\n\n    vi /usr/bin/raingauge_package_and_send.sh\n\n  Now change SERVER='' to be the web server where you installed the interface.  The collection script will do a http post to copy collected data to a central location\n\n#### Set up a new database user in mysql\n\n    mysql -uroot -e \"GRANT PROCESS, SUPER ON *.* TO 'raingauge'@'localhost' IDENTIFIED BY 'SuperSecurePass'\"\n\n#### Add the raingauge service\n\n    cp RainGauge/scripts/raingauge_rc /etc/raingauge_rc\n    cp RainGauge/scripts/raingauge_service /etc/init.d/raingauge\n\n#### Edit the rc file to set up options\n\n    vi /etc/raingauge_rc\n\n  Edit the following line to use the same password you created for the mysql user:\n\n    PT_MYSQL_PASS=''\n\n#### Start the service\n\n    sudo service raingauge start\n\n#### Install a cleanup cron\n\n  You will probably want to clean up old collections after a while, try 2 days to start:\n\n    [[ -d /www/RainGauge/collected/ ]] \u0026\u0026 find /www/RainGauge/collected/ -mindepth 1 -mtime +2 -exec rm -rf {} \\;\n\n\n## Copyright and License\n\nCopyright 2014 Box, Inc. All rights reserved.\n\nLicensed under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License.\nYou may obtain a copy of the License at\n\n   http://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software\ndistributed under the License is distributed on an \"AS IS\" BASIS,\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\nSee the License for the specific language governing permissions and\nlimitations under the License.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbox%2Fraingauge","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbox%2Fraingauge","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbox%2Fraingauge/lists"}