| name | data-telemetry-expert |
| description | Expert guide for observability, analytics, telemetry, and data pipelines (OpenTelemetry, PostHog, Mixpanel) / Panduan ahli untuk observabilitas, telemetri, dan analitik. |
| author | Roedy Rustam |
Data & Telemetry Expert
English | Bahasa Indonesia
English
Description
This skill covers the setup and architecture of product analytics, system telemetry (tracing, metrics, logs), and data pipelines. It ensures that SaaS products are fully observable and that user behavior can be analyzed to drive product decisions.
Trigger Conditions
- Integrating product analytics (PostHog, Mixpanel, Amplitude).
- Setting up system observability (Datadog, New Relic, OpenTelemetry).
- Designing event tracking schemas and taxonomy.
- Building data pipelines or deploying analytical databases (ClickHouse).
Core Architecture Guidelines
1. Observability (Backend)
If you can't measure it, you can't fix it.
- Use OpenTelemetry (OTel) to instrument your backend services. It is vendor-agnostic.
- Collect the Three Pillars of Observability:
- Traces: Track the lifecycle of a request across microservices/functions.
- Metrics: Track aggregates (e.g., HTTP 500 errors/min, memory usage).
- Logs: Track discrete events with rich contextual metadata.
2. Product Analytics (Frontend/Backend)
Track what users are doing to understand product usage.
- Use a platform like PostHog (which offers Analytics, Feature Flags, and Session Replay in one tool).
- Taxonomy Rule: Use a consistent
Noun Action format for event names (e.g., Workspace Created, Subscription Upgraded).
- Backend vs Frontend Tracking:
- Track high-volume UI interactions (clicks, pageviews) on the Frontend.
- Track critical business events (payments, signups) on the Backend to ensure they are never blocked by ad-blockers.
3. Session Replay
Enable Session Replay (via PostHog or LogRocket) for debugging frontend issues. It records the DOM mutations so developers can literally watch what the user did right before an error occurred. Crucial: Ensure sensitive fields (passwords, credit cards) are masked before recording!
Bahasa Indonesia
Deskripsi
Skill ini mencakup penyiapan dan arsitektur analitik produk, telemetri sistem (tracing, metrik, log), dan data pipelines. Tujuannya adalah untuk memastikan bahwa produk SaaS dapat diobservasi secara menyeluruh dan perilaku pengguna dapat dianalisis untuk pengambilan keputusan produk.
Kondisi Pemicu
- Mengintegrasikan analitik produk (PostHog, Mixpanel, Amplitude).
- Mengatur observabilitas sistem (Datadog, New Relic, OpenTelemetry).
- Merancang skema pelacakan event dan taksonominya.
- Membangun data pipeline atau menggunakan database analitik (ClickHouse).
Panduan Arsitektur Inti
1. Observabilitas (Backend)
Jika Anda tidak bisa mengukurnya, Anda tidak bisa memperbaikinya.
- Gunakan standar OpenTelemetry (OTel) untuk menginstrumentasi layanan backend Anda, karena ini bebas vendor-lock-in.
- Kumpulkan Tiga Pilar Observabilitas:
- Traces: Melacak siklus hidup sebuah request saat melewati berbagai layanan mikro/fungsi.
- Metrics: Melacak data agregat (mis. jumlah error HTTP 500/menit, penggunaan memori).
- Logs: Melacak event tunggal yang dilengkapi metadata kontekstual.
2. Analitik Produk (Frontend/Backend)
Lacak apa yang dilakukan pengguna untuk memahami nilai produk.
- Gunakan platform seperti PostHog (menyediakan Analytics, Feature Flags, dan Session Replay sekaligus).
- Aturan Taksonomi: Gunakan format
KataBenda KataKerja secara konsisten untuk nama event (misal: Workspace Created, Subscription Upgraded).
- Pelacakan Backend vs Frontend:
- Lacak interaksi UI yang ringan (klik, pageviews) di sisi Frontend.
- Lacak peristiwa bisnis kritis (pembayaran, pendaftaran) di sisi Backend untuk memastikan pelacakan tidak diblokir oleh ekstensi Ad-Blocker.
3. Session Replay (Rekaman Sesi)
Aktifkan Session Replay (via PostHog atau LogRocket) untuk debugging isu frontend. Alat ini merekam mutasi DOM sehingga developer benar-benar bisa memutar ulang apa yang dilakukan pengguna sebelum terjadi error. Sangat Penting: Pastikan kolom input sensitif (kata sandi, kartu kredit) disamarkan (masked) sebelum terekam!
