クイックスタート

JSON イベントを Telemetry に送信し、SQL でクエリします。このクイックスタートでは、イベントを 1 件送信し、Telemetry が作成したテーブルを確認してクエリを実行します。

Telemetry が内部でどのように動作するかについて詳しく知りたい場合は、こちらをご覧ください。 Telemetry アーキテクチャ ドキュメント 詳細な概要については、 API 呼び出しを計測することで OpenAI コストを追跡するなど、より詳細な使用例については、ガイドを参照してください。 OpenAI コストの追跡.

タスクごとのパスを短くしたいですか?フォローしてください:

1. 最初の構造化イベントを送信する
2. イベントの取り込みとスキーマの検証
3. 最初のTelemetry SQLクエリを書く
4. 最初のダッシュボードとアラートを作成する
5. 本番環境の計装チェックリスト

API キーを取得する

ホームページの設定プロンプトから anon_… キーを取得します。アカウントなしでイベントを送信し、クエリできます。アカウントがある場合は、チーム設定 → API キーの read-and-write キーを使います。

匿名クエリは最初のイベントから24時間利用できます。7日以内にアカウントを作成すると、イベントと同じキーを保持できます。同じブラウザーでは登録時に試用を検出します。別のブラウザーでは、匿名 API キーをお持ちですか？を選び、キーを貼り付けてデータを探すを押してから登録します。既存ユーザーはデータを保持でキーを復元してからログインできます。イベントのない試用は作成から7日で期限切れになります。

Telemetryをインストールする

このチュートリアルでは JavaScript を使用します。も使用できます Python, Go, Rust, Ruby, PHP、または cURL.

npm install telemetry-sh

いくつかのデータをログに記録する

Telemetry は、データが記録されるときにテーブルを自動的に作成します。次の例では、合成乗車データをテーブルという名前のテーブルに記録します。 uber_rides。 Telemetry はテーブルとそのスキーマを作成します。 city そして price;すべての行も受け取ります timestamp_utc.

import telemetry from "telemetry-sh";

telemetry.init("YOUR_API_KEY");

telemetry.log("uber_rides", {
  city: "paris",
  price: 42
});

UI でデータを探索する

まず、登録せずにイベントをクエリして確認します。

const result = await telemetry.query("SELECT city, price FROM uber_rides LIMIT 10");
console.log(result);

グラフ、ダッシュボード、アラートを使うには、アカウントを作成してデータを保持します。既存のキーは引き続き使え、登録後はイベントのあるワークスペースが開きます。アカウントがある場合は試用を連携します。

探索ビュー

探検する タブでは、SQL を書かずにイベントを絞り込み、グラフや表を作成できます。

探索は 1 つのテーブルを対象にします。開く手順は次のとおりです。

1. Goをあなたのチームに。
2. 開く テーブル.
3. テーブルを選択します。
4. を開きます 探検する その表ページのタブをクリックします。

ルート形状:

/team/{team}/table/{table}?tab=explore

1. グラフの種類を選択します (Samples, Table, Line, Bar、または Stacked Area).
2. 時間範囲を設定し、1 つ以上のフィルターを追加します。
3. 含める列を選択します（次のようなネストされたフィールドも含む: data.toolName).
4. クリック 実行 実行して結果をレンダリングします。

ヒント: コントロールはドラフト状態です。クリックした場合にのみ結果が更新されます 実行.

仮説的なデータセットの例 (架空)

以下の Explore の例では、ログインしたことを前提としています。 総合テスト イベント (実際のユーザーデータはありません) 次のような構造になります。

{
  "timestamp_utc": "2026-02-27T12:00:00.000Z",
  "event": "tool_call",
  "status": "success",
  "data": {
    "toolName": "smart_avantis_buy",
    "args": {
      "symbol": "BTC-USD",
      "amountUsd": 2500
    }
  }
}

これを次のようなテーブルに記録できます。 agent_demo_events そしてそのテーブルをExploreで使用します。

/team/{team}/table/agent_demo_events?tab=explore&graphType=samples&f=event:=:tool_call&f=data.toolName:=:smart_avantis_buy

SELECT "timestamp_utc", "event", "data.toolName", "data.args.symbol"
FROM "your_table"
WHERE timestamp_utc >= now() - INTERVAL '7 days'
ORDER BY timestamp_utc DESC
LIMIT 200

ダッシュボード

ダッシュボードを使用すると、Explore チャート/テーブルとクエリ結果を 1 つの共有ビューに固定できます。

ダッシュボードを作成して使用するには:

1. 任意のテーブルを開く 探検する または、保存されたクエリ結果を開きます。
2. クリック ダッシュボードに追加.
3. 既存のダッシュボードを選択するか、最初に新しいダッシュボードを作成します。
4. ウィジェットにタイトルを付けて確認します。

ダッシュボードのルート形状:

/team/{team}/dashboard/{dashboardSlug}

ダッシュボードを使用して、チームの主要なシグナル (レイテンシー、エラー率、コスト、コンバージョン指標) を 1 か所にまとめます。

アラートの作成

グラフまたはクエリ結果を取得したら、それを Telemetry UI でアラートに変換できます。

1. テーブルを開く 探検する またはクエリを実行します 結果/グラフ 見る。
2. クリック アラートの作成.
3. 条件（集計、最後の N ポイント、比較、しきい値）を設定します。
4. チェック間隔と 1 人以上の電子メール受信者を設定します。
5. クリック アラートの作成 保存するために。にリダイレクトされます /team/{team}/alert/{alertSlug} ステータスと履歴を監視します。

ヒント: 離れる 最後のデータポイントを無視する 最新のバケットは不完全であることが多いため、バケット化された時系列に対して有効になります。

完全なチュートリアルについては、を参照してください。 アラートガイド.

インタラクティブなインライン例

/team/{team}/table/{table}?tab=explore&graphType=line&agg=p95&metric=latency_ms&time=7d

コードベースと統合する

Telemetry を製品または内部ダッシュボードに統合するには、クエリ API を通じて SQL でデータをクエリします。

const results =
  await telemetry.query(`
    SELECT
      city,
      AVG(price)
    FROM
      uber_rides
    GROUP BY
      city
  `);

閲覧する SQL レシピ ライブラリ APIエラー、レイテンシのパーセンタイル、ジョブの再試行、LLMコスト、コンバージョン、リテンション、ハートビート欠落を分析するとき.

これらのレシピの背後にあるアーキテクチャと分析モデルについては、次の手順に進みます。 可観測性とイベント分析のための SQL。 取り込みからSQL結果までの完全な合成ワークフローを実行するには、 エンドツーエンドの SaaS 可観測性デモ.