@frontal-labs/observability

Observability SDK for logs, metrics, traces, alerts, and dashboards.

Installation

bun add @frontal-labs/observability @frontal-labs/core

Usage

import { FrontalClient } from "@frontal-labs/core";
import { createObservabilityClient } from "@frontal-labs/observability";

const client = new FrontalClient({
  apiKey: process.env.FRONTAL_API_KEY!,
  baseUrl: process.env.FRONTAL_API_URL ?? "https://api.frontal.dev/v1",
});

const obs = createObservabilityClient(client);

const logs = await obs.logs.query({
  query: "level:error",
  time_from: "2025-01-01T00:00:00Z",
  time_to: "2025-01-02T00:00:00Z",
});

const metrics = await obs.metrics.query("cpu_usage", {
  from: "2025-01-01T00:00:00Z",
  to: "2025-01-02T00:00:00Z",
  granularity: "1m",
});

Configuration

• FRONTAL_API_KEY — Your Frontal API key
• FRONTAL_OBSERVABILITY_API_URL — Custom observability API base URL