Halaman ini menampilkan URL Cloud. Masuk di Dedicated, lalu halaman ini menampilkan URL server Anda.

Dartastic OTel Reference Demo

Aplikasi Flutter siap pakai yang menunjukkan setiap fitur Dartastic, dengan penyiapan yang sudah selesai. Jalankan untuk melihat Dartastic bekerja dari ujung ke ujung, lalu baca kodenya dan salin darinya.

Ini adalah versi komersial yang disempurnakan dari Dart OTel Reference Demo yang open source, dengan jauh lebih banyak demo. Setiap aplikasi mengambil package-nya dari Dartastic Pub Anda dan mengirim telemetri ke Observatory Anda, jadi begitu demo berjalan, akun Anda terbukti berfungsi.

BUILDARSITEKTUR DARTASTICPENGGUNAtokentikettoken Pubpushpertukaran CIaplikasi sampai ke pengguna: toko aplikasi, web, serversimbolcrashstack tracekode sumbertelemetriKomputer developerflutter run · dart pub getCIGitHub Actions, GitLab, …Control Roombuat token · kontrol akses berbasis peranControl Planeorganisasi · peran · tokenDartastic Pubpackage · kode sumberObservatorysesi · trace · logSymbolizercrash → baris kode sumberDartastic AIjawaban dari keduanyaIssue trackerGitHub · Jira · LinearAplikasi seluler + desktopponsel · tablet · desktopmengirim dengan token OTLPAplikasi webdi browsermengirim dengan token Browser OTLPServer Dartbackend · layananmengirim dengan token OTLP

Unduh demo

Masuk ke Control Room dan tekan Reference Demo di bagian atas setiap layar, di sebelah “Help”:

Header Control Room dengan tombol “Reference Demo”, di sebelah “Help” dan “Sign Out”

Yang terunduh adalah dartastic-otel-reference-demo-<version>.tar.gz. Ekstrak di tempat Anda menyimpan kode:

shell
tar -xzf dartastic-otel-reference-demo-*.tar.gz
cd dartastic-otel-reference-demo-*

README.md di folder teratasnya adalah panduan lengkap. Langkah-langkah di bawah ini membawa Anda ke run pertama.

Di Dedicated: arahkan ke server Anda

Demo awalnya diarahkan ke Dartastic Cloud, jadi di Cloud tidak ada yang perlu dilakukan di sini. Di Dedicated, jalankan perintah ini sekali dengan subdomain Anda:

shell
tool/set-hosted-slug.sh <subdomain>

Perintah ini menulis subdomain Anda ke .env (yang diabaikan git) dan memperbarui file pubspec. Jalankan lagi dengan subdomain lain untuk beralih, atau dengan "" untuk kembali ke Cloud.

Token yang dibutuhkan

Buat masing-masing di layar Tokens Control Room. Setiap token hanya ditampilkan sekali, jadi salin saat Anda membuatnya.

TokenDibutuhkan untuk
Token Pub
dart pub token add (sekali)
Setiap demo: flutter pub get mengambil package dari Dartastic Pub Anda.
Token OTLP
OTEL_EXPORTER_OTLP_HEADERS
Setiap demo: aplikasi mengirim telemetrinya ke Observatory Anda.
Token Symbolizer
DARTASTIC_SYMBOLIZER_TOKEN
Hanya symbolizer_demo_flutter.

Token Pub baca saja sudah cukup untuk setiap demo kecuali symbolizer_demo_flutter dan crash_demo_flutter, yang memublikasikan ke Pub Anda dan membutuhkan token baca dan tulis. Memulai memandu Anda menambahkan token Pub dan mengekspor token lainnya.

Ekspor token di shell Anda alih-alih menuliskannya ke .env: .env yang dibagikan atau dimasukkan ke repositori adalah cara umum rahasia bocor.

Jalankan demo

Demo ini adalah satu workspace Flutter, jadi ambil package semua aplikasi sekaligus dari folder teratasnya:

shell
flutter pub get

Jika berhasil, Dartastic Pub dan token Pub Anda berfungsi. Lalu jalankan sebuah aplikasi; tool/launch.sh menanyakan perangkat mana yang dipakai:

shell
tool/launch.sh --list          # every demo app
tool/launch.sh                 # weather_flutter
tool/launch.sh rum_demo_flutter
  • Docker hanya dibutuhkan untuk weather_flutter dan all_demos_flutter: keduanya menjalankan API cuaca di komputer Anda untuk menunjukkan satu trace yang melintasi aplikasi dan server.
  • Demo berjalan di Android, iOS, macOS, Windows, dan Linux, di perangkat fisik maupun simulator. Demo tidak berjalan di web.

Isinya

AplikasiYang ditunjukkan
weather_flutterSatu ketukan dengan trace dari ujung ke ujung: aplikasi, API cuaca, cache-nya, dan layanan cuaca eksternal, dalam satu trace.
all_demos_flutterHampir setiap demo sebagai tab dalam satu aplikasi.
rum_demo_flutterSesi, tampilan layar, ketukan, dan sinyal frustrasi, dengan replay sesi.
crash_demo_flutterCrash yang dicatat dan dikirim bahkan saat aplikasi mati.
symbolizer_demo_flutterBuild release terobfuskasi yang stack trace-nya kembali menjadi file dan baris kode Anda, serta jank yang ditelusuri sampai ke widget-nya.
anr_demo_flutterDeteksi aplikasi tidak merespons (ANR).
pii_demo_flutterMenjaga data pribadi agar tidak masuk ke telemetri Anda.
webview_demo_flutterTelemetri dari halaman web di dalam aplikasi Anda, digabungkan ke trace aplikasi.
Metrik vital platformKesehatan release, Android Vitals, MetricKit iOS, startup aplikasi, status perangkat, status termal, jaringan yang tidak stabil, pengalaman pengguna, dan metrik vital server Linux, masing-masing satu aplikasi.

Setiap aplikasi menautkan ke data yang dikirimnya di Observatory Anda. Untuk mempelajari sebuah fitur, jalankan aplikasinya, lalu baca kodenya: itulah contoh terkecil yang berfungsi untuk fitur tersebut. Arahkan juga asisten coding AI Anda ke kode itu.

Yang Anda lihat di Observatory

Layar dari satu kali menjalankan demo. Run Anda sendiri menghasilkan angka sendiri; apa yang ditunjukkan setiap layar tetap sama.

Waktu build frame

all_demos_flutter di layar “Metric” untuk flutter.frame.build, sebagai heatmap: empat menit frame, dengan garis p95 yang naik sepanjang run.
all_demos_flutter di layar “Metric” untuk flutter.frame.build, sebagai heatmap: empat menit frame, dengan garis p95 yang naik sepanjang run.

Kesehatan release

“Traces” difilter ke span flutter.session dari demo kesehatan release, satu per sesi. Yang berwarna merah adalah sesi yang mengalami crash.
“Traces” difilter ke span flutter.session dari demo kesehatan release, satu per sesi. Yang berwarna merah adalah sesi yang mengalami crash.

Startup aplikasi

Layar “Metric” untuk flutter.app.startup.duration, sebagai heatmap: tiga cold start sekitar 2,2 s dan dua hot start 33 dan 63 ms.
Layar “Metric” untuk flutter.app.startup.duration, sebagai heatmap: tiga cold start sekitar 2,2 s dan dua hot start 33 dan 63 ms.

Jaringan yang tidak stabil

“Traces” difilter ke dartastic.network.flaky = true: dua permintaan yang tidak stabil, satu memakan waktu 6,56 s dan satu lagi 114 ms yang berakhir dengan error.
“Traces” difilter ke dartastic.network.flaky = true: dua permintaan yang tidak stabil, satu memakan waktu 6,56 s dan satu lagi 114 ms yang berakhir dengan error.

Interaction to Next Paint

Layar “Metric” untuk flutter.experience.inp, sebagai heatmap: delapan interaksi, dua di bawah 16 ms dan enam pada 200 hingga 250 ms.
Layar “Metric” untuk flutter.experience.inp, sebagai heatmap: delapan interaksi, dua di bawah 16 ms dan enam pada 200 hingga 250 ms.

First Contentful Paint

Layar “Metric” untuk flutter.experience.fcp: satu first contentful paint, pada 2,67 s.
Layar “Metric” untuk flutter.experience.fcp: satu first contentful paint, pada 2,67 s.

Aplikasi tidak merespons, sebagai event

“Logs” difilter ke event dartastic.app.anr dari anr_demo_flutter: tiga ANR, dihitung di bawah “Unspecified” karena event tidak membawa tingkat keparahan, dan setiap baris menampilkan nama event-nya.
“Logs” difilter ke event dartastic.app.anr dari anr_demo_flutter: tiga ANR, dihitung di bawah “Unspecified” karena event tidak membawa tingkat keparahan, dan setiap baris menampilkan nama event-nya.

Aplikasi tidak merespons, berapa lama

Tiga ANR yang sama di layar “Metric” untuk flutter.anr.duration: masing-masing 6,0 hingga 6,6 s, pada saat diekspor.
Tiga ANR yang sama di layar “Metric” untuk flutter.anr.duration: masing-masing 6,0 hingga 6,6 s, pada saat diekspor.

Keluarnya aplikasi di MetricKit iOS

Layar “Metric” untuk dartastic.app.exit.count, sebagai batang: 50 kali keluar dalam satu langkah lima menit, 43 normal, 3 kehabisan memori, 3 watchdog, dan 1 timeout.
Layar “Metric” untuk dartastic.app.exit.count, sebagai batang: 50 kali keluar dalam satu langkah lima menit, 43 normal, 3 kehabisan memori, 3 watchdog, dan 1 timeout.