受講者トラック
リアルタイムで、観測可能で、AI 支援付きの分析アプリを ClickHouse Cloud 上に一気に構築します。タイピングの大半はコーディングエージェントが担います。
これから数時間で、動いている NYC タクシーアプリのデータプレーンを ClickHouse Cloud 上に 作り直します。実データの履歴分析、ライブな変更データキャプチャ ストリーム、対話型 BI、 AI が構築した SRE ダッシュボード、そしてエンドツーエンドでトレースされるアプリ内 AI チャットです。 モジュールは順番に進めてください。以下の番号付きリストは進捗トラッカーも兼ねています。
このワークショップは macOS と Windows に対応しています。ページヘッダーで自分のマシンを 選んでください。選択内容は受講者ページと講師ページのすべてで保持されます。Windows の受講者は WSL 2 上の Ubuntu を使うので、セットアップ後は共通のコマンドブロックがすべて同一になります。
進捗
- セットアップ - アカウント、キー、ツール、エージェントスキル、そしてローカルで動くアプリ。
- ClickHouse Cloud - スキーマを構築し、オブジェクトストレージから320万件超の実際のタクシー行を投入します。
- ベースアプリ - ClickHouse にデータが入った状態で動くアプリを一巡し、これから何を拡張するのか把握します。
- マネージド Postgres CDC - ClickPipe で ClickHouse マネージド Postgres を ClickHouse にストリーミングします。
- ClickHouse Agents - 自分のデータに普通の言葉で質問します。
- ClickStack - アプリ自身のトレースとログを HyperDX で確認します。
- AI SRE - そのテレメトリをもとに、エージェントに SRE ダッシュボードとアラートを作らせます。
- 故障と修復 - AI SRE の続きとして、障害を注入し、診断して、修復します。
- チャットと Langfuse - アプリ内 AI チャットを接続し、すべてのやり取りをトレースします。
- まとめ - 振り返り、持ち帰り、自分のデータへ広げます。
作るもの
修了時には、状態を持つデータサービスとオブザーバビリティ サービスがクラウドで動いています。 アプリ、負荷生成器、クライアントツール、テレメトリ フォワーダーはローカルで動きます。
- オブジェクトストレージから直接投入した 320万件超の実際の NYC タクシー行 に対する ライブ運用ダッシュボード
- ClickHouse マネージド Postgres を ClickHouse へ継続的にストリーミングする 変更データキャプチャ パイプライン
- ClickHouse Agents によるそのデータへの 対話型 BI
- アプリ自身のテレメトリに対する AI が構築した SRE ダッシュボードとアラート
- Langfuse でエンドツーエンドにトレースされる アプリ内 AI チャット
所要時間
ハンズオンで約2時間30分 — 最初の40分以内には実データ上でダッシュボードが動き出します。
費用
ClickHouse マネージドのサービスは ClickHouse Cloud のトライアルクレジットでカバーされます。 モジュール 08 用に OpenAI クレジットを約 $5 見込んでおいてください。
すべてコピー＆ペーストで進められます
これらのページに載っているコマンドとクエリはすべてそのままコピーして実行できます。重い作業は コーディングエージェントがやってくれるので、あなたは自分で打ち込むのではなく構築を指揮する側です。
各レッスンの構成
すべてのモジュールページは同じ形になっているので、常に自分の位置が分かります。
- 開始時点 - チェックアウトするチェックポイント ブランチと、揃っている必要があるもの。
- なぜ - この手順が、いま作っているアプリにとってなぜ重要なのか。
- ゴール - そのモジュールで達成する1つの具体的な成果。
- 手順 - 番号付きで、それぞれ動詞から始まり、触るファイルと期待される出力のチェックポイントを示します。
- 完了したかどうかの確認方法 - 自分で実行できるチェック。
- まとめ - いま何が起きたのか。
- 終了状態 - 次のモジュールへの引き継ぎ。
周りのペースに合わせようとしなくて大丈夫です。すべてのモジュールには、まっさらな状態から 始められるチェックポイント ブランチが示されているので、取り残されることはありません。
自分ひとりで進める場合
講師なしで進めますか？ まず このワークショップを自習で進める を読んでください。講師が本来提供するものが、この教材に組み込まれたセルフサービスの代替手段に どう対応するのかを示しています。何かがうまく動かない場合は、 トラブルシューティング に、テストで確認された すべてのセットアップ失敗とその修正方法が載っています。
00 セットアップ から始めてください。