本文へ移動
統合ガイド

Google ジェミニ API Telemetry

プロンプトや生成されたコンテンツを保存せずに、Gemini リクエストのレイテンシー、モデルの使用状況、トークン、終了理由、エラー、レビューされた製品の結果を追跡します。

レビュー者 Telemetry 製品チーム に . 送信するイベント、除外するデータ、コードの追加方法を確認しました. このページのレビュー担当

役に立つ
  • Gemini トークンとレイテンシーの分析
  • 製品の機能ごとに信頼性をモデル化する
  • 受け入れられた成果物とコストのレビュー
実装の証拠

Google Gemini API telemetry でイベントを送信して確認する

制御されたアプリケーション境界で Google Gemini API telemetry を使用し、イベント コントラクトを小さく保ち、集約ビューを構築する前に既知の結果を検証します。

  1. 1

    結果を選択してください

    Gemini トークンとレイテンシーの分析

  2. 2

    契約を定義する

    プロバイダー、モデル、機能、ステータス、および finish_reason

  3. 3

    結果で発行する

    プロバイダー応答メタデータからトークン数を読み取り、リクエストに使用されたモデル識別子を保存します。

  4. 4

    証拠を検証する

    Exercise a known fixture, then inspect llm_request_completed for one correctly typed terminal row.

始める前に

始める前に

  • サーバー側の GEMINI_API_KEY および TELEMETRY_API_KEY
  • fetch と AbortSignal.timeout を備えたサーバー実行環境
  • プロンプト外での安定した機能名とバージョン管理されたコスト計算
  • ワークフローが公開したときの承認、保存、完了などの製品の結果

配信設定

サーバー側のインストールと初期化

このサーバー側の例では、サーバー側のキーと時間制限付き fetch リクエストで Log API にイベントを送信します。Telemetry SDK の初期化は不要です。 ブラウザ バンドル、クライアントに表示される環境変数、ソース管理、ログ、および例外メッセージに取り込み資格情報が含まれないようにします。

google-gemini-インストール

npmのインストール

bash
npm install @google/genai
  1. 1制限されたネットワーク動作を持つ再利用可能なサーバー側配信クライアントを 1 つ準備します。
  2. 2成功、失敗、再試行、またはタイムアウトの境界に結果イベントを追加します。
  3. 3アラートを有効にする前に、制御されたフィクスチャを送信し、保存されている行を検査します。

スニペット

1 つの構造化されたイベントから始める

ワークフローが完了、失敗、または再試行される場所にこの図形を追加します。次に、実際のフィールドからダッシュボードを構築します。

google-gemini

Google Gemini API telemetryイベント

javascript
import { GoogleGenAI } from "@google/genai";

async function emitModelOutcome(data) {
  try {
    const delivery = await fetch("https://api.telemetry.sh/log", {
      method: "POST",
      headers: {
        Authorization: process.env.TELEMETRY_API_KEY,
        "Content-Type": "application/json",
      },
      body: JSON.stringify({ table: "llm_request_completed", data }),
      signal: AbortSignal.timeout(1000),
    });
    if (!delivery.ok) throw new Error("telemetry_delivery_unconfirmed");
  } catch {
    try { console.warn("Telemetry delivery unconfirmed"); } catch {}
  }
}

const gemini = new GoogleGenAI({ apiKey: process.env.GEMINI_API_KEY });
const startedAt = performance.now();

try {
  const response = await gemini.models.generateContent({
    model: process.env.GEMINI_MODEL,
    contents: userInput,
  });
  const usage = response.usageMetadata;

  await emitModelOutcome({
    provider: "google",
    model: process.env.GEMINI_MODEL,
    feature: "support_draft",
    status: "success",
    latency_ms: Math.round(performance.now() - startedAt),
    input_tokens: usage?.promptTokenCount,
    output_tokens: usage?.candidatesTokenCount,
    total_tokens: usage?.totalTokenCount,
    prompt_version: "support-v4",
  });

  return response;
} catch (error) {
  await emitModelOutcome({
    provider: "google",
    model: process.env.GEMINI_MODEL,
    feature: "support_draft",
    status: "failed",
    latency_ms: Math.round(performance.now() - startedAt),
    error_type: "provider_request_failed",
  });
  throw error;
}

イベントスキーマ

プロバイダー、モデル、機能、ステータス、および finish_reason

input_tokens、output_tokens、total_tokens、latency_ms、および estimated_cost_usd

request_id、prompt_version、error_type、およびレビューされた結果

設定を確認する

チェックポイント 1

プロバイダー応答メタデータからトークン数を読み取り、リクエストに使用されたモデル識別子を保存します。

チェックポイント 2

プロバイダーの価格設定とトークン クラスは変更される可能性があるため、バージョン化された価格表からコストを計算します。

チェックポイント 3

プロンプト テキスト、アップロードされたコンテンツ、生成された出力、API キー、またはプロバイダー エラー本体を一般テレメトリに送信しないでください。

チェックポイント 4

許可したモデルのメタデータのみを Log API で送信し、1 秒の協調的タイムアウトを設定します。送信失敗でモデル提供元の結果を変えないでください。

チェックポイント 5

このインラインの例は送信の待ち時間を追加する場合があり、永続的な配信は保証しません。本番環境ではアプリが管理する容量制限付きキューまたは outbox を使用してください。

検証

イベントが到着したことを証明する

既知の成功例と失敗例を実行した後、これを実行します。最終的なイベント コントラクトがスニペットと異なる場合は、フォールバック テーブル名を置き換えます。

google-gemini-検証

Google Gemini API telemetry 検証クエリ

sql
SELECT *
FROM llm_request_completed
ORDER BY timestamp_utc DESC
LIMIT 20;
論理結果ごとに 1 つのターミナル行を、予想されるステータス、識別子、単位、および UTC 時刻とともに確認します。
推論されたスキーマを検査し、再試行によってフィールド タイプが変更されたり、新しい論理イベント ID が生成されたりしないことを確認します。
保存されたフィールドで認証情報、生のペイロード、プロンプト、プライベート コンテンツ、および無制限のエラー メッセージを検索します。
ダッシュボードを完了として扱う前に、プロバイダーのタイムアウト、取り込みの拒否、およびプロセスのシャットダウンを実行します。

実装の参考資料

新しい運用パスを有効にする前に、イベント契約、データ安全性に関するガイダンス、上流の主要ドキュメントを確認してください。

イベントを記録する場所

結果イベントを小さく、回復可能なものに保つ

このパターンが提供するのは、

  • 上流のワークフローの横にある、制限付きの SQL 対応の結果。
  • ダッシュボード、アラート、およびイベント間の相関関係の安定したフィールド。
  • 成功、失敗、再試行、タイムアウトの動作を検証するためのフィクスチャ駆動のパス。

このパターンでは提供されません

  • OTLP エクスポーター、自動収集パイプライン、または詳細なトレースと診断ログの代替。
  • ペイロードにイベント ID が含まれているという理由だけで、1 回だけ配信されます。
  • 生のプロバイダー ペイロード、ユーザー コンテンツ、資格情報、または規制されたデータを収集する許可。

イベントスキーマの例

クエリまたはスニペットを運用環境に適用する前に、行粒度、出力境界、必要なタイプ、プライバシー クラス、サンプル ペイロード、および検証チェックリストを確認してください。

関連製品の機能

このワークフローを続行します AIエージェントの監視

レビュー可能な SQL を使用して、エージェントの実行、ツールの使用、モデルのコスト、品質、製品の結果を結び付けます。

関連する SQL レシピ

その他のSQL例

このワークフローの構造化フィールドに対してクエリを実行し、結果の例を検査して、有用な回答をダッシュボードまたはアラートに変換します。

すべてのレシピを参照する
クエリ例のコレクションAIとLLM SQL

実装ファミリーごとに参照する

関連する統合パターンを比較する

この統合と組み合わせるテンプレート

さらなる統合