add metrics reports

Author: some-natalie

sql/README.md

@@ -18,14 +18,28 @@ The `audit` folder has queries that are all around auditing credentials, webhook
 - `user-emails.sql` - A report of all emails that don't match a list of approved domains you define in the `WHERE` clause.  This query should be deprecated by [this issue](https://github.com/github/roadmap/issues/204).
 - `user-ssh-keys.sql` - A report of all user SSH keys, when it was last used, when it was set up, and how long the key is.
 
+## Metrics queries
+
+The `metrics` folder has queries that are all around usage of various features in GitHub Enterprise Server.
+
+- `actions-summary.sql` - A monthly summary of runtime hours, seconds waiting in queue before dispatch, and job count for GitHub Actions usage.
+- `commit-count.sql` - This pulls a "high score" report of all users, all commits, from all time.
+- `count-tabs.sql` - A report of the custom tabs users put in their repositories.
+- `issue-report.sql` - A report of active issues within the past X days.
+- `linguist-report.sql` - This returns the "size" of each language in each repository and when the repo was last updated.  This can be a very large report.
+- `linguist-stats.sql` - This returns the count of repositories containing each language and a sum "size" of code in that language for all repos pushed to in the past year.  The time limit is adjustable.
+- `most-recent-active-repos.sql` - A list of repositories, when they were last updated, who owns them, and the disk space associated with each.
+- `pr-report.sql` - This pulls a report of pull requests including the repo name, user name, files included, times it was created/updated/merged, and comments.  It can filter by organization or return all PRs in GHES.
+- `prereceive-hooks.sql` - A list of pre-receive hooks that are enabled by each repository and who owns the repo.
+- `public-repo-owners.sql` - A list of all users or orgs who own repositories marked as "public", a count of public repos, and the user or org email address.
+- `reaction-stats.sql` - A count of the reactions used in GHES for trivia.
+- `staff-notes.sql` - Returns a list of organizations or users with `staff_notes`.
+- `user-report.sql` - Returns username, id, created/suspended date, issues created for all time and in the past 30 days, number of repos owned, and how many pull requests they've opened.
+
 ## Security queries
 
 The `security` folder has queries that are all around dependency alerts and any other security features.
 
 - `active-repo-report.sql` - A list of all detected HIGH and CRITICAL vulnerabilities from repos pushed to in the past 90 days.  It also returns who owns it and further details on the exact vulnerability.  The threshold of time and severity to return is adjustable.
 - `vuln-critical-count.sql` - A count of repositories affected by each CRITICAL vulnerability.
 - `vuln-report.sql` - A report of all detected vulnerabilities in every single repo in GHES, who owns it, when it was last pushed to, the platform of the vulnerability, and the GHSA/MITRE/WhiteSource info on it.  This can be a very large report.
-
-## Usage queries
-
-The `usage` folder has queries that are all around usage of various features in GitHub Enterprise Server.

sql/metrics/actions-summary.sql

@@ -0,0 +1,28 @@
+/* 
+ * This query generates a monthly summary of runtime hours, seconds waiting 
+ * in queue before dispatch, and job count for GitHub Actions usage.
+ */
+SELECT
+	month(j.completed_at) as month,
+	year(j.completed_at) as year,
+	round(
+		sum(
+			unix_timestamp(j.completed_at) - unix_timestamp(
+				coalesce(j.started_at, j.queued_at, j.created_at)
+			)
+		) / 3600
+	) as compute_hours,
+	round(
+		avg(
+			unix_timestamp(j.started_at) - unix_timestamp(j.queued_at)
+		)
+	) as seconds_queued,
+	count(j.completed_at) as job_count
+FROM
+	github_enterprise.workflow_builds j
+GROUP BY
+	month,
+	year
+ORDER BY
+	year,
+	month

sql/metrics/commit-count.sql

@@ -0,0 +1,14 @@
+/* 
+ * This pulls a "high score" report of all users, all commits, from all time.
+ */
+SELECT
+	u.login,
+	SUM(commit_count)
+FROM
+	github_enterprise.commit_contributions c
+JOIN github_enterprise.users u ON
+	u.id = c.user_id
+GROUP BY
+	user_id
+ORDER BY
+	COUNT(c.user_id) DESC;

sql/metrics/count-tabs.sql

@@ -0,0 +1,17 @@
+/* 
+ * These are custom tabs set by a repository owner that show up to their users.
+ */
+SELECT
+	t.anchor as name,
+	t.url,
+	t.created_at,
+	t.updated_at,
+	r.name as repo_name,
+	u.login as owner_name,
+	u.type as owner_type
+FROM
+	github_enterprise.tabs t
+JOIN github_enterprise.repositories r ON
+	t.repository_id = r.id
+JOIN github_enterprise.users u ON
+	r.owner_id = u.id;

sql/metrics/issue-report.sql

@@ -0,0 +1,25 @@
+/* 
+ * This query returns a report of active issues within the past X days.
+ */
+SELECT
+	r.name as repo_name,
+	u.login as created_by,
+	v.login as assigned_to,
+	i.state as issue_state,
+	i.created_at,
+	i.updated_at,
+	i.closed_at,
+	i.issue_comments_count,
+	DATEDIFF(i.closed_at, i.created_at) as days_open
+FROM
+	github_enterprise.issues i
+LEFT JOIN github_enterprise.users u ON
+	i.user_id = u.id
+LEFT JOIN github_enterprise.users v ON
+	i.assignee_id = v.id
+INNER JOIN github_enterprise.repositories r ON
+	i.repository_id = r.id
+WHERE
+	DATEDIFF(NOW(), i.created_at) <= 365
+ORDER BY
+	days_open DESC;

sql/metrics/linguist-report.sql

@@ -0,0 +1,16 @@
+/* 
+ * This lists the "size" of each language in each repository and when the repo
+ * was last updated.
+ */
+SELECT
+	r.name,
+	l.updated_at,
+	l.public,
+	l.size,
+	n.name
+FROM
+	github_enterprise.languages l
+JOIN github_enterprise.language_names n ON
+	l.language_name_id = n.id
+JOIN github_enterprise.repositories r ON
+	l.repository_id = r.id;

sql/metrics/linguist-stats.sql

@@ -0,0 +1,28 @@
+/*
+ * This pulls the number of repositories containing any individual language
+ * that have been pushed to in the past year.
+ *
+ * If you comment out the WHERE clause, it'll return the stats for your server
+ * for all time.
+ */
+SELECT
+	n.name as language_name,
+	COUNT(l.language_name_id) as repo_count,
+	ROUND(SUM(l.size) /(1024 * 1024)) as language_size_mb
+FROM
+	github_enterprise.languages l
+	JOIN github_enterprise.language_names n ON l.language_name_id = n.id
+	JOIN github_enterprise.repositories r ON l.repository_id = r.id
+WHERE
+	r.id IN (
+		SELECT
+			r.id
+		FROM
+			github_enterprise.repositories r
+		WHERE
+			DATEDIFF(NOW(), r.updated_at) < 365
+	)
+GROUP BY
+	language_name_id
+ORDER BY
+	COUNT(l.language_name_id) DESC;

sql/metrics/most-recent-active-repos.sql

@@ -0,0 +1,15 @@
+/* 
+ * This pulls a list of repositories, when they were last updated, who owns 
+ * them, and the disk space associated with each.
+ */
+SELECT
+	r.name as repo_name,
+	r.updated_at,
+	r.disk_usage,
+	u.login
+FROM
+	github_enterprise.repositories r
+JOIN github_enterprise.users u ON
+	r.owner_id = u.id
+ORDER BY
+	updated_at DESC;

sql/metrics/pr-report.sql

@@ -0,0 +1,28 @@
+/* 
+ * This pulls a report of pull requests including the repo name, user name, 
+ * files included, times it was created/updated/merged, and comments.
+ *
+ * If you know the organization ID you're interested in, uncomment and put it
+ * in line 27 to filter this to a specific org.  Otherwise, this query returns
+ * all pull requests in GitHub Enterprise Server.
+ */
+SELECT
+	r.name,
+	u.login,
+	path as filename,
+	p.id as pr_id,
+	p.created_at as created_time,
+	p.updated_at as updated_time,
+	p.merged_at as merged_time,
+	CONVERT(body
+		USING utf8) as comment
+FROM
+	github_enterprise.pull_request_review_comments c
+JOIN github_enterprise.users u ON
+	u.id = c.user_id
+JOIN github_enterprise.pull_requests p ON
+	p.id = c.pull_request_id
+JOIN github_enterprise.repositories r ON
+	r.id = c.repository_id
+-- WHERE r.owner_id = (org id here)
+;

sql/metrics/prereceive-hooks.sql

@@ -0,0 +1,16 @@
+/* 
+ * This returns a list of pre-receive hooks that are enabled by each repository
+ * and who owns the repo.
+ */
+SELECT
+	h.name as hook_name,
+	r.name as repo_name,
+	u.login as owner_name
+FROM
+	github_enterprise.pre_receive_hook_targets t
+JOIN github_enterprise.pre_receive_hooks h ON
+	h.id = t.hook_id
+JOIN github_enterprise.repositories r ON
+	r.id = t.hookable_id
+JOIN github_enterprise.users u ON
+	r.owner_id = u.id;