mirror of
https://github.com/matrix-org/matrix-hookshot.git
synced 2025-03-10 21:19:13 +00:00
a79309071d
* add Grafana dashboard * Create 407.misc * Move hookshot-dashboard.json to contrib/ * Add Grafana dashboard to docs/metrics.md * Update 407.misc * Fix link to hookshot-dashboard.json Co-authored-by: Will Hunt <will@half-shot.uk> * Update hookshot-dashboard.json * Update metrics.md * Update hookshot-dashboard.json - add generic event pushes - add http requests - shuffle some panels around * update docs correctly as per review * Update contrib/hookshot-dashboard.json Co-authored-by: Will Hunt <will@half-shot.uk>
55 lines
2.0 KiB
TypeScript
55 lines
2.0 KiB
TypeScript
/* eslint-disable no-console */
|
|
import Metrics from "../src/Metrics";
|
|
import { register } from "prom-client";
|
|
|
|
// This is just used to ensure we create a singleton.
|
|
Metrics.getMetrics();
|
|
|
|
// eslint-disable-next-line @typescript-eslint/no-explicit-any
|
|
const anyRegister = register as any as {_metrics: {[metricName: string]: {labelNames: string[], name: string, help: string}}};
|
|
|
|
const categories: {[title: string]: {name: string, labels: string[], help: string}[]} = {};
|
|
|
|
Object.entries(anyRegister._metrics).map(
|
|
([key, value]) => {
|
|
const [categoryName] = key.split('_');
|
|
categories[categoryName] = categories[categoryName] || [];
|
|
categories[categoryName].push({
|
|
name: key,
|
|
labels: value.labelNames,
|
|
help: value.help,
|
|
});
|
|
});
|
|
|
|
// Generate some markdown
|
|
|
|
console.log(`Prometheus Metrics
|
|
==================
|
|
|
|
You can configure metrics support by adding the following to your config:
|
|
|
|
\`\`\`yaml
|
|
metrics:
|
|
enabled: true
|
|
bindAddress: 127.0.0.1
|
|
port: 9002
|
|
\`\`\`
|
|
|
|
An example dashboard that can be used with [Grafana](https://grafana.com) can be found at [/contrib/hookshot-dashboard.json](https://github.com/matrix-org/matrix-hookshot/blob/main/contrib/hookshot-dashboard.json).
|
|
There are 3 variables at the top of the dashboard:
|
|
|
|
|
|
|
|
Select the Prometheus with your Hookshot metrics as Data Source. Set Interval to your scraping interval. Set 2x Interval to twice the Interval value ([why?](https://github.com/matrix-org/matrix-hookshot/pull/407#issuecomment-1186251618)).
|
|
|
|
Below is the generated list of Prometheus metrics for Hookshot.
|
|
|
|
`)
|
|
|
|
Object.entries(categories).forEach(([name, entries]) => {
|
|
console.log(`## ${name}`);
|
|
console.log('| Metric | Help | Labels |');
|
|
console.log('|--------|------|--------|');
|
|
entries.forEach((e) => console.log(`| ${e.name} | ${e.help} | ${e.labels.join(', ')} |`));
|
|
});
|