query-examples

PostHog でのデータのクエリ

MCP サーバーから PostHog でデータをクエリする方法について説明がない場合は、ガイドラインをお読みください。

データスキーマ

ドメイン別に整理された、PostHog のコアシステムモデルのスキーマリファレンスです。

• アクティビティログ
• アクション
• アラート
• アノテーション
• バッチエクスポート
• 早期アクセス機能
• コホートと人物
• ダッシュボード、タイル、インサイト
• データウェアハウス
• データモデリングエンドポイント
• エラートラッキング
• フラグと実験
• Hog Flow
• Hog Function
• インテグレーション
• ログ
• ノートブック
• セッション録画プレイリスト
• セッション録画
• サポートチケット
• アンケート
• 使用状況メトリクス
• SQL 変数
• read-data-schema ツールでスキップされたイベント
• 動的な人物プロパティとイベントプロパティ — ツールの結果には表示されない $survey_dismissed/{id}、$feature/{key} のようなパターン

HogQL リファレンス

• 人物プロパティのモード（イベント時点とクエリ時点）。person.properties.* を扱う際に、値が過去のものか現在のものかを理解するためにお読みください。
• スパークライン、SemVer、セッションリプレイ、アクション、翻訳、HTML タグとリンク、テキスト効果など
• SQL 変数。
• HogQL で利用できる関数。重要：一覧は長いため、grep のような bash コマンドを使ってデータを読み取ってください。

分析クエリの例

以下の例を使用して、最適化された分析クエリを作成します。

• トレンド（ユニークユーザー、特定の期間、単一系列）
• トレンド（複数の内訳による合計数）
• ファネル（2ステップ、ユニークユーザー単位で集計、ユーザーの役割で分類、順次、コンバージョン期間14日）
• コンバージョントレンド（ファネル、2ステップ、ユニークグループ単位で集計、コンバージョン期間1日）
• リテンション（ユニークユーザー、次の12週間以内にイベントを実行するために再訪、繰り返し）
• ユーザーパス（ページビュー、3ステップ、パスのクリーニングとフィルターを適用、パス数の上限50）
• ライフサイクル（ページビュー別のユニークユーザー）
• スティッキネス（ユニークユーザーによるページビュー数でカウント、期間中に1件以上のイベントがある場合と定義、累積なし）
• LLM トレース（生成、スパン、埋め込み、人間によるフィードバック、取得した AI メトリクス）
• LLM トレース一覧（プロパティフィルターを使用したトレースの検索と一覧表示、2段階クエリ）
• ウェブパス統計（パス、訪問者、ビュー、直帰率）
• ウェブトラフィックチャネル（ダイレクト、オーガニック検索など）
• デバイス別のウェブビュー
• ウェブ概要
• エラートラッキング（エラー内の値の検索、カスタムプロパティによるフィルタリング）
• ログ（重大度によるフィルタリングと語句の検索）
• セッション（継続時間、ページビュー、直帰率を含むセッションの一覧表示）
• セッションリプレイ（アクティビティフィルターを使用した録画の一覧表示）
• チームのタクソノミー（イベント数の上位項目、ページネーション対応）
• イベントのタクソノミー（イベントのプロパティとサンプル値）
• ユーザープロパティのタクソノミー（ユーザープロパティのサンプル値）