@syndew/oluso-plugin-telemetry 0.0.0-stage → 1.30.1

package/types/syndew-oluso-plugin-telemetry.d.ts

@@ -0,0 +1,385 @@
+import { AdminPlugin, NavItem, PaginatedResponse } from '@syndew/oluso-ui-core';
+import { Routes } from '@angular/router';
+import { Observable } from 'rxjs';
+import * as _angular_core from '@angular/core';
+import { OnInit, OnDestroy } from '@angular/core';
+
+/**
+ * Telemetry Admin Plugin
+ *
+ * Provides system monitoring and observability functionality:
+ * - Dashboard with overview metrics
+ * - Application logs viewer with filtering and live tail
+ * - Distributed traces explorer
+ */
+declare const TELEMETRY_PLUGIN: AdminPlugin;
+/**
+ * Helper function to get Telemetry navigation items
+ */
+declare function getTelemetryNavItems(): NavItem[];
+
+declare const TELEMETRY_ROUTES: Routes;
+
+/**
+ * Telemetry overview metrics
+ */
+interface TelemetryMetrics {
+    tokensIssued: number;
+    tokensFailed: number;
+    activeUsers: number;
+    activeSessions: number;
+    authSuccessRate: number;
+    avgRequestDuration: number;
+}
+/**
+ * A single data point in a metric time series
+ */
+interface MetricDataPoint {
+    timestamp: string;
+    value: number;
+    tags?: Record<string, string>;
+}
+/**
+ * Time series data for a specific metric
+ */
+interface MetricSeries {
+    name: string;
+    unit: string;
+    data: MetricDataPoint[];
+}
+/**
+ * Log level types
+ */
+type LogLevel = 'trace' | 'debug' | 'info' | 'warn' | 'error' | 'fatal';
+/**
+ * Application log entry
+ */
+interface LogEntry {
+    id: string;
+    timestamp: string;
+    level: LogLevel;
+    message: string;
+    category: string;
+    properties?: Record<string, unknown>;
+    exception?: string;
+    exceptionType?: string;
+    stackTrace?: string;
+    traceId?: string;
+    spanId?: string;
+    requestPath?: string;
+    requestMethod?: string;
+    userId?: string;
+    clientId?: string;
+    machineName?: string;
+}
+/**
+ * Audit log entry for security/compliance tracking
+ */
+interface AuditLogEntry {
+    id: string;
+    timestamp: string;
+    category: string;
+    action: string;
+    eventType: string;
+    subjectId?: string;
+    subjectType?: string;
+    subjectName?: string;
+    subjectEmail?: string;
+    success: boolean;
+    ipAddress?: string;
+    userAgent?: string;
+    resourceType?: string;
+    resourceId?: string;
+    resourceName?: string;
+    details?: Record<string, unknown>;
+    tenantId?: string;
+    clientId?: string;
+    activityId?: string;
+    errorMessage?: string;
+}
+/**
+ * Trace status types
+ */
+type TraceStatus = 'ok' | 'error' | 'unset';
+/**
+ * An event within a trace span
+ */
+interface TraceEvent {
+    name: string;
+    timestamp: string;
+    attributes?: Record<string, unknown>;
+}
+/**
+ * A span within a distributed trace
+ */
+interface TraceSpan {
+    traceId: string;
+    spanId: string;
+    parentSpanId?: string;
+    operationName: string;
+    serviceName: string;
+    startTime: string;
+    duration: number;
+    status: TraceStatus;
+    tags: Record<string, string>;
+    events: TraceEvent[];
+}
+/**
+ * A complete distributed trace
+ */
+interface Trace {
+    traceId: string;
+    rootSpan: TraceSpan;
+    spans: TraceSpan[];
+    duration: number;
+    startTime: string;
+    serviceName: string;
+    status: TraceStatus;
+}
+/**
+ * Query parameters for telemetry data
+ */
+interface TelemetryQuery {
+    startTime?: string;
+    endTime?: string;
+    level?: string;
+    category?: string;
+    searchTerm?: string;
+    traceId?: string;
+    page?: number;
+    pageSize?: number;
+}
+/**
+ * Paginated response wrapper — alias kept for backward compatibility.
+ */
+type PagedResult<T> = PaginatedResponse<T>;
+/**
+ * Time range options for dashboard
+ */
+type TimeRange = '1h' | '24h' | '7d' | '30d';
+/**
+ * Get interval based on time range
+ */
+declare function getIntervalForRange(range: TimeRange): string;
+/**
+ * Format duration in ms to human readable string
+ */
+declare function formatDuration(ms: number): string;
+/**
+ * Log level display configuration (designed for dark terminal-style background)
+ */
+declare const LOG_LEVEL_CONFIG: Record<LogLevel, {
+    textColor: string;
+    bgColor: string;
+    label: string;
+}>;
+/**
+ * Trace status display configuration
+ */
+declare const TRACE_STATUS_CONFIG: Record<TraceStatus, {
+    textColor: string;
+    bgColor: string;
+}>;
+
+declare class TelemetryService {
+    private readonly api;
+    /**
+     * Get overview metrics for the telemetry dashboard
+     */
+    getOverviewMetrics(timeRange?: TimeRange): Observable<TelemetryMetrics>;
+    /**
+     * Get time series data for a specific metric
+     */
+    getMetricSeries(metricName: string, timeRange?: TimeRange): Observable<MetricSeries>;
+    /**
+     * Get application logs with filtering and pagination
+     */
+    getLogs(query: TelemetryQuery): Observable<PagedResult<LogEntry>>;
+    /**
+     * Get available log categories for filtering
+     */
+    getLogCategories(): Observable<string[]>;
+    /**
+     * Get distributed traces with filtering and pagination
+     */
+    getTraces(query: TelemetryQuery): Observable<PagedResult<Trace>>;
+    /**
+     * Get details of a specific trace by ID
+     */
+    getTrace(traceId: string): Observable<Trace>;
+    /**
+     * Trace backend configuration status. Used by the Traces page to render
+     * a "tracing not configured" notice in environments without Tempo.
+     */
+    getTraceBackendStatus(): Observable<{
+        isConfigured: boolean;
+        backend: string;
+    }>;
+    /**
+     * Log backend configuration status. Returns the source the Logs page is
+     * actually reading from ("database", "loki", "none") so the UI can
+     * surface a small badge and degrade gracefully when nothing is wired.
+     */
+    getLogBackendStatus(): Observable<{
+        isConfigured: boolean;
+        backend: string;
+    }>;
+    /**
+     * Clean query object by removing undefined values
+     */
+    private cleanQuery;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<TelemetryService, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<TelemetryService>;
+}
+
+declare class TelemetryDashboardComponent implements OnInit, OnDestroy {
+    private readonly telemetryService;
+    private readonly destroy$;
+    metrics: _angular_core.WritableSignal<TelemetryMetrics | null>;
+    tokenSeries: _angular_core.WritableSignal<MetricSeries | null>;
+    authSeries: _angular_core.WritableSignal<MetricSeries | null>;
+    loading: _angular_core.WritableSignal<boolean>;
+    error: _angular_core.WritableSignal<string | null>;
+    timeRange: _angular_core.WritableSignal<TimeRange>;
+    autoRefresh: _angular_core.WritableSignal<boolean>;
+    systemHealth: _angular_core.Signal<"-" | "Healthy" | "Degraded">;
+    ngOnInit(): void;
+    ngOnDestroy(): void;
+    setTimeRange(range: TimeRange): void;
+    toggleAutoRefresh(): void;
+    loadData(): void;
+    getBarHeight(value: number, data: {
+        value: number;
+    }[]): number;
+    formatChartLabel(timestamp: string): string;
+    getFirstLabel(data: {
+        timestamp: string;
+    }[]): string;
+    getLastLabel(data: {
+        timestamp: string;
+    }[]): string;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<TelemetryDashboardComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<TelemetryDashboardComponent, "lib-telemetry-dashboard", never, {}, {}, never, never, true, never>;
+}
+
+declare class TelemetryLogsComponent implements OnInit, OnDestroy {
+    private readonly telemetryService;
+    private readonly router;
+    private readonly route;
+    private readonly destroy$;
+    logs: _angular_core.WritableSignal<LogEntry[]>;
+    categories: _angular_core.WritableSignal<string[]>;
+    loading: _angular_core.WritableSignal<boolean>;
+    error: _angular_core.WritableSignal<string | null>;
+    totalCount: _angular_core.WritableSignal<number>;
+    liveTail: _angular_core.WritableSignal<boolean>;
+    expandedLogs: _angular_core.WritableSignal<Set<string>>;
+    readonly THEME_KEY = "telemetry-logs-theme";
+    darkMode: _angular_core.WritableSignal<boolean>;
+    searchTerm: string;
+    level: string;
+    category: string;
+    currentPage: _angular_core.WritableSignal<number>;
+    readonly pageSize = 50;
+    totalPages: _angular_core.Signal<number>;
+    Math: Math;
+    backend: _angular_core.WritableSignal<string | null>;
+    ngOnInit(): void;
+    loadBackendStatus(): void;
+    ngOnDestroy(): void;
+    loadCategories(): void;
+    loadLogs(silent?: boolean): void;
+    handleSearch(): void;
+    toggleLiveTail(): void;
+    toggleExpand(logId: string): void;
+    hasDetails(log: LogEntry): boolean;
+    hasProperties(props: Record<string, unknown>): boolean;
+    goToPage(page: number): void;
+    navigateToTrace(traceId: string): void;
+    formatDate(dateString: string): string;
+    formatJson(obj: unknown): string;
+    /**
+     * Normalize log level from backend format to frontend format
+     * Backend returns: "Trace", "Debug", "Information", "Warning", "Error", "Critical"
+     * Frontend expects: "trace", "debug", "info", "warn", "error", "fatal"
+     */
+    private normalizeLevel;
+    getLevelClasses(level: string): string;
+    getLevelLabel(level: string): string;
+    getLevelStyles(level: string): Record<string, string>;
+    loadThemePreference(): boolean;
+    toggleTheme(): void;
+    getLogViewerClasses(): string;
+    getLogRowClasses(): string;
+    getTimestampClasses(): string;
+    getCategoryClasses(): string;
+    getMessageClasses(): string;
+    getExpandIconClasses(): string;
+    getDetailsContainerClasses(): string;
+    getPropertiesPreClasses(): string;
+    getExceptionPreClasses(): string;
+    getStackTracePreClasses(): string;
+    getLabelClasses(): string;
+    getContextValueClasses(type: 'request' | 'user' | 'client' | 'machine'): string;
+    getTraceLinkClasses(): string;
+    getSpanIdClasses(): string;
+    getExceptionLabelClasses(): string;
+    getExceptionTypeClasses(): string;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<TelemetryLogsComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<TelemetryLogsComponent, "lib-telemetry-logs", never, {}, {}, never, never, true, never>;
+}
+
+declare class TelemetryTracesComponent implements OnInit {
+    private readonly telemetryService;
+    private readonly router;
+    private readonly route;
+    traces: _angular_core.WritableSignal<Trace[]>;
+    selectedTrace: _angular_core.WritableSignal<Trace | null>;
+    loading: _angular_core.WritableSignal<boolean>;
+    error: _angular_core.WritableSignal<string | null>;
+    totalCount: _angular_core.WritableSignal<number>;
+    expandedSpans: _angular_core.WritableSignal<Set<string>>;
+    /**
+     * Trace backend configured-state.
+     * - `null`: status check still in flight (initial load)
+     * - `true`: Tempo (or other) backend is wired; render search/list
+     * - `false`: no backend; render the "not configured" notice instead
+     */
+    backendConfigured: _angular_core.WritableSignal<boolean | null>;
+    searchTerm: string;
+    currentPage: _angular_core.WritableSignal<number>;
+    readonly pageSize = 20;
+    totalPages: _angular_core.Signal<number>;
+    traceId: _angular_core.WritableSignal<string | null>;
+    Math: Math;
+    formatDuration: typeof formatDuration;
+    ngOnInit(): void;
+    private bindRoute;
+    loadTraces(): void;
+    loadTrace(id: string): void;
+    handleSearch(): void;
+    selectTrace(id: string): void;
+    handleBack(): void;
+    goToPage(page: number): void;
+    toggleSpanExpand(spanId: string): void;
+    getStatusColor(status: TraceStatus): string;
+    formatDate(dateString: string): string;
+    getSpanOffset(span: {
+        startTime: string;
+    }, trace: Trace): number;
+    getSpanWidth(span: {
+        duration: number;
+    }, trace: Trace): number;
+    /**
+     * Build a flattened tree of spans for rendering
+     */
+    getSpanTree(trace: Trace): Array<TraceSpan & {
+        depth: number;
+        hasChildren: boolean;
+    }>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<TelemetryTracesComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<TelemetryTracesComponent, "lib-telemetry-traces", never, {}, {}, never, never, true, never>;
+}
+
+export { LOG_LEVEL_CONFIG, TELEMETRY_PLUGIN, TELEMETRY_ROUTES, TRACE_STATUS_CONFIG, TelemetryDashboardComponent, TelemetryLogsComponent, TelemetryService, TelemetryTracesComponent, formatDuration, getIntervalForRange, getTelemetryNavItems };
+export type { AuditLogEntry, LogEntry, LogLevel, MetricDataPoint, MetricSeries, PagedResult, TelemetryMetrics, TelemetryQuery, TimeRange, Trace, TraceEvent, TraceSpan, TraceStatus };