05 ClickStack

Pendamping fasilitator untuk pelajaran pembelajar 05 ClickStack.

Waktu

Sekitar 15 menit. Telemetri harus terkumpul sebelum lab insiden modul 07, jadi mulai collector sedini mungkin di modul ini dan biarkan tetap berjalan.

Alur pembicaraan

• Managed ClickStack menyimpan telemetri di ClickHouse Cloud; HyperDX adalah UI ter-hosting-nya. Collector lokal hanya meneruskan data. Tunjukkan sebuah trace request end-to-end dan satu record DEBUG ... ClickHouse query ok yang baru di source Log.
• Minta pembelajar menjalankan collector di Langkah 1 sebelum mereka meluncurkan Managed ClickStack di Langkah 2. Ini memberi telemetri waktu untuk tiba dan membuat tampilan pertama UI ter-hosting berguna.
• Tunjukkan satu trace request end-to-end di proyektor.

Kegagalan umum

• Port host OTLP 4317/4318 sudah dipakai: minta mereka menyetel OTEL_GRPC_HOST_PORT / OTEL_HTTP_HOST_PORT di .env.workshop (preflight menyarankan nilainya, misal 24317/24318) dan, dari mana pun di dalam repositori yang sudah di-clone, jalankan cd "$(git rev-parse --show-toplevel)/workshops/build_workshop/app" && ./preflight.sh; back end menjangkau collector di dalam jaringan, jadi pemetaan ulang ini aman.
• Overlay collector belum dijalankan (lupa -f docker-compose.otel.yml yang kedua), sehingga tidak ada apa pun yang tiba di HyperDX.
• OTLP_AUTH_TOKEN tidak cocok, atau CLICKHOUSE_* tidak ada di .env.workshop (collector memakai ulang CLICKHOUSE_HOST/PORT/USER/PASSWORD untuk menjangkau service Cloud).
• Belum ada trafik yang dihasilkan; minta mereka mengklik-klik kedua dashboard.
• Di Docker Desktop, scraper opsional --profile container-logs tidak bisa me-mount path log host (daemon berada di dalam VM); ini memang diharapkan. Log backend tetap mengalir melalui OTLP. Gunakan docker compose ... logs hanya untuk mendiagnosis forwarder jika HyperDX kosong.
• Setelah overlay membuat ulang backend, aplikasi dulu menghasilkan 502 (nginx frontend meng-cache IP backend yang lama). Frontend sekarang meresolusi ulang per request, jadi ia memulihkan diri dalam ~10 detik dan tidak butuh restart manual. Dikonfirmasi sudah diperbaiki pada dry run.
• Referensi dry run: pipeline telemetri terverifikasi end to end — trace nyc-taxi-backend dengan child span clickhouse.query yang membawa db.statement / db.elapsed_ms / db.rows_returned. Dikonfirmasi pada dry run clean-room 2026-07.

Langkah reset

• Restart dengan kedua file compose: docker compose --env-file .env.workshop -f docker-compose.workshop.yml -f docker-compose.otel.yml up -d --build.
• Di console Cloud, buka service-nya, pilih ClickStack, dan luncurkan ulang UI ter-hosting jika sesi SSO sudah kedaluwarsa.