218 lines
5.9 KiB
TypeScript
218 lines
5.9 KiB
TypeScript
import { mkdir, mkdtemp, rm, writeFile } from 'node:fs/promises';
|
|
import os from 'node:os';
|
|
import path from 'node:path';
|
|
import {
|
|
buildEndpointReportFromLocalEvents,
|
|
buildNewRelicCustomEventNrql,
|
|
buildNewRelicTransactionNrql,
|
|
discoverApiRoutes,
|
|
formatMarkdownReport,
|
|
mergeRowsWithManifest,
|
|
} from './api-performance-report';
|
|
import type { ApiPerformanceEvent } from '../modules/global/observability/performance-observer';
|
|
|
|
describe('api performance route discovery', () => {
|
|
let rootDir: string;
|
|
|
|
beforeEach(async () => {
|
|
rootDir = await mkdtemp(path.join(os.tmpdir(), 'api-performance-routes-'));
|
|
await mkdir(path.join(rootDir, 'modules', 'match'), { recursive: true });
|
|
});
|
|
|
|
afterEach(async () => {
|
|
await rm(rootDir, { recursive: true, force: true });
|
|
});
|
|
|
|
it('discovers controller routes including multiline decorators', async () => {
|
|
await writeFile(
|
|
path.join(rootDir, 'modules', 'match', 'match.controller.ts'),
|
|
`
|
|
import { Controller, Get, Post } from '@nestjs/common';
|
|
|
|
@Controller('communities/:communityId/matches')
|
|
export class MatchController {
|
|
@Get()
|
|
list() {}
|
|
|
|
@Post(
|
|
':matchId/participants'
|
|
)
|
|
join() {}
|
|
}
|
|
`,
|
|
);
|
|
|
|
await writeFile(
|
|
path.join(rootDir, 'app.controller.ts'),
|
|
`
|
|
import { Controller, Get } from '@nestjs/common';
|
|
|
|
@Controller()
|
|
export class AppController {
|
|
@Get()
|
|
root() {}
|
|
}
|
|
`,
|
|
);
|
|
|
|
await expect(discoverApiRoutes(rootDir)).resolves.toEqual([
|
|
{
|
|
method: 'GET',
|
|
route: '/',
|
|
controllerFile: 'app.controller.ts',
|
|
},
|
|
{
|
|
method: 'GET',
|
|
route: '/communities/:communityId/matches',
|
|
controllerFile: 'modules/match/match.controller.ts',
|
|
},
|
|
{
|
|
method: 'POST',
|
|
route: '/communities/:communityId/matches/:matchId/participants',
|
|
controllerFile: 'modules/match/match.controller.ts',
|
|
},
|
|
]);
|
|
});
|
|
});
|
|
|
|
describe('api performance report generation', () => {
|
|
it('reports every manifest route, including routes with no samples', () => {
|
|
const routes = [
|
|
{
|
|
method: 'GET',
|
|
route: '/communities/:communityId/matches',
|
|
controllerFile: 'match.controller.ts',
|
|
},
|
|
{
|
|
method: 'POST',
|
|
route: '/communities/:communityId/matches',
|
|
controllerFile: 'match.controller.ts',
|
|
},
|
|
{
|
|
method: 'GET',
|
|
route: '/communities/:communityId/internal-stats/matches',
|
|
controllerFile: 'community-stats.controller.ts',
|
|
},
|
|
];
|
|
const events: ApiPerformanceEvent[] = [
|
|
{
|
|
type: 'api-request',
|
|
timestamp: '2026-06-28T00:00:00.000Z',
|
|
requestId: 'request-1',
|
|
method: 'GET',
|
|
route: '/communities/:communityId/matches',
|
|
path: '/communities/abc/matches',
|
|
statusCode: 200,
|
|
durationMs: 100,
|
|
isError: false,
|
|
queryCount: 2,
|
|
mongooseDurationMs: 40,
|
|
docsReturned: 50,
|
|
hydratedDocsReturned: 50,
|
|
leanQueryCount: 0,
|
|
},
|
|
];
|
|
|
|
const rows = buildEndpointReportFromLocalEvents({
|
|
routes,
|
|
events,
|
|
p95BudgetMs: 300,
|
|
docsReturnedP95Budget: 500,
|
|
hydratedDocsReturnedP95Budget: 0,
|
|
});
|
|
|
|
expect(rows).toHaveLength(3);
|
|
expect(
|
|
rows.find((row) => row.route === '/communities/:communityId/matches')
|
|
?.status,
|
|
).toBe('document-heavy');
|
|
expect(rows.filter((row) => row.status === 'no-samples')).toHaveLength(2);
|
|
});
|
|
|
|
it('keeps observed-only New Relic rows while adding no-sample manifest routes', () => {
|
|
const rows = mergeRowsWithManifest({
|
|
routes: [
|
|
{
|
|
method: 'GET',
|
|
route: '/known',
|
|
controllerFile: 'known.controller.ts',
|
|
},
|
|
],
|
|
measuredRows: [
|
|
{
|
|
method: 'GET',
|
|
route: '/observed-only',
|
|
source: 'newrelic-transaction',
|
|
samples: 10,
|
|
avgMs: 40,
|
|
p50Ms: 35,
|
|
p95Ms: 80,
|
|
p99Ms: 120,
|
|
maxMs: 130,
|
|
errorRatePercentage: 0,
|
|
queryCountP95: null,
|
|
mongooseDurationP95Ms: null,
|
|
docsReturnedP95: null,
|
|
hydratedDocsReturnedP95: null,
|
|
status: 'ok',
|
|
},
|
|
],
|
|
fallbackSource: 'newrelic-transaction',
|
|
p95BudgetMs: 300,
|
|
docsReturnedP95Budget: 500,
|
|
hydratedDocsReturnedP95Budget: 0,
|
|
});
|
|
|
|
expect(rows.map((row) => `${row.method} ${row.route}`)).toEqual([
|
|
'GET /known',
|
|
'GET /observed-only',
|
|
]);
|
|
expect(rows[0].status).toBe('no-samples');
|
|
expect(rows[1].samples).toBe(10);
|
|
});
|
|
|
|
it('formats all rows instead of truncating to a top list', () => {
|
|
const rows = Array.from({ length: 12 }, (_, index) => ({
|
|
method: 'GET',
|
|
route: `/route-${index}`,
|
|
source: 'local' as const,
|
|
samples: 1,
|
|
avgMs: 10,
|
|
p50Ms: 10,
|
|
p95Ms: 10,
|
|
p99Ms: 10,
|
|
maxMs: 10,
|
|
errorRatePercentage: 0,
|
|
queryCountP95: 1,
|
|
mongooseDurationP95Ms: 1,
|
|
docsReturnedP95: 1,
|
|
hydratedDocsReturnedP95: 0,
|
|
status: 'ok' as const,
|
|
}));
|
|
|
|
const report = formatMarkdownReport({
|
|
rows,
|
|
source: 'local',
|
|
since: 'fixture',
|
|
});
|
|
|
|
expect(report).toContain('/route-0');
|
|
expect(report).toContain('/route-11');
|
|
});
|
|
|
|
it('builds New Relic queries for custom events and transaction duration data', () => {
|
|
expect(buildNewRelicCustomEventNrql('lolympus-api', '1 day ago')).toContain(
|
|
'FROM ApiRequestPerformance',
|
|
);
|
|
expect(buildNewRelicCustomEventNrql('lolympus-api', '1 day ago')).toContain(
|
|
'FACET method, route',
|
|
);
|
|
expect(buildNewRelicTransactionNrql('lolympus-api', '1 day ago')).toContain(
|
|
'FROM Transaction',
|
|
);
|
|
expect(buildNewRelicTransactionNrql('lolympus-api', '1 day ago')).toContain(
|
|
'FACET name',
|
|
);
|
|
});
|
|
});
|