mirror of
https://github.com/immich-app/immich.git
synced 2026-02-04 11:08:03 -08:00
Adds comprehensive OpenTelemetry instrumentation for better observability: Tracing: - HTTP requests via @opentelemetry/instrumentation-http - NestJS controllers via @opentelemetry/instrumentation-nestjs-core - Redis operations via @opentelemetry/instrumentation-ioredis - BullMQ job queues via bullmq-otel - Database queries via Kysely log callback with accurate timing - File operations (send, stream, read) - Media processing (thumbnails, thumbhash, EXIF operations) - Metadata extraction Metrics: - Database connection pool usage (used/idle connections) The SDK is initialized in telemetry-preload.ts which is preloaded via --require before the main app starts. This ensures http instrumentation hooks are in place before any http module is imported. Enable tracing by setting OTEL_EXPORTER_OTLP_ENDPOINT environment variable. Also adds TraceContext to IBaseJob for future distributed trace propagation across BullMQ job boundaries.
45 lines
1.6 KiB
TypeScript
45 lines
1.6 KiB
TypeScript
// Must be first import - sets up OpenTelemetry SDK before any modules load
|
|
import 'src/telemetry-preload';
|
|
|
|
import { NestFactory } from '@nestjs/core';
|
|
import { isMainThread } from 'node:worker_threads';
|
|
import { MicroservicesModule } from 'src/app.module';
|
|
import { serverVersion } from 'src/constants';
|
|
import { WebSocketAdapter } from 'src/middleware/websocket.adapter';
|
|
import { AppRepository } from 'src/repositories/app.repository';
|
|
import { ConfigRepository } from 'src/repositories/config.repository';
|
|
import { LoggingRepository } from 'src/repositories/logging.repository';
|
|
import { bootstrapTelemetry } from 'src/repositories/telemetry.repository';
|
|
import { isStartUpError } from 'src/utils/misc';
|
|
|
|
export async function bootstrap() {
|
|
const { telemetry } = new ConfigRepository().getEnv();
|
|
if (telemetry.metrics.size > 0) {
|
|
bootstrapTelemetry(telemetry.microservicesPort);
|
|
}
|
|
|
|
const app = await NestFactory.create(MicroservicesModule, { bufferLogs: true });
|
|
const logger = await app.resolve(LoggingRepository);
|
|
const configRepository = app.get(ConfigRepository);
|
|
app.get(AppRepository).setCloseFn(() => app.close());
|
|
|
|
const { environment, host } = configRepository.getEnv();
|
|
|
|
logger.setContext('Bootstrap');
|
|
app.useLogger(logger);
|
|
app.useWebSocketAdapter(new WebSocketAdapter(app));
|
|
|
|
await (host ? app.listen(0, host) : app.listen(0));
|
|
|
|
logger.log(`Immich Microservices is running [v${serverVersion}] [${environment}] `);
|
|
}
|
|
|
|
if (!isMainThread) {
|
|
bootstrap().catch((error) => {
|
|
if (!isStartUpError(error)) {
|
|
console.error(error);
|
|
}
|
|
throw error;
|
|
});
|
|
}
|