@dipseth/opensearch-logs 0.1.0

package/dist/os-playbook.js

@@ -0,0 +1,71 @@
+/**
+ * CLI entry point — DAG-based playbook runner for OpenSearch queries.
+ *
+ * Usage:
+ *   node dist/os-playbook.js --playbook incident-triage --hours 1
+ *   node dist/os-playbook.js --playbook service-deep-dive --service deal_structure --hours 2
+ *   node dist/os-playbook.js --playbook post-deploy-validation --json
+ */
+import { loadConfig, resolveIndex, parseTimeRange, parseArgs } from "./utils/index.js";
+import { createOpenSearchRepository } from "./repositories/index.js";
+import { loadPlaybook, runPlaybook, renderResults } from "./services/playbook.service.js";
+import { PlaybookDashboardService } from "./services/playbook-dashboard.service.js";
+async function main() {
+    const args = parseArgs({
+        playbook: { short: "p", type: "string", required: true },
+        env: { short: "e", type: "string", default: "production", choices: ["production", "staging"] },
+        hours: { short: "h", type: "number", default: 1 },
+        service: { short: "s", type: "string" },
+        limit: { short: "n", type: "number", default: 20 },
+        concurrency: { short: "c", type: "number", default: 4 },
+        json: { type: "boolean" },
+        dashboard: { short: "d", type: "boolean" },
+    });
+    const playbook = loadPlaybook(args.playbook);
+    const config = loadConfig();
+    const repo = createOpenSearchRepository(config);
+    const [fromDt, toDt] = parseTimeRange({ hours: args.hours });
+    const index = resolveIndex(args.env, fromDt, toDt);
+    // CLI args override playbook defaults
+    const defaults = {
+        ...playbook.defaults,
+        env: args.env,
+        ...(args.hours !== 1 && { hours: args.hours }),
+        ...(args.service && { service: args.service }),
+        ...(args.limit !== 20 && { limit: args.limit }),
+    };
+    const ctx = {
+        results: new Map(),
+        index,
+        fromDt,
+        toDt,
+        defaults,
+    };
+    process.stderr.write(`\n  Running playbook: ${playbook.name}\n`);
+    process.stderr.write(`  Steps: ${Object.keys(playbook.steps).length}\n`);
+    process.stderr.write(`  Index: ${index}\n`);
+    process.stderr.write(`  Window: ${fromDt.toISOString()} → ${toDt.toISOString()}\n\n`);
+    try {
+        const results = await runPlaybook(playbook, repo, ctx, args.concurrency);
+        renderResults(playbook, results, args.json);
+        if (args.dashboard) {
+            const dashSvc = new PlaybookDashboardService(repo);
+            const url = await dashSvc.generate(playbook, results, ctx);
+            // Dashboard URL is the primary stdout output when --dashboard is used
+            console.log(url);
+        }
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        console.error(`\n  Pipeline failed: ${msg}`);
+        // Still render partial results
+        if (ctx.results.size > 0) {
+            renderResults(playbook, ctx.results, args.json);
+        }
+        process.exit(1);
+    }
+}
+if (import.meta.url === `file://${process.argv[1]}`) {
+    main();
+}
+//# sourceMappingURL=os-playbook.js.map

package/dist/os-playbook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"os-playbook.js","sourceRoot":"","sources":["../src/os-playbook.ts"],"names":[],"mappings":"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"}

package/dist/os-search.d.ts

@@ -0,0 +1,11 @@
+/**
+ * CLI entry point — OpenSearch log search & analysis.
+ *
+ * 9 modes: search, count, histogram, timeline, dashboard, latency, errors, services, report
+ *
+ * Usage:
+ *   node dist/os-search.js --mode dashboard --hours 1
+ *   node dist/os-search.js --service deal_structure --level ERROR --hours 2
+ *   node dist/os-search.js --mode latency --hours 4
+ */
+export {};

package/dist/os-search.js

@@ -0,0 +1,84 @@
+/**
+ * CLI entry point — OpenSearch log search & analysis.
+ *
+ * 9 modes: search, count, histogram, timeline, dashboard, latency, errors, services, report
+ *
+ * Usage:
+ *   node dist/os-search.js --mode dashboard --hours 1
+ *   node dist/os-search.js --service deal_structure --level ERROR --hours 2
+ *   node dist/os-search.js --mode latency --hours 4
+ */
+import { loadConfig, resolveIndex, parseTimeRange, parseArgs, resolveServiceName } from "./utils/index.js";
+import { createOpenSearchRepository } from "./repositories/index.js";
+import { SearchService } from "./services/index.js";
+async function main() {
+    const args = parseArgs({
+        env: { type: "string", default: "production", choices: ["production", "staging"] },
+        query: { short: "q", type: "string" },
+        service: { short: "s", type: "string" },
+        level: { short: "l", type: "string" },
+        status: { type: "string" },
+        correlationId: { type: "string" },
+        hours: { type: "number" },
+        timeFrom: { type: "string" }, // --time-from or --from
+        timeTo: { type: "string" }, // --time-to or --to
+        mode: { short: "m", type: "string", default: "search", choices: ["search", "count", "histogram", "timeline", "dashboard", "latency", "errors", "services", "report"] },
+        limit: { short: "n", type: "number", default: 20 },
+        interval: { type: "string" },
+        asc: { type: "boolean" },
+        ids: { type: "boolean" },
+        full: { type: "boolean" },
+        json: { type: "boolean" },
+        link: { type: "boolean" },
+    });
+    // Handle --from / --to as aliases for --time-from / --time-to
+    const rawArgs = process.argv.slice(2);
+    for (let i = 0; i < rawArgs.length; i++) {
+        if (rawArgs[i] === "--from" && i + 1 < rawArgs.length)
+            args.timeFrom = rawArgs[++i];
+        else if (rawArgs[i] === "--to" && i + 1 < rawArgs.length)
+            args.timeTo = rawArgs[++i];
+    }
+    const config = loadConfig();
+    const repo = createOpenSearchRepository(config);
+    const service = new SearchService(repo);
+    const [fromDt, toDt] = parseTimeRange(args);
+    const index = resolveIndex(args.env, fromDt, toDt);
+    // Modes that manage their own queries
+    if (args.mode === "dashboard")
+        return service.modeDashboard(index, fromDt, toDt);
+    if (args.mode === "latency")
+        return service.modeLatency(index, fromDt, toDt, args);
+    if (args.mode === "errors")
+        return service.modeErrors(index, fromDt, toDt, args);
+    if (args.mode === "services")
+        return service.modeServices(index, fromDt, toDt);
+    if (args.mode === "report")
+        return service.modeReport(index, fromDt, toDt, args);
+    // Modes that require at least one filter
+    const hasFilters = !!(args.query || args.service || args.level || args.status || args.correlationId);
+    if (!hasFilters) {
+        console.error("ERROR: At least one filter is required: --query, --service, --level, --status, or --correlation-id");
+        process.exit(1);
+    }
+    const query = service.buildQuery(args, fromDt, toDt);
+    if (args.link) {
+        let linkQuery = args.query ?? "";
+        if (args.service)
+            linkQuery += ` AND service:"${resolveServiceName(args.service)}"`;
+        console.log(service.buildDashboardLink(linkQuery, fromDt, toDt));
+        return;
+    }
+    if (args.mode === "search")
+        await service.modeSearch(index, query, args);
+    else if (args.mode === "count")
+        await service.modeCount(index, query);
+    else if (args.mode === "histogram")
+        await service.modeHistogram(index, query, args);
+    else if (args.mode === "timeline")
+        await service.modeTimeline(index, query, args);
+}
+if (import.meta.url === `file://${process.argv[1]}`) {
+    main();
+}
+//# sourceMappingURL=os-search.js.map

package/dist/os-search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"os-search.js","sourceRoot":"","sources":["../src/os-search.ts"],"names":[],"mappings":"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"}

package/dist/repositories/index.d.ts

@@ -0,0 +1 @@
+export { OpenSearchRepository, createOpenSearchRepository } from "./opensearch.repository.js";

package/dist/repositories/index.js

@@ -0,0 +1,2 @@
+export { OpenSearchRepository, createOpenSearchRepository } from "./opensearch.repository.js";
+//# sourceMappingURL=index.js.map

package/dist/repositories/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/repositories/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/repositories/opensearch.repository.d.ts

@@ -0,0 +1,51 @@
+/**
+ * OpenSearch repository — data access layer for both APIs.
+ *
+ * - Data API (port 25060): index search, mappings, cluster health. No tenant header.
+ * - Dashboards API (port 443): saved objects, settings. Uses global tenant + osd-xsrf.
+ *
+ * Uses Node 22 native fetch. No external dependencies.
+ */
+import type { OpenSearchConfig, ApiResponse, SearchResult } from "../interfaces/interfaces.js";
+import type { OsdMonitorPayload, OsdMonitorResponse, OsdSearchMonitorsResponse, OsdExecuteResponse, NotificationChannelPayload, NotificationChannelResponse, NotificationChannelListResponse } from "../interfaces/alert.interfaces.js";
+export declare class OpenSearchRepository {
+    readonly config: OpenSearchConfig;
+    private readonly dataPort;
+    private readonly dashboardsPort;
+    private readonly tenant;
+    constructor(config: OpenSearchConfig);
+    private basicAuth;
+    private request;
+    /** Request to OpenSearch data API. No tenant header. */
+    dataApi(method: string, path: string, body?: unknown): Promise<ApiResponse>;
+    /** Search — POST /{index}/_search. Exits on error. Generic TAggs for typed aggregations. */
+    search<TAggs = Record<string, unknown>>(index: string, body: unknown): Promise<SearchResult<TAggs>>;
+    /** Count — POST /{index}/_count. Returns -1 on error. */
+    count(index: string, body: unknown): Promise<number>;
+    /** Request to OpenSearch Dashboards API (configured tenant). */
+    dashboardsApi(method: string, path: string, body?: unknown): Promise<ApiResponse>;
+    /** Create or update a saved object. Returns [action, success]. */
+    upsertSavedObject(objType: string, objId: string, body: unknown): Promise<[string, boolean]>;
+    /** Delete a saved object. */
+    deleteSavedObject(objType: string, objId: string): Promise<void>;
+    /** Get a saved object. Returns the response or null if not found. */
+    getSavedObject(objType: string, objId: string): Promise<ApiResponse | null>;
+    /** Create a monitor. Returns the created monitor response. */
+    createMonitor(body: OsdMonitorPayload): Promise<OsdMonitorResponse | null>;
+    /** Update a monitor by ID. */
+    updateMonitor(monitorId: string, body: OsdMonitorPayload): Promise<OsdMonitorResponse | null>;
+    /** Delete a monitor by ID. */
+    deleteMonitor(monitorId: string): Promise<boolean>;
+    /** Execute (dry-run) a monitor by ID. */
+    executeMonitor(monitorId: string): Promise<OsdExecuteResponse | null>;
+    /** Search monitors using an OpenSearch query. */
+    searchMonitors(query: Record<string, unknown>): Promise<OsdSearchMonitorsResponse | null>;
+    /** Create a notification channel. Returns the config_id or null. */
+    createNotificationChannel(body: NotificationChannelPayload): Promise<NotificationChannelResponse | null>;
+    /** List notification channels. */
+    listNotificationChannels(): Promise<NotificationChannelListResponse | null>;
+    /** Delete a notification channel by config_id. */
+    deleteNotificationChannel(configId: string): Promise<boolean>;
+}
+/** Factory — create a repository instance with the given config. */
+export declare function createOpenSearchRepository(config: OpenSearchConfig): OpenSearchRepository;

package/dist/repositories/opensearch.repository.js

@@ -0,0 +1,167 @@
+/**
+ * OpenSearch repository — data access layer for both APIs.
+ *
+ * - Data API (port 25060): index search, mappings, cluster health. No tenant header.
+ * - Dashboards API (port 443): saved objects, settings. Uses global tenant + osd-xsrf.
+ *
+ * Uses Node 22 native fetch. No external dependencies.
+ */
+const DEFAULT_DATA_API_PORT = 25060;
+const DEFAULT_DASHBOARDS_API_PORT = 443;
+const DEFAULT_TENANT = "global";
+const TIMEOUT_MS = 30_000;
+export class OpenSearchRepository {
+    config;
+    dataPort;
+    dashboardsPort;
+    tenant;
+    constructor(config) {
+        this.config = config;
+        this.dataPort = config.dataPort ?? DEFAULT_DATA_API_PORT;
+        this.dashboardsPort = config.dashboardsPort ?? DEFAULT_DASHBOARDS_API_PORT;
+        this.tenant = config.tenant ?? DEFAULT_TENANT;
+    }
+    basicAuth() {
+        return Buffer.from(`${this.config.username}:${this.config.password}`).toString("base64");
+    }
+    async request(port, method, path, body, tenant) {
+        const url = `https://${this.config.host}:${port}${path}`;
+        const headers = {
+            Authorization: `Basic ${this.basicAuth()}`,
+            "Content-Type": "application/json",
+        };
+        if (tenant) {
+            headers["securitytenant"] = tenant;
+            headers["osd-xsrf"] = "true";
+        }
+        const init = {
+            method,
+            headers,
+            signal: AbortSignal.timeout(TIMEOUT_MS),
+        };
+        if (body !== undefined) {
+            init.body = JSON.stringify(body);
+        }
+        try {
+            const resp = await fetch(url, init);
+            const text = await resp.text();
+            if (!resp.ok) {
+                if (resp.status === 409)
+                    return { _conflict: true };
+                if (resp.status === 404)
+                    return { _not_found: true };
+                return { _error: true, _code: resp.status, _body: text.slice(0, 300) };
+            }
+            return JSON.parse(text);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            return { _error: true, _reason: msg };
+        }
+    }
+    // ── Data API (port 25060) ────────────────────────────────────────────
+    /** Request to OpenSearch data API. No tenant header. */
+    async dataApi(method, path, body) {
+        return this.request(this.dataPort, method, path, body);
+    }
+    /** Search — POST /{index}/_search. Exits on error. Generic TAggs for typed aggregations. */
+    async search(index, body) {
+        const result = await this.dataApi("POST", `/${index}/_search`, body);
+        if (result._error) {
+            console.error(`ERROR: OpenSearch search failed: ${result._body ?? result._reason}`);
+            process.exit(1);
+        }
+        return result;
+    }
+    /** Count — POST /{index}/_count. Returns -1 on error. */
+    async count(index, body) {
+        const result = await this.dataApi("POST", `/${index}/_count`, body);
+        if (result._error)
+            return -1;
+        return result.count;
+    }
+    // ── Dashboards API (port 443) ────────────────────────────────────────
+    /** Request to OpenSearch Dashboards API (configured tenant). */
+    async dashboardsApi(method, path, body) {
+        return this.request(this.dashboardsPort, method, path, body, this.tenant);
+    }
+    /** Create or update a saved object. Returns [action, success]. */
+    async upsertSavedObject(objType, objId, body) {
+        let result = await this.dashboardsApi("POST", `/api/saved_objects/${objType}/${objId}`, body);
+        if (result?._conflict) {
+            result = await this.dashboardsApi("PUT", `/api/saved_objects/${objType}/${objId}`, body);
+            return ["updated", !!result && !result._error];
+        }
+        return ["created", !!result && !result._error];
+    }
+    /** Delete a saved object. */
+    async deleteSavedObject(objType, objId) {
+        await this.dashboardsApi("DELETE", `/api/saved_objects/${objType}/${objId}`);
+    }
+    /** Get a saved object. Returns the response or null if not found. */
+    async getSavedObject(objType, objId) {
+        const result = await this.dashboardsApi("GET", `/api/saved_objects/${objType}/${objId}`);
+        if (result._not_found || result._error)
+            return null;
+        return result;
+    }
+    // ── Alerting API (_plugins/_alerting) ─────────────────────────────────
+    /** Create a monitor. Returns the created monitor response. */
+    async createMonitor(body) {
+        const result = await this.dataApi("POST", "/_plugins/_alerting/monitors", body);
+        if (result._error)
+            return null;
+        return result;
+    }
+    /** Update a monitor by ID. */
+    async updateMonitor(monitorId, body) {
+        const result = await this.dataApi("PUT", `/_plugins/_alerting/monitors/${monitorId}`, body);
+        if (result._error)
+            return null;
+        return result;
+    }
+    /** Delete a monitor by ID. */
+    async deleteMonitor(monitorId) {
+        const result = await this.dataApi("DELETE", `/_plugins/_alerting/monitors/${monitorId}`);
+        return !result._error;
+    }
+    /** Execute (dry-run) a monitor by ID. */
+    async executeMonitor(monitorId) {
+        const result = await this.dataApi("POST", `/_plugins/_alerting/monitors/${monitorId}/_execute`);
+        if (result._error)
+            return null;
+        return result;
+    }
+    /** Search monitors using an OpenSearch query. */
+    async searchMonitors(query) {
+        const result = await this.dataApi("POST", "/_plugins/_alerting/monitors/_search", query);
+        if (result._error || result._not_found)
+            return null;
+        return result;
+    }
+    // ── Notifications API (_plugins/_notifications) ─────────────────────
+    /** Create a notification channel. Returns the config_id or null. */
+    async createNotificationChannel(body) {
+        const result = await this.dataApi("POST", "/_plugins/_notifications/configs", body);
+        if (result._error)
+            return null;
+        return result;
+    }
+    /** List notification channels. */
+    async listNotificationChannels() {
+        const result = await this.dataApi("GET", "/_plugins/_notifications/configs");
+        if (result._error || result._not_found)
+            return null;
+        return result;
+    }
+    /** Delete a notification channel by config_id. */
+    async deleteNotificationChannel(configId) {
+        const result = await this.dataApi("DELETE", `/_plugins/_notifications/configs/${configId}`);
+        return !result._error;
+    }
+}
+/** Factory — create a repository instance with the given config. */
+export function createOpenSearchRepository(config) {
+    return new OpenSearchRepository(config);
+}
+//# sourceMappingURL=opensearch.repository.js.map

package/dist/repositories/opensearch.repository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"opensearch.repository.js","sourceRoot":"","sources":["../../src/repositories/opensearch.repository.ts"],"names":[],"mappings":"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"}

package/dist/services/alert.service.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Alert service — load YAML alert profiles, resolve templates,
+ * and CRUD monitors/destinations on OSD.
+ */
+import type { OpenSearchRepository } from "../repositories/opensearch.repository.js";
+import type { AlertProfile, MonitorDef, TemplateContext, HealthReport, MonitorListItem, OsdMonitorPayload, OsdExecuteResponse } from "../interfaces/alert.interfaces.js";
+export declare class AlertService {
+    private repo;
+    constructor(repo: OpenSearchRepository);
+    /** Load and parse an alert profile YAML. */
+    loadProfile(profileName: string): AlertProfile;
+    /**
+     * Build flat context from profile thresholds, defaults, and CLI overrides.
+     * This context resolves {{thresholds.*}} and {{defaults.*}} expressions.
+     */
+    buildContext(profile: AlertProfile, overrides?: {
+        service?: string;
+        dashboardUrl?: string;
+        env?: string;
+    }): TemplateContext;
+    /**
+     * Resolve all pre-flight templates in a string.
+     * {{thresholds.*}}, {{defaults.*}} are resolved.
+     * {{ctx.*}} expressions are passed through for OSD Mustache.
+     */
+    resolveString(value: string, context: TemplateContext): string;
+    /**
+     * Ensure a notification channel exists. Searches by name first; creates if missing.
+     * Returns the channel config_id (used as destination_id in monitor actions).
+     */
+    ensureNotificationChannel(channelName: string, webhookUrl: string): Promise<string>;
+    /**
+     * Build an OSD monitor payload from a profile monitor definition.
+     */
+    buildMonitorPayload(profileName: string, monitorKey: string, monitorDef: MonitorDef, destinationId: string, cardTemplate: string, context: TemplateContext, env: string): OsdMonitorPayload;
+    /**
+     * Wrap a user query in a bool+filter with a relative time range
+     * so the monitor scans recent data each period.
+     * If the query contains an `aggs` key, hoist it to the top level.
+     */
+    private buildSearchQuery;
+    /**
+     * Create all monitors for a profile (or a single monitor if monitorKey is specified).
+     * Returns array of [monitorKey, monitorId, created] tuples.
+     */
+    createMonitors(profile: AlertProfile, webhookUrl: string, context: TemplateContext, env: string, monitorKey?: string): Promise<Array<[string, string, boolean]>>;
+    /**
+     * Generate payloads for all monitors without calling the API (dry-run).
+     */
+    dryRunMonitors(profile: AlertProfile, webhookUrl: string, context: TemplateContext, env: string, monitorKey?: string): Array<[string, OsdMonitorPayload]>;
+    /** Find a monitor ID by exact name. Returns ID or null. */
+    findMonitorByName(name: string): Promise<string | null>;
+    /**
+     * List monitors, optionally filtered by profile prefix.
+     */
+    listMonitors(profileName?: string): Promise<MonitorListItem[]>;
+    /**
+     * Delete all monitors for a profile.
+     * Returns array of [name, deleted] tuples.
+     */
+    deleteMonitors(profileName: string): Promise<Array<[string, boolean]>>;
+    /**
+     * Execute (dry-run) a single monitor by profile + monitor key.
+     */
+    executeMonitor(profileName: string, monitorKey: string): Promise<OsdExecuteResponse | null>;
+    /**
+     * Gather a live production health report by querying OpenSearch.
+     * Returns structured data suitable for building a Google Chat card.
+     */
+    gatherHealthReport(index: string, fromDt: Date, toDt: Date, env: string, _service?: string): Promise<HealthReport>;
+    private serviceFilter;
+    private latencyScriptedMetric;
+}