@openchoreo/backstage-plugin-openchoreo-observability 1.1.0

package/CHANGELOG.md

@@ -0,0 +1,5 @@
+# @openchoreo/backstage-plugin-openchoreo-observability
+
+## 1.1.0
+
+- Initial public release on GitHub Packages, aligned with the OpenChoreo platform release line (`1.1.0`).

package/README.md

@@ -0,0 +1,22 @@
+# openchoreo-observability
+
+Welcome to the openchoreo-observability plugin!
+
+_This plugin was created through the Backstage CLI_
+
+## Features
+
+- **Logs**: Component-level and project-level runtime logs with filtering
+- **Metrics**: Resource and HTTP metrics for components
+- **Traces**: Distributed tracing for component requests
+- **Alerts**: Component-level triggered alerts with severity, time range, and environment filters. Alerts can link to the project Incidents tab when incident management is enabled.
+- **Incidents**: Project-level incidents with status, component, and environment filters. Incidents with AI RCA enabled can link to the RCA Reports tab.
+- **RCA Reports**: Root cause analysis reports for incidents
+
+## Getting started
+
+Your plugin has been added to the example app in this repository, meaning you'll be able to access it by running `yarn start` in the root directory, and then navigating to [/openchoreo-observability](http://localhost:3000/openchoreo-observability).
+
+You can also serve the plugin in isolation by running `yarn start` in the plugin directory.
+This method of serving the plugin provides quicker iteration speed and a faster startup and hot reloads.
+It is only meant for local development, and the setup for it can be found inside the [/dev](./dev) directory.

package/dist/api/FinOpsAgentApi.esm.js

@@ -0,0 +1,43 @@
+import { createApiRef } from '@backstage/core-plugin-api';
+import { ObserverUrlCache } from './ObserverUrlCache.esm.js';
+
+const finopsAgentApiRef = createApiRef({
+  id: "plugin.openchoreo-finops-agent.service"
+});
+class FinOpsAgentClient {
+  fetchApi;
+  urlCache;
+  constructor(options) {
+    this.fetchApi = options.fetchApi;
+    this.urlCache = new ObserverUrlCache(options);
+  }
+  async updateActionStatuses(reportId, routing, update) {
+    const { finopsAgentUrl } = await this.urlCache.resolveUrls(
+      routing.namespaceName,
+      routing.environmentName
+    );
+    if (!finopsAgentUrl) {
+      throw new Error("FinOps service is not configured");
+    }
+    const response = await this.fetchApi.fetch(
+      `${finopsAgentUrl}/api/v1alpha1/reports/${encodeURIComponent(reportId)}`,
+      {
+        method: "PUT",
+        body: JSON.stringify(update),
+        headers: {
+          "Content-Type": "application/json",
+          "x-openchoreo-direct": "true"
+        }
+      }
+    );
+    if (!response.ok) {
+      const error = await response.json().catch(() => ({}));
+      throw new Error(
+        error.detail || `Update report failed: ${response.statusText}`
+      );
+    }
+  }
+}
+
+export { FinOpsAgentClient, finopsAgentApiRef };
+//# sourceMappingURL=FinOpsAgentApi.esm.js.map

package/dist/api/FinOpsAgentApi.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FinOpsAgentApi.esm.js","sources":["../../src/api/FinOpsAgentApi.ts"],"sourcesContent":["import {\n  createApiRef,\n  DiscoveryApi,\n  FetchApi,\n} from '@backstage/core-plugin-api';\nimport { ObserverUrlCache } from './ObserverUrlCache';\n\nexport interface FinOpsRoutingContext {\n  namespaceName: string;\n  environmentName: string;\n}\n\nexport interface FinOpsAgentApi {\n  updateActionStatuses(\n    reportId: string,\n    routing: FinOpsRoutingContext,\n    update: { appliedIndices?: number[]; dismissedIndices?: number[] },\n  ): Promise<void>;\n}\n\nexport const finopsAgentApiRef = createApiRef<FinOpsAgentApi>({\n  id: 'plugin.openchoreo-finops-agent.service',\n});\n\nexport class FinOpsAgentClient implements FinOpsAgentApi {\n  private readonly fetchApi: FetchApi;\n  private readonly urlCache: ObserverUrlCache;\n\n  constructor(options: { discoveryApi: DiscoveryApi; fetchApi: FetchApi }) {\n    this.fetchApi = options.fetchApi;\n    this.urlCache = new ObserverUrlCache(options);\n  }\n\n  async updateActionStatuses(\n    reportId: string,\n    routing: FinOpsRoutingContext,\n    update: { appliedIndices?: number[]; dismissedIndices?: number[] },\n  ): Promise<void> {\n    const { finopsAgentUrl } = await this.urlCache.resolveUrls(\n      routing.namespaceName,\n      routing.environmentName,\n    );\n\n    if (!finopsAgentUrl) {\n      throw new Error('FinOps service is not configured');\n    }\n\n    const response = await this.fetchApi.fetch(\n      `${finopsAgentUrl}/api/v1alpha1/reports/${encodeURIComponent(reportId)}`,\n      {\n        method: 'PUT',\n        body: JSON.stringify(update),\n        headers: {\n          'Content-Type': 'application/json',\n          'x-openchoreo-direct': 'true',\n        },\n      },\n    );\n\n    if (!response.ok) {\n      const error = await response.json().catch(() => ({}));\n      throw new Error(\n        error.detail || `Update report failed: ${response.statusText}`,\n      );\n    }\n  }\n}\n"],"names":[],"mappings":";;;AAoBO,MAAM,oBAAoB,YAAA,CAA6B;AAAA,EAC5D,EAAA,EAAI;AACN,CAAC;AAEM,MAAM,iBAAA,CAA4C;AAAA,EACtC,QAAA;AAAA,EACA,QAAA;AAAA,EAEjB,YAAY,OAAA,EAA6D;AACvE,IAAA,IAAA,CAAK,WAAW,OAAA,CAAQ,QAAA;AACxB,IAAA,IAAA,CAAK,QAAA,GAAW,IAAI,gBAAA,CAAiB,OAAO,CAAA;AAAA,EAC9C;AAAA,EAEA,MAAM,oBAAA,CACJ,QAAA,EACA,OAAA,EACA,MAAA,EACe;AACf,IAAA,MAAM,EAAE,cAAA,EAAe,GAAI,MAAM,KAAK,QAAA,CAAS,WAAA;AAAA,MAC7C,OAAA,CAAQ,aAAA;AAAA,MACR,OAAA,CAAQ;AAAA,KACV;AAEA,IAAA,IAAI,CAAC,cAAA,EAAgB;AACnB,MAAA,MAAM,IAAI,MAAM,kCAAkC,CAAA;AAAA,IACpD;AAEA,IAAA,MAAM,QAAA,GAAW,MAAM,IAAA,CAAK,QAAA,CAAS,KAAA;AAAA,MACnC,CAAA,EAAG,cAAc,CAAA,sBAAA,EAAyB,kBAAA,CAAmB,QAAQ,CAAC,CAAA,CAAA;AAAA,MACtE;AAAA,QACE,MAAA,EAAQ,KAAA;AAAA,QACR,IAAA,EAAM,IAAA,CAAK,SAAA,CAAU,MAAM,CAAA;AAAA,QAC3B,OAAA,EAAS;AAAA,UACP,cAAA,EAAgB,kBAAA;AAAA,UAChB,qBAAA,EAAuB;AAAA;AACzB;AACF,KACF;AAEA,IAAA,IAAI,CAAC,SAAS,EAAA,EAAI;AAChB,MAAA,MAAM,KAAA,GAAQ,MAAM,QAAA,CAAS,IAAA,GAAO,KAAA,CAAM,OAAO,EAAC,CAAE,CAAA;AACpD,MAAA,MAAM,IAAI,KAAA;AAAA,QACR,KAAA,CAAM,MAAA,IAAU,CAAA,sBAAA,EAAyB,QAAA,CAAS,UAAU,CAAA;AAAA,OAC9D;AAAA,IACF;AAAA,EACF;AACF;;;;"}

package/dist/api/ObservabilityApi.esm.js

@@ -0,0 +1,568 @@
+import { createApiRef } from '@backstage/core-plugin-api';
+import { ObserverUrlCache } from './ObserverUrlCache.esm.js';
+
+const observabilityApiRef = createApiRef({
+  id: "plugin.openchoreo-observability.service"
+});
+const DIRECT_HEADER = { "x-openchoreo-direct": "true" };
+class ObservabilityClient {
+  fetchApi;
+  urlCache;
+  constructor(options) {
+    this.fetchApi = options.fetchApi;
+    this.urlCache = new ObserverUrlCache(options);
+  }
+  async getMetrics(environmentName, componentName, namespaceName, projectName, options) {
+    const { observerUrl } = await this.urlCache.resolveUrls(
+      namespaceName,
+      environmentName
+    );
+    const searchScope = {
+      namespace: namespaceName,
+      project: projectName,
+      component: componentName,
+      environment: environmentName
+    };
+    const baseBody = {
+      startTime: options?.startTime ?? new Date(Date.now() - 36e5).toISOString(),
+      endTime: options?.endTime ?? (/* @__PURE__ */ new Date()).toISOString(),
+      searchScope,
+      ...options?.step ? { step: options.step } : {}
+    };
+    const fetchOptions = {
+      method: "POST",
+      headers: { "Content-Type": "application/json", ...DIRECT_HEADER }
+    };
+    const metricType = options?.type ?? "resource";
+    const response = await this.fetchApi.fetch(
+      `${observerUrl}/api/v1/metrics/query`,
+      {
+        ...fetchOptions,
+        body: JSON.stringify({ ...baseBody, metric: metricType })
+      }
+    );
+    if (!response.ok) {
+      const error = await this.parseError(response);
+      if (error.includes("Observability is not configured for component")) {
+        throw new Error("Observability is not enabled for this component");
+      }
+      throw new Error(
+        error || `Failed to fetch metrics: ${response.statusText}`
+      );
+    }
+    const data = await response.json();
+    switch (metricType) {
+      case "resource":
+        return {
+          cpuUsage: {
+            cpuUsage: data.cpuUsage ?? [],
+            cpuRequests: data.cpuRequests ?? [],
+            cpuLimits: data.cpuLimits ?? []
+          },
+          memoryUsage: {
+            memoryUsage: data.memoryUsage ?? [],
+            memoryRequests: data.memoryRequests ?? [],
+            memoryLimits: data.memoryLimits ?? []
+          }
+        };
+      case "http":
+        return {
+          networkThroughput: {
+            requestCount: data.requestCount ?? [],
+            successfulRequestCount: data.successfulRequestCount ?? [],
+            unsuccessfulRequestCount: data.unsuccessfulRequestCount ?? []
+          },
+          networkLatency: {
+            meanLatency: data.meanLatency ?? [],
+            latencyP50: data.latencyP50 ?? [],
+            latencyP90: data.latencyP90 ?? [],
+            latencyP99: data.latencyP99 ?? []
+          }
+        };
+      default:
+        throw new Error(`Unsupported metric type: ${metricType}`);
+    }
+  }
+  async getTraces(namespaceName, projectName, environmentName, componentName, options) {
+    const { observerUrl } = await this.urlCache.resolveUrls(
+      namespaceName,
+      environmentName
+    );
+    const response = await this.fetchApi.fetch(
+      `${observerUrl}/api/v1alpha1/traces/query`,
+      {
+        method: "POST",
+        headers: { "Content-Type": "application/json", ...DIRECT_HEADER },
+        body: JSON.stringify({
+          startTime: options?.startTime ?? new Date(Date.now() - 36e5).toISOString(),
+          endTime: options?.endTime ?? (/* @__PURE__ */ new Date()).toISOString(),
+          limit: options?.limit ?? 100,
+          sortOrder: options?.sortOrder ?? "desc",
+          searchScope: {
+            namespace: namespaceName,
+            project: projectName,
+            ...componentName ? { component: componentName } : {},
+            environment: environmentName
+          }
+        })
+      }
+    );
+    if (!response.ok) {
+      const error = await this.parseError(response);
+      if (error.includes("Observability is not configured for component")) {
+        throw new Error("Observability is not enabled for this component");
+      }
+      throw new Error(
+        error || `Failed to fetch traces: ${response.statusText}`
+      );
+    }
+    const data = await response.json();
+    return {
+      traces: (data.traces ?? []).map((t) => ({
+        traceId: t.traceId ?? "",
+        traceName: t.traceName,
+        spanCount: t.spanCount ?? 0,
+        rootSpanId: t.rootSpanId,
+        rootSpanName: t.rootSpanName,
+        rootSpanKind: t.rootSpanKind,
+        startTime: t.startTime ?? "",
+        endTime: t.endTime ?? "",
+        durationNs: t.durationNs ?? 0,
+        hasErrors: t.hasErrors ?? false
+      })),
+      total: data.total ?? 0,
+      tookMs: data.tookMs ?? 0
+    };
+  }
+  async getTraceSpans(traceId, namespaceName, projectName, environmentName, componentName, options) {
+    const { observerUrl } = await this.urlCache.resolveUrls(
+      namespaceName,
+      environmentName
+    );
+    const response = await this.fetchApi.fetch(
+      `${observerUrl}/api/v1alpha1/traces/${encodeURIComponent(
+        traceId
+      )}/spans/query`,
+      {
+        method: "POST",
+        headers: { "Content-Type": "application/json", ...DIRECT_HEADER },
+        body: JSON.stringify({
+          startTime: options?.startTime ?? new Date(Date.now() - 36e5).toISOString(),
+          endTime: options?.endTime ?? (/* @__PURE__ */ new Date()).toISOString(),
+          limit: 1e3,
+          sortOrder: "asc",
+          searchScope: {
+            namespace: namespaceName,
+            project: projectName,
+            ...componentName ? { component: componentName } : {},
+            environment: environmentName
+          }
+        })
+      }
+    );
+    if (!response.ok) {
+      const error = await this.parseError(response);
+      throw new Error(
+        error || `Failed to fetch spans for trace ${traceId}: ${response.statusText}`
+      );
+    }
+    const data = await response.json();
+    return {
+      spans: (data.spans ?? []).map((s) => ({
+        spanId: s.spanId ?? "",
+        spanName: s.spanName ?? "",
+        spanKind: s.spanKind,
+        startTime: s.startTime ?? "",
+        endTime: s.endTime ?? "",
+        durationNs: s.durationNs ?? 0,
+        parentSpanId: s.parentSpanId,
+        status: s.status
+      })),
+      total: data.total ?? 0,
+      tookMs: data.tookMs ?? 0
+    };
+  }
+  async getSpanDetails(traceId, spanId, namespaceName, environmentName) {
+    const { observerUrl } = await this.urlCache.resolveUrls(
+      namespaceName,
+      environmentName
+    );
+    const response = await this.fetchApi.fetch(
+      `${observerUrl}/api/v1alpha1/traces/${encodeURIComponent(
+        traceId
+      )}/spans/${encodeURIComponent(spanId)}`,
+      {
+        headers: { ...DIRECT_HEADER }
+      }
+    );
+    if (!response.ok) {
+      const error = await this.parseError(response);
+      throw new Error(
+        error || `Failed to fetch span details for span ${spanId}: ${response.statusText}`
+      );
+    }
+    const data = await response.json();
+    return {
+      spanId: data.spanId ?? "",
+      spanName: data.spanName ?? "",
+      spanKind: data.spanKind,
+      startTime: data.startTime ?? "",
+      endTime: data.endTime ?? "",
+      durationNs: data.durationNs ?? 0,
+      parentSpanId: data.parentSpanId,
+      attributes: data.attributes,
+      resourceAttributes: data.resourceAttributes
+    };
+  }
+  async getRCAReports(namespaceName, projectName, environmentName, options) {
+    const { rcaAgentUrl } = await this.urlCache.resolveUrls(
+      namespaceName,
+      environmentName
+    );
+    if (!rcaAgentUrl) {
+      throw new Error("RCA service is not configured");
+    }
+    const url = new URL(`${rcaAgentUrl}/api/v1/rca-agent/reports`);
+    url.searchParams.set("namespace", namespaceName);
+    url.searchParams.set("project", projectName);
+    url.searchParams.set("environment", environmentName);
+    if (options?.startTime)
+      url.searchParams.set("startTime", options.startTime);
+    if (options?.endTime) url.searchParams.set("endTime", options.endTime);
+    if (options?.status) url.searchParams.set("status", options.status);
+    if (options?.limit !== void 0)
+      url.searchParams.set("limit", String(options.limit));
+    let response;
+    try {
+      response = await this.fetchApi.fetch(url.toString(), {
+        headers: { ...DIRECT_HEADER }
+      });
+    } catch (err) {
+      throw new Error(
+        `RCA service is unreachable: ${err instanceof Error ? err.message : err}`
+      );
+    }
+    if (!response.ok) {
+      const error = await this.parseError(response);
+      if (error.includes("RCA service is not configured")) {
+        throw new Error("RCA service is not configured");
+      }
+      if (error.includes("Observability is not configured for component")) {
+        throw new Error("Observability is not enabled for this component");
+      }
+      throw new Error(
+        error || `Failed to fetch RCA reports: ${response.statusText}`
+      );
+    }
+    const data = await response.json();
+    return {
+      reports: data.reports || [],
+      totalCount: data.totalCount
+    };
+  }
+  async getRCAReport(reportId, environmentName, namespaceName) {
+    const { rcaAgentUrl } = await this.urlCache.resolveUrls(
+      namespaceName,
+      environmentName
+    );
+    if (!rcaAgentUrl) {
+      throw new Error("RCA service is not configured");
+    }
+    const url = new URL(
+      `${rcaAgentUrl}/api/v1/rca-agent/reports/${encodeURIComponent(reportId)}`
+    );
+    let response;
+    try {
+      response = await this.fetchApi.fetch(url.toString(), {
+        headers: { ...DIRECT_HEADER }
+      });
+    } catch (err) {
+      throw new Error(
+        `RCA service is unreachable: ${err instanceof Error ? err.message : err}`
+      );
+    }
+    if (!response.ok) {
+      const error = await this.parseError(response);
+      if (error.includes("RCA service is not configured")) {
+        throw new Error("RCA service is not configured");
+      }
+      if (error.includes("RCA report not found")) {
+        throw new Error("RCA report not found");
+      }
+      throw new Error(
+        error || `Failed to fetch RCA report: ${response.statusText}`
+      );
+    }
+    const data = await response.json();
+    return data;
+  }
+  async getIncidents(namespaceName, projectName, environmentName, componentName, options) {
+    const { observerUrl } = await this.urlCache.resolveUrls(
+      namespaceName,
+      environmentName
+    );
+    const response = await this.fetchApi.fetch(
+      `${observerUrl}/api/v1alpha1/incidents/query`,
+      {
+        method: "POST",
+        headers: { "Content-Type": "application/json", ...DIRECT_HEADER },
+        body: JSON.stringify({
+          startTime: options?.startTime ?? new Date(Date.now() - 36e5).toISOString(),
+          endTime: options?.endTime ?? (/* @__PURE__ */ new Date()).toISOString(),
+          limit: options?.limit ?? 100,
+          sortOrder: options?.sortOrder ?? "desc",
+          searchScope: {
+            namespace: namespaceName,
+            project: projectName,
+            ...componentName ? { component: componentName } : {},
+            environment: environmentName
+          }
+        })
+      }
+    );
+    if (!response.ok) {
+      const error = await this.parseError(response);
+      if (error.includes("Observability is not configured for component")) {
+        throw new Error("Observability is not enabled for this component");
+      }
+      throw new Error(
+        error || `Failed to fetch incidents: ${response.statusText}`
+      );
+    }
+    const data = await response.json();
+    const validStatuses = ["active", "acknowledged", "resolved"];
+    return {
+      incidents: (data.incidents ?? []).filter((i) => validStatuses.includes(i.status)).map(
+        (i) => ({
+          incidentId: i.incidentId ?? "",
+          alertId: i.alertId ?? "",
+          status: i.status,
+          description: i.description,
+          notes: i.notes,
+          timestamp: i.timestamp,
+          triggeredAt: i.triggeredAt,
+          acknowledgedAt: i.acknowledgedAt,
+          resolvedAt: i.resolvedAt,
+          incidentTriggerAiRca: i.incidentTriggerAiRca ?? false,
+          incidentTriggerAiCostAnalysis: i.incidentTriggerAiCostAnalysis ?? false,
+          projectName: i.labels?.projectName,
+          componentName: i.labels?.componentName,
+          environmentName: i.labels?.environmentName,
+          namespaceName: i.labels?.namespaceName
+        })
+      ),
+      total: data.total ?? 0
+    };
+  }
+  async getAlerts(namespaceName, projectName, environmentName, componentName, options) {
+    const { observerUrl } = await this.urlCache.resolveUrls(
+      namespaceName,
+      environmentName
+    );
+    const response = await this.fetchApi.fetch(
+      `${observerUrl}/api/v1alpha1/alerts/query`,
+      {
+        method: "POST",
+        headers: { "Content-Type": "application/json", ...DIRECT_HEADER },
+        body: JSON.stringify({
+          startTime: options?.startTime ?? new Date(Date.now() - 36e5).toISOString(),
+          endTime: options?.endTime ?? (/* @__PURE__ */ new Date()).toISOString(),
+          limit: options?.limit ?? 100,
+          sortOrder: options?.sortOrder ?? "desc",
+          searchScope: {
+            namespace: namespaceName,
+            project: projectName,
+            component: componentName,
+            environment: environmentName
+          }
+        })
+      }
+    );
+    if (!response.ok) {
+      const error = await this.parseError(response);
+      if (error.includes("Observability is not configured for component")) {
+        throw new Error("Observability is not enabled for this component");
+      }
+      throw new Error(
+        error || `Failed to fetch alerts: ${response.statusText}`
+      );
+    }
+    const data = await response.json();
+    return {
+      alerts: (data.alerts ?? []).map(
+        (a) => ({
+          timestamp: a.timestamp,
+          alertId: a.alertId ?? "",
+          alertValue: a.alertValue,
+          ruleName: a.metadata?.alertRule?.name,
+          ruleDescription: a.metadata?.alertRule?.description,
+          severity: a.metadata?.alertRule?.severity,
+          sourceType: a.metadata?.alertRule?.source?.type,
+          sourceQuery: a.metadata?.alertRule?.source?.query,
+          sourceMetric: a.metadata?.alertRule?.source?.metric,
+          projectName: a.metadata?.labels?.projectName,
+          componentName: a.metadata?.labels?.componentName,
+          environmentName: a.metadata?.labels?.environmentName,
+          namespaceName: a.metadata?.labels?.namespaceName,
+          notificationChannels: a.notificationChannels ?? [],
+          incidentEnabled: a.incidentEnabled ?? false
+        })
+      ),
+      total: data.total ?? 0
+    };
+  }
+  async getRuntimeLogs(namespaceName, projectName, environmentName, componentName, options) {
+    const { observerUrl } = await this.urlCache.resolveUrls(
+      namespaceName,
+      environmentName
+    );
+    const response = await this.fetchApi.fetch(
+      `${observerUrl}/api/v1/logs/query`,
+      {
+        method: "POST",
+        headers: { "Content-Type": "application/json", ...DIRECT_HEADER },
+        body: JSON.stringify({
+          startTime: options?.startTime || new Date(Date.now() - 60 * 60 * 1e3).toISOString(),
+          endTime: options?.endTime || (/* @__PURE__ */ new Date()).toISOString(),
+          limit: options?.limit || 100,
+          sortOrder: options?.sortOrder || "desc",
+          ...options?.logLevels && options.logLevels.length > 0 && { logLevels: options.logLevels },
+          ...options?.searchQuery && {
+            searchPhrase: options.searchQuery
+          },
+          searchScope: {
+            namespace: namespaceName,
+            project: projectName,
+            ...componentName ? { component: componentName } : {},
+            environment: environmentName
+          }
+        })
+      }
+    );
+    if (!response.ok) {
+      const error = await this.parseError(response);
+      if (error.includes("Observability is not configured for component")) {
+        throw new Error("Observability is not enabled for this component");
+      }
+      throw new Error(
+        error || `Failed to fetch runtime logs: ${response.status} ${response.statusText}`
+      );
+    }
+    const data = await response.json();
+    return data;
+  }
+  async updateIncidentStatus(incidentId, status, namespaceName, environmentName) {
+    const { observerUrl } = await this.urlCache.resolveUrls(
+      namespaceName,
+      environmentName
+    );
+    const response = await this.fetchApi.fetch(
+      `${observerUrl}/api/v1alpha1/incidents/${encodeURIComponent(incidentId)}`,
+      {
+        method: "PUT",
+        headers: { "Content-Type": "application/json", ...DIRECT_HEADER },
+        body: JSON.stringify({ status })
+      }
+    );
+    if (!response.ok) {
+      const error = await this.parseError(response);
+      throw new Error(
+        error || `Failed to update incident: ${response.statusText}`
+      );
+    }
+  }
+  async getFinOpsReports(namespaceName, projectName, environmentName, options) {
+    const { finopsAgentUrl } = await this.urlCache.resolveUrls(
+      namespaceName,
+      environmentName
+    );
+    if (!finopsAgentUrl) {
+      throw new Error("FinOps service is not configured");
+    }
+    const url = new URL(`${finopsAgentUrl}/api/v1alpha1/reports`);
+    url.searchParams.set("namespace", namespaceName);
+    url.searchParams.set("project", projectName);
+    url.searchParams.set("environment", environmentName);
+    if (options?.startTime)
+      url.searchParams.set("startTime", options.startTime);
+    if (options?.endTime) url.searchParams.set("endTime", options.endTime);
+    if (options?.status) url.searchParams.set("status", options.status);
+    if (options?.limit !== void 0)
+      url.searchParams.set("limit", String(options.limit));
+    if (options?.sort) url.searchParams.set("sort", options.sort);
+    let response;
+    try {
+      response = await this.fetchApi.fetch(url.toString(), {
+        headers: { ...DIRECT_HEADER }
+      });
+    } catch (err) {
+      throw new Error(
+        `FinOps service is unreachable: ${err instanceof Error ? err.message : err}`
+      );
+    }
+    if (!response.ok) {
+      const error = await this.parseError(response);
+      if (error.includes("FinOps service is not configured")) {
+        throw new Error("FinOps service is not configured");
+      }
+      if (error.includes("Observability is not configured for component")) {
+        throw new Error("Observability is not enabled for this component");
+      }
+      throw new Error(
+        error || `Failed to fetch FinOps reports: ${response.statusText}`
+      );
+    }
+    const data = await response.json();
+    return {
+      reports: data.reports || [],
+      totalCount: data.totalCount
+    };
+  }
+  async getFinOpsReport(reportId, environmentName, namespaceName) {
+    const { finopsAgentUrl } = await this.urlCache.resolveUrls(
+      namespaceName,
+      environmentName
+    );
+    if (!finopsAgentUrl) {
+      throw new Error("FinOps service is not configured");
+    }
+    const url = new URL(
+      `${finopsAgentUrl}/api/v1alpha1/reports/${encodeURIComponent(reportId)}`
+    );
+    let response;
+    try {
+      response = await this.fetchApi.fetch(url.toString(), {
+        headers: { ...DIRECT_HEADER }
+      });
+    } catch (err) {
+      throw new Error(
+        `FinOps service is unreachable: ${err instanceof Error ? err.message : err}`
+      );
+    }
+    if (!response.ok) {
+      const error = await this.parseError(response);
+      if (error.includes("FinOps service is not configured")) {
+        throw new Error("FinOps service is not configured");
+      }
+      if (error.includes("FinOps report not found")) {
+        throw new Error("FinOps report not found");
+      }
+      throw new Error(
+        error || `Failed to fetch FinOps report: ${response.statusText}`
+      );
+    }
+    const data = await response.json();
+    return data;
+  }
+  async parseError(response) {
+    try {
+      const error = await response.json();
+      return error.error || error.message || `${response.status} ${response.statusText}`;
+    } catch {
+      return `${response.status} ${response.statusText}`;
+    }
+  }
+}
+
+export { ObservabilityClient, observabilityApiRef };
+//# sourceMappingURL=ObservabilityApi.esm.js.map