import client from 'prom-client'; import EventEmitter from 'events'; import { Knex } from 'knex'; import * as events from './metric-events'; import { DB_POOL_UPDATE, FEATURE_ARCHIVED, FEATURE_CREATED, FEATURE_REVIVED, FEATURE_STRATEGY_ADD, FEATURE_STRATEGY_REMOVE, FEATURE_STRATEGY_UPDATE, FEATURE_ENVIRONMENT_ENABLED, FEATURE_ENVIRONMENT_DISABLED, FEATURE_VARIANTS_UPDATED, FEATURE_METADATA_UPDATED, FEATURE_UPDATED, CLIENT_METRICS, CLIENT_REGISTER, } from './types/events'; import { IUnleashConfig } from './types/option'; import { IUnleashStores } from './types/stores'; import { hoursToMilliseconds, minutesToMilliseconds } from 'date-fns'; import Timer = NodeJS.Timer; import { InstanceStatsService } from './services/instance-stats-service'; export default class MetricsMonitor { timer?: Timer; poolMetricsTimer?: Timer; constructor() { this.timer = null; this.poolMetricsTimer = null; } startMonitoring( config: IUnleashConfig, stores: IUnleashStores, version: string, eventBus: EventEmitter, instanceStatsService: InstanceStatsService, db: Knex, ): Promise { if (!config.server.serverMetrics) { return; } const { eventStore } = stores; client.collectDefaultMetrics(); const requestDuration = new client.Summary({ name: 'http_request_duration_milliseconds', help: 'App response time', labelNames: ['path', 'method', 'status', 'appName'], percentiles: [0.1, 0.5, 0.9, 0.95, 0.99], maxAgeSeconds: 600, ageBuckets: 5, }); const dbDuration = new client.Summary({ name: 'db_query_duration_seconds', help: 'DB query duration time', labelNames: ['store', 'action'], percentiles: [0.1, 0.5, 0.9, 0.95, 0.99], maxAgeSeconds: 600, ageBuckets: 5, }); const featureToggleUpdateTotal = new client.Counter({ name: 'feature_toggle_update_total', help: 'Number of times a toggle has been updated. Environment label would be "n/a" when it is not available, e.g. when a feature toggle is created.', labelNames: ['toggle', 'project', 'environment'], }); const featureToggleUsageTotal = new client.Counter({ name: 'feature_toggle_usage_total', help: 'Number of times a feature toggle has been used', labelNames: ['toggle', 'active', 'appName'], }); const featureTogglesTotal = new client.Gauge({ name: 'feature_toggles_total', help: 'Number of feature toggles', labelNames: ['version'], }); const usersTotal = new client.Gauge({ name: 'users_total', help: 'Number of users', }); const projectsTotal = new client.Gauge({ name: 'projects_total', help: 'Number of projects', }); const environmentsTotal = new client.Gauge({ name: 'environments_total', help: 'Number of environments', }); const groupsTotal = new client.Gauge({ name: 'groups_total', help: 'Number of groups', }); const rolesTotal = new client.Gauge({ name: 'roles_total', help: 'Number of roles', }); const segmentsTotal = new client.Gauge({ name: 'segments_total', help: 'Number of segments', }); const contextTotal = new client.Gauge({ name: 'context_total', help: 'Number of context', }); const strategiesTotal = new client.Gauge({ name: 'strategies_total', help: 'Number of strategies', }); const samlEnabled = new client.Gauge({ name: 'saml_enabled', help: 'Whether SAML is enabled', }); const oidcEnabled = new client.Gauge({ name: 'oidc_enabled', help: 'Whether OIDC is enabled', }); const clientSdkVersionUsage = new client.Counter({ name: 'client_sdk_versions', help: 'Which sdk versions are being used', labelNames: ['sdk_name', 'sdk_version'], }); async function collectStaticCounters() { try { const stats = await instanceStatsService.getStats(); featureTogglesTotal.reset(); featureTogglesTotal.labels(version).set(stats.featureToggles); usersTotal.reset(); usersTotal.set(stats.users); projectsTotal.reset(); projectsTotal.set(stats.projects); environmentsTotal.reset(); environmentsTotal.set(stats.environments); groupsTotal.reset(); groupsTotal.set(stats.groups); rolesTotal.reset(); rolesTotal.set(stats.roles); segmentsTotal.reset(); segmentsTotal.set(stats.segments); contextTotal.reset(); contextTotal.set(stats.contextFields); strategiesTotal.reset(); strategiesTotal.set(stats.strategies); samlEnabled.reset(); samlEnabled.set(stats.SAMLenabled ? 1 : 0); oidcEnabled.reset(); oidcEnabled.set(stats.OIDCenabled ? 1 : 0); } catch (e) {} } process.nextTick(() => { collectStaticCounters(); this.timer = setInterval( () => collectStaticCounters(), hoursToMilliseconds(2), ).unref(); }); eventBus.on( events.REQUEST_TIME, ({ path, method, time, statusCode, appName }) => { requestDuration .labels(path, method, statusCode, appName) .observe(time); }, ); eventBus.on(events.DB_TIME, ({ store, action, time }) => { dbDuration.labels(store, action).observe(time); }); eventStore.on(FEATURE_CREATED, ({ featureName, project }) => { featureToggleUpdateTotal.labels(featureName, project, 'n/a').inc(); }); eventStore.on(FEATURE_VARIANTS_UPDATED, ({ featureName, project }) => { featureToggleUpdateTotal.labels(featureName, project, 'n/a').inc(); }); eventStore.on(FEATURE_METADATA_UPDATED, ({ featureName, project }) => { featureToggleUpdateTotal.labels(featureName, project, 'n/a').inc(); }); eventStore.on(FEATURE_UPDATED, ({ featureName, project }) => { featureToggleUpdateTotal .labels(featureName, project, 'default') .inc(); }); eventStore.on( FEATURE_STRATEGY_ADD, ({ featureName, project, environment }) => { featureToggleUpdateTotal .labels(featureName, project, environment) .inc(); }, ); eventStore.on( FEATURE_STRATEGY_REMOVE, ({ featureName, project, environment }) => { featureToggleUpdateTotal .labels(featureName, project, environment) .inc(); }, ); eventStore.on( FEATURE_STRATEGY_UPDATE, ({ featureName, project, environment }) => { featureToggleUpdateTotal .labels(featureName, project, environment) .inc(); }, ); eventStore.on( FEATURE_ENVIRONMENT_DISABLED, ({ featureName, project, environment }) => { featureToggleUpdateTotal .labels(featureName, project, environment) .inc(); }, ); eventStore.on( FEATURE_ENVIRONMENT_ENABLED, ({ featureName, project, environment }) => { featureToggleUpdateTotal .labels(featureName, project, environment) .inc(); }, ); eventStore.on(FEATURE_ARCHIVED, ({ featureName, project }) => { featureToggleUpdateTotal.labels(featureName, project, 'n/a').inc(); }); eventStore.on(FEATURE_REVIVED, ({ featureName, project }) => { featureToggleUpdateTotal.labels(featureName, project, 'n/a').inc(); }); eventBus.on(CLIENT_METRICS, (m) => { // eslint-disable-next-line no-restricted-syntax for (const entry of Object.entries(m.bucket.toggles)) { featureToggleUsageTotal .labels(entry[0], 'true', m.appName) // @ts-expect-error .inc(entry[1].yes); featureToggleUsageTotal .labels(entry[0], 'false', m.appName) // @ts-expect-error .inc(entry[1].no); } }); eventStore.on(CLIENT_REGISTER, (m) => { if (m.sdkVersion && m.sdkVersion.indexOf(':') > -1) { const [sdkName, sdkVersion] = m.sdkVersion.split(':'); clientSdkVersionUsage.labels(sdkName, sdkVersion).inc(); } }); this.configureDbMetrics(db, eventBus); } stopMonitoring(): void { clearInterval(this.timer); clearInterval(this.poolMetricsTimer); } configureDbMetrics(db: Knex, eventBus: EventEmitter): void { if (db && db.client) { const dbPoolMin = new client.Gauge({ name: 'db_pool_min', help: 'Minimum DB pool size', }); dbPoolMin.set(db.client.pool.min); const dbPoolMax = new client.Gauge({ name: 'db_pool_max', help: 'Maximum DB pool size', }); dbPoolMax.set(db.client.pool.max); const dbPoolFree = new client.Gauge({ name: 'db_pool_free', help: 'Current free connections in DB pool', }); const dbPoolUsed = new client.Gauge({ name: 'db_pool_used', help: 'Current connections in use in DB pool', }); const dbPoolPendingCreates = new client.Gauge({ name: 'db_pool_pending_creates', help: 'how many asynchronous create calls are running in DB pool', }); const dbPoolPendingAcquires = new client.Gauge({ name: 'db_pool_pending_acquires', help: 'how many acquires are waiting for a resource to be released in DB pool', }); eventBus.on(DB_POOL_UPDATE, (data) => { dbPoolFree.set(data.free); dbPoolUsed.set(data.used); dbPoolPendingCreates.set(data.pendingCreates); dbPoolPendingAcquires.set(data.pendingAcquires); }); this.registerPoolMetrics(db.client.pool, eventBus); this.poolMetricsTimer = setInterval( () => this.registerPoolMetrics(db.client.pool, eventBus), minutesToMilliseconds(1), ); this.poolMetricsTimer.unref(); } } // eslint-disable-next-line @typescript-eslint/explicit-module-boundary-types registerPoolMetrics(pool: any, eventBus: EventEmitter) { try { eventBus.emit(DB_POOL_UPDATE, { used: pool.numUsed(), free: pool.numFree(), pendingCreates: pool.numPendingCreates(), pendingAcquires: pool.numPendingAcquires(), }); // eslint-disable-next-line no-empty } catch (e) {} } } export function createMetricsMonitor(): MetricsMonitor { return new MetricsMonitor(); } module.exports = { createMetricsMonitor, };