KBase Metrics repo
This repo contains code for gathering/loading KBase usage metrics.
Usage
Before being able to run this docker container a ".env" file needs to be made. It should be called .env (nothing before the dot). cp the example.env to .env Then alter the file to include the correct information.
The script in hooks/build is used to build a docker image named "metrics" from the current contents of the repo. You can simply run it by
hooks/build
It fulls in import metadata about the docker image, and is used by the dockerhub and travis automated build machinery.
After the image is built, you can use the docker-compose command to run the image using the environment variables defined in the .env file mentioned above:
docker-compose run --rm metrics
That will take you into t150ca6f61fb2411e607f15fb91407a83305daaf6he docker environment (source folder of the metrics repo). From there you can run any program in that folder.
If want to run a shell script. Here is an exmple with capturing the redirect in the environment that called Docker.
docker-compose > user_info_dump.txt run metrics ../bin/custom_scripts/dump_query_results.sh
Put executables in the bin directory we will call scripts this way for the CRON jobs The cron jobs should run the following: docker-compose run --rm metrics ../bin/master_cron_shell.sh
this under the hood calls source/daily/upload_user_stats.py source/daily/upload_app_stats.py source//daily/upload_app_category_mappings.py source/daily/upload_public_narratives_count.py source/daily/make_reporting_tables.py
CRON Jobs are run from mysql-metrics
They are stored at: crontab -e on mysql-metrics
There are nightly CRON jobs that get run are located in bin/master_cron_shell.sh which runs scripts from the source/daily directory
Then there are also monthly CRON jobs that get run are located in bin/upload_workspace_stats.sh It used to be workspaces (user info needed first for FK potential issues), but now it also conatins scripts for DOI metrics.) Runs scripts from source/monthly directory
These create Logs to keep track of (note nightly metrics is calling master_cron_shell 01 17 * * * /root/metrics/nightly_metrics.sh >>/mnt/metrics_logs/crontab_nightly 2>&1 01 0 1 * * /root/metrics/monthly_metrics.sh >>/mnt/metrics_logs/crontab_monthly 2>&1 01 0 15 * * /root/metrics/monthly_metrics.sh >>/mnt/metrics_logs/crontab_doi_monthly 2>&1 01 07 * * * /root/metrics/nightly_errorlogs.sh >>/mnt/metrics_logs/crontab_errorlogs 2>&1
From Docker03 the logs can be checked by going doing the following. (Note no y at end of monthly) cat /mnt/nfs3/data1/metrics/crontab_logs/crontab_nightly cat /mnt/nfs3/data1/metrics/crontab_logs/crontab_monthly cat /mnt/nfs3/data1/metrics/crontab_logs/crontab_doi_monthly
Can also confirm things ran by looking in the database (if not need to do backfills).
Example: (should be first of each month)
select DATE_FORMAT(record_date
,'%Y-%m') as narrative_cron_month, count(*) as narrative_count from metrics.workspaces ws group by narrative_cron_month;
For elastic Search session information: (this is daily numbers) select record_date, count(*) from session_info group by record_date;
Note on old contents
The old contents of the metrics repo have been deleted from the current tree. The final commit containing them was 150ca6f, if you need access to them, you can rollback your local copy of the repo to that commit, or else just go to the following link:
https://github.com/kbase/metrics/tree/150ca6f61fb2411e607f15fb91407a83305daaf6