Files
speckle-server/packages/server/observability/components/highFrequencyMetrics/highfrequencyMonitoring.ts
T
Kristaps Fabians Geikins 4b06f42db7 chore(server): run TS files directly (no compilation) (#5134)
* sort of works

* type fixes

* added option to run old way too
2025-07-23 11:20:40 +02:00

85 lines
2.4 KiB
TypeScript

/**
* High frequency monitoring, collects data related to CPU, memory, database, and network usage
* at a higher frequency than the default prometheus monitoring. It makes the data
* available to Prometheus via an histogram.
*/
import type { Registry } from 'prom-client'
import { Histogram } from 'prom-client'
import { processCpuTotal } from '@/observability/components/highFrequencyMetrics/processCPUTotal'
import { heapSizeAndUsed } from '@/observability/components/highFrequencyMetrics/heapSizeAndUsed'
import { knexConnections } from '@/observability/components/highFrequencyMetrics/knexConnectionPool'
import { type Knex } from 'knex'
type MetricConfig = {
prefix?: string
labels?: Record<string, string>
buckets?: Record<string, number[]>
getDbClients: () => Promise<
Array<{ client: Knex; isMain: boolean; regionKey: string }>
>
}
type HighFrequencyMonitor = {
start: () => () => void
}
export const initHighFrequencyMonitoring = (params: {
registers: Registry[]
collectionPeriodMilliseconds: number
config: MetricConfig
}): HighFrequencyMonitor => {
const { registers, collectionPeriodMilliseconds } = params
const config = params.config
const namePrefix = config.prefix ?? ''
const labels = config.labels ?? {}
const labelNames = Object.keys(labels)
const metrics = [
processCpuTotal(registers, config),
heapSizeAndUsed(registers, config),
knexConnections(registers, config)
]
registers.forEach((r) => {
r.removeSingleMetric(namePrefix + 'self_monitor_time_high_frequency')
})
const selfMonitor = new Histogram({
name: namePrefix + 'self_monitor_time_high_frequency',
help: 'The time taken to collect all of the high frequency metrics, seconds.',
registers,
buckets: [0, 0.001, 0.01, 0.025, 0.05, 0.1, 0.2],
labelNames
})
return {
start: collectHighFrequencyMetrics({
selfMonitor,
metrics,
collectionPeriodMilliseconds
})
}
}
export interface Metric {
collect: () => void
}
const collectHighFrequencyMetrics = (params: {
selfMonitor: Histogram<string>
collectionPeriodMilliseconds: number
metrics: Metric[]
}) => {
const { selfMonitor, metrics, collectionPeriodMilliseconds } = params
return () => {
const intervalId = setInterval(() => {
const end = selfMonitor.startTimer()
for (const metric of metrics) {
metric.collect()
}
end()
}, collectionPeriodMilliseconds)
return () => clearInterval(intervalId)
}
}