sdk

@flarelog/sdk

あらゆる JavaScript ランタイムで使える、依存関係ゼロのオブザーバビリティです。

Cloudflare Workers、Vercel、Node.js、ブラウザーから、ログ、エラー、W3C 伝搬トレースを FlareLog または任意の OTLP バックエンドに送信します。1 つの SDK で、あらゆるプラットフォームに対応します。

---

ドキュメント

docs.flarelog.dev

インストールガイド、API リファレンス、フレームワーク連携、プラットフォーム固有のセットアップを含む、充実したドキュメントです。

---

クイックスタート

npm install @flarelog/sdk

import { flarelog } from "@flarelog/sdk";

const logger = flarelog({});
logger.info("Hello!");  // → console (zero config)

ダッシュボードに送信するには、API キーを追加します。

FLARELOG_API_KEY=fl_your_key

---

AI 推論のオブザーバビリティ

OpenAI、Anthropic、Cloudflare Workers AI、 Vercel AI SDK、および OpenAI 互換ゲートウェイに対応した、設定不要の計装機能です。トークン数、レイテンシ、 米ドル建てのコスト、ツール呼び出し、エラーを取得し、 AI オブザーバビリティダッシュボードで確認できます。

import { flarelog } from "@flarelog/sdk";

const logger = flarelog({
  apiKey: process.env.FLARELOG_API_KEY,
  ai: true, // one flag — every fetch() to OpenAI/Anthropic/etc. is captured
});

細かく制御する必要がありますか？代わりに設定オブジェクトを渡してください。

const logger = flarelog({
  apiKey: process.env.FLARELOG_API_KEY,
  ai: {
    captureSamples: true,
    priceOverrides: { "gpt-4o": { input: 2.5, output: 10 } },
  },
});

flarelogAI を直接使用することもできます（メインパッケージから再エクスポートされています）。

import { flarelog, flarelogAI } from "@flarelog/sdk";

const logger = flarelog({ apiKey: process.env.FLARELOG_API_KEY });
const handle = flarelogAI(logger);
// handle.dispose() to remove instrumentation later

ストリーミング OpenAI 呼び出しでトークンを取得するには、使用状況のレポートを有効にしてください（Anthropic と Workers AI は使用状況を自動的に取得します）。

await fetch("https://api.openai.com/v1/chat/completions", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.OPENAI_API_KEY}` },
  body: JSON.stringify({
    model: "gpt-4o",
    stream: true,
    stream_options: { include_usage: true }, // ← required for streaming token capture
    messages: [{ role: "user", content: "Hello" }],
  }),
});

詳細については、AI オブザーバビリティガイドをご覧ください。

---

特長

• 依存関係ゼロ — 監査対象も、競合するものもありません
• あらゆる JavaScript ランタイムに対応 — Cloudflare Workers、Vercel、Node.js、ブラウザー
• W3C トレース伝搬 — サービス間の分散トレーシング
• 自動検出 — 環境、リリース、プラットフォーム
• OTLP 互換 — Grafana、Honeycomb、Datadog、または任意の OTLP バックエンドに送信
• AI 推論のオブザーバビリティ — OpenAI、Anthropic、Workers AI、Vercel AI SDK、および OpenAI 互換ゲートウェイのトークン数、コスト、レイテンシを設定不要で追跡

---

ライセンス

MIT