:hedgehog: PostHog is the leading platform for building self-driving products. Our developer tools – AI observability, analytics, session replay, flags, experiments, error tracking, logs, and more – capture all the context agents need to diagnose problems, uncover opportunities, and ship fixes. Steer it all from Slack, web, desktop, or the MCP.
Python ab-testingai-analyticsanalyticscdpdata-warehouseexperimentsfeature-flagsjavascriptproduct-analyticspythonreactsession-replaysurveystypescriptweb-analytics
import { AverageMetricTracker, MaxMetricTracker, SummingMetricTracker } from './metric-tracker'
describe('SummingMetricTracker', () => {
it('should store the metric name as given', () => {
const tracker = new SummingMetricTracker('events', 10, 1000)
expect(tracker.metricName).toBe('events')
})
it('should accumulate multiple records to the same key', () => {
const tracker = new SummingMetricTracker('events', 10, 1000)
tracker.record({ team_id: '1' }, 3)
tracker.record({ team_id: '1' }, 7)
tracker.record({ team_id: '1' }, 2)
const entries = tracker.flush()
expect(entries).toHaveLength(1)
expect(entries[0].value).toBe(12)
expect(entries[0].count).toBe(3)
})
it('should handle multiple keys independently', () => {
const tracker = new SummingMetricTracker('events', 10, 1000)
tracker.record({ team_id: '1' }, 10)
tracker.record({ team_id: '2' }, 20)
const entries = tracker.flush()
expect(entries).toHaveLength(2)
expect(entries.find((e) => e.key.team_id === '1')?.value).toBe(10)
expect(entries.find((e) => e.key.team_id === '1')?.count).toBe(1)
expect(entries.find((e) => e.key.team_id === '2')?.value).toBe(20)
expect(entries.find((e) => e.key.team_id === '2')?.count).toBe(1)
})
it('should return empty array when no data recorded', () => {
const tracker = new SummingMetricTracker('events', 10, 1000)
expect(tracker.flush()).toEqual([])
})
it('should clear data after flush', () => {
const tracker = new SummingMetricTracker('events', 10, 1000)
tracker.record({ team_id: '1' }, 5)
tracker.flush()
expect(tracker.flush()).toEqual([])
})
it('should accumulate fresh data after flush', () => {
const tracker = new SummingMetricTracker('events', 10, 1000)
tracker.record({ team_id: '1' }, 10)
tracker.flush()
tracker.record({ team_id: '1' }, 3)
const entries = tracker.flush()
expect(entries).toHaveLength(1)
expect(entries[0].value).toBe(3)
expect(entries[0].count).toBe(1)
})
it('should deserialize key back to object', () => {
const tracker = new SummingMetricTracker('events', 10, 1000)
tracker.record({ team_id: '42', event: '$pageview' }, 1)
const entries = tracker.flush()
expect(entries[0].key).toEqual({ team_id: '42', event: '$pageview' })
})
describe('top-N selection', () => {
it.each([
{ numEntries: 5, topN: 3, expectedCount: 3, desc: 'takes top N when more entries than N' },
{ numEntries: 3, topN: 10, expectedCount: 3, desc: 'takes all entries when fewer than N' },
{ numEntries: 10, topN: 1, expectedCount: 1, desc: 'takes only the top entry when N=1' },
])('$desc (entries=$numEntries, topN=$topN)', ({ numEntries, topN, expectedCount }) => {
const tracker = new SummingMetricTracker('metric', topN, 1000)
for (let i = 0; i < numEntries; i++) {
tracker.record({ id: String(i) }, i + 1)
}
expect(tracker.flush()).toHaveLength(expectedCount)
})
it('should select entries with highest values', () => {
const tracker = new SummingMetricTracker('metric', 2, 1000)
tracker.record({ id: 'low' }, 1)
tracker.record({ id: 'high' }, 100)
tracker.record({ id: 'medium' }, 50)
const keys = tracker.flush().map((e) => e.key.id)
expect(keys).toEqual(['high', 'medium'])
})
it('should sort entries by value descending', () => {
const tracker = new SummingMetricTracker('metric', 5, 1000)
tracker.record({ id: 'a' }, 3)
tracker.record({ id: 'b' }, 1)
tracker.record({ id: 'c' }, 5)
tracker.record({ id: 'd' }, 2)
const values = tracker.flush().map((e) => e.value)
expect(values).toEqual([5, 3, 2, 1])
})
})
describe('maxKeys eviction', () => {
it('should drop lowest-value half when maxKeys exceeded', () => {
const tracker = new SummingMetricTracker('metric', 10, 4)
tracker.record({ id: 'a' }, 1)
tracker.record({ id: 'b' }, 10)
tracker.record({ id: 'c' }, 5)
tracker.record({ id: 'd' }, 2)
tracker.record({ id: 'e' }, 8) // triggers eviction, drops bottom half
const keys = tracker.flush().map((e) => e.key.id)
expect(keys).toContain('b')
expect(keys).toContain('e')
expect(keys).toContain('c')
expect(keys).not.toContain('a')
expect(keys).not.toContain('d')
})
it('should keep higher-value keys after eviction', () => {
const tracker = new SummingMetricTracker('metric', 10, 4)
tracker.record({ id: 'low1' }, 1)
tracker.record({ id: 'low2' }, 2)
tracker.record({ id: 'high1' }, 100)
tracker.record({ id: 'high2' }, 50)
tracker.record({ id: 'high3' }, 75) // triggers eviction
const entries = tracker.flush()
expect(entries.map((e) => e.key.id)).toEqual(['high1', 'high3', 'high2'])
})
it('should allow new keys after eviction frees space', () => {
const tracker = new SummingMetricTracker('metric', 10, 4)
tracker.record({ id: 'a' }, 1)
tracker.record({ id: 'b' }, 2)
tracker.record({ id: 'c' }, 3)
tracker.record({ id: 'd' }, 4)
tracker.record({ id: 'e' }, 5) // triggers eviction
tracker.record({ id: 'f' }, 6) // should fit after eviction
const keys = tracker.flush().map((e) => e.key.id)
expect(keys).toContain('f')
})
it('should not evict when at the limit', () => {
const tracker = new SummingMetricTracker('metric', 10, 5)
tracker.record({ id: 'a' }, 1)
tracker.record({ id: 'b' }, 1)
tracker.record({ id: 'c' }, 1)
expect(tracker.flush()).toHaveLength(3)
})
})
})
describe('AverageMetricTracker', () => {
it('should compute average for a single key', () => {
const tracker = new AverageMetricTracker('latency', 10, 1000)
tracker.record({ team_id: '1' }, 10)
tracker.record({ team_id: '1' }, 20)
tracker.record({ team_id: '1' }, 30)
const entries = tracker.flush()
expect(entries).toHaveLength(1)
expect(entries[0].value).toBe(20)
expect(entries[0].count).toBe(3)
})
it('should compute averages independently per key', () => {
const tracker = new AverageMetricTracker('latency', 10, 1000)
tracker.record({ team_id: '1' }, 10)
tracker.record({ team_id: '1' }, 30)
tracker.record({ team_id: '2' }, 100)
const entries = tracker.flush()
expect(entries.find((e) => e.key.team_id === '1')?.value).toBe(20)
expect(entries.find((e) => e.key.team_id === '1')?.count).toBe(2)
expect(entries.find((e) => e.key.team_id === '2')?.value).toBe(100)
expect(entries.find((e) => e.key.team_id === '2')?.count).toBe(1)
})
it('should rank by average not by sum', () => {
const tracker = new AverageMetricTracker('latency', 2, 1000)
// high sum (300) but low average (100)
tracker.record({ id: 'many_low' }, 100)
tracker.record({ id: 'many_low' }, 100)
tracker.record({ id: 'many_low' }, 100)
// low sum (500) but high average (500)
tracker.record({ id: 'few_high' }, 500)
const entries = tracker.flush()
expect(entries[0].key.id).toBe('few_high')
expect(entries[0].value).toBe(500)
expect(entries[1].key.id).toBe('many_low')
expect(entries[1].value).toBe(100)
})
it('should return empty array when no data recorded', () => {
const tracker = new AverageMetricTracker('latency', 10, 1000)
expect(tracker.flush()).toEqual([])
})
it('should clear data after flush', () => {
const tracker = new AverageMetricTracker('latency', 10, 1000)
tracker.record({ team_id: '1' }, 50)
tracker.flush()
expect(tracker.flush()).toEqual([])
})
it('should accumulate fresh data after flush', () => {
const tracker = new AverageMetricTracker('latency', 10, 1000)
tracker.record({ team_id: '1' }, 100)
tracker.flush()
tracker.record({ team_id: '1' }, 40)
tracker.record({ team_id: '1' }, 60)
const entries = tracker.flush()
expect(entries[0].value).toBe(50)
})
describe('top-N selection', () => {
it('should take top N by average', () => {
const tracker = new AverageMetricTracker('latency', 2, 1000)
tracker.record({ id: 'a' }, 10)
tracker.record({ id: 'b' }, 50)
tracker.record({ id: 'c' }, 30)
const keys = tracker.flush().map((e) => e.key.id)
expect(keys).toEqual(['b', 'c'])
})
})
describe('maxKeys eviction', () => {
it('should evict by average not by sum', () => {
const tracker = new AverageMetricTracker('latency', 10, 4)
// low average (5) despite multiple records
tracker.record({ id: 'low_avg' }, 5)
tracker.record({ id: 'low_avg' }, 5)
tracker.record({ id: 'low_avg' }, 5)
tracker.record({ id: 'high_avg' }, 100)
tracker.record({ id: 'mid_avg' }, 50)
tracker.record({ id: 'lowest_avg' }, 1)
tracker.record({ id: 'trigger' }, 200) // triggers eviction
const keys = tracker.flush().map((e) => e.key.id)
expect(keys).toContain('trigger')
expect(keys).toContain('high_avg')
expect(keys).not.toContain('lowest_avg')
expect(keys).not.toContain('low_avg')
})
})
})
describe('MaxMetricTracker', () => {
it('should keep the maximum value for a single key', () => {
const tracker = new MaxMetricTracker('max_size', 10, 1000)
tracker.record({ team_id: '1' }, 10)
tracker.record({ team_id: '1' }, 50)
tracker.record({ team_id: '1' }, 30)
const entries = tracker.flush()
expect(entries).toHaveLength(1)
expect(entries[0].value).toBe(50)
expect(entries[0].count).toBe(3)
})
it('should track max independently per key', () => {
const tracker = new MaxMetricTracker('max_size', 10, 1000)
tracker.record({ team_id: '1' }, 10)
tracker.record({ team_id: '1' }, 50)
tracker.record({ team_id: '2' }, 30)
const entries = tracker.flush()
expect(entries.find((e) => e.key.team_id === '1')?.value).toBe(50)
expect(entries.find((e) => e.key.team_id === '1')?.count).toBe(2)
expect(entries.find((e) => e.key.team_id === '2')?.value).toBe(30)
expect(entries.find((e) => e.key.team_id === '2')?.count).toBe(1)
})
it('should rank by max value', () => {
const tracker = new MaxMetricTracker('max_size', 2, 1000)
tracker.record({ id: 'a' }, 10)
tracker.record({ id: 'b' }, 100)
tracker.record({ id: 'c' }, 50)
const keys = tracker.flush().map((e) => e.key.id)
expect(keys).toEqual(['b', 'c'])
})
it('should return empty array when no data recorded', () => {
const tracker = new MaxMetricTracker('max_size', 10, 1000)
expect(tracker.flush()).toEqual([])
})
it('should clear data after flush', () => {
const tracker = new MaxMetricTracker('max_size', 10, 1000)
tracker.record({ team_id: '1' }, 50)
tracker.flush()
expect(tracker.flush()).toEqual([])
})
it('should not carry over max from previous flush', () => {
const tracker = new MaxMetricTracker('max_size', 10, 1000)
tracker.record({ team_id: '1' }, 100)
tracker.flush()
tracker.record({ team_id: '1' }, 20)
const entries = tracker.flush()
expect(entries[0].value).toBe(20)
})
describe('maxKeys eviction', () => {
it('should evict by max value', () => {
const tracker = new MaxMetricTracker('max_size', 10, 4)
tracker.record({ id: 'a' }, 1)
tracker.record({ id: 'b' }, 100)
tracker.record({ id: 'c' }, 50)
tracker.record({ id: 'd' }, 2)
tracker.record({ id: 'e' }, 75) // triggers eviction
const keys = tracker.flush().map((e) => e.key.id)
expect(keys).toContain('b')
expect(keys).toContain('e')
expect(keys).toContain('c')
expect(keys).not.toContain('a')
expect(keys).not.toContain('d')
})
})
})