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

Ikhtisar

Dartastic menunjukkan apa yang benar-benar dilakukan aplikasi Dart dan Flutter Anda di tangan pengguna, dan membantu Anda memperbaiki apa yang salah. Halaman ini adalah petanya. Baca sekali, lalu ikuti Memulai langkah demi langkah.

Platformnya

Setiap halaman Bantuan menampilkan gambar yang sama ini, dengan bagian yang dibahasnya disorot, jadi Anda selalu tahu posisi Anda.

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
  1. Anda melakukan build di komputer dan CI Anda. Aplikasi Anda mendapatkan package Dartastic dari Dartastic Pub, sama seperti mendapatkan package dari pub.dev.
  2. Aplikasi Anda berjalan di ponsel dan desktop, di browser, dan sebagai server Dart. Package Dartastic OTel di dalamnya mencatat apa yang terjadi dan mengirimnya ke Observatory.
  3. Saat sesuatu rusak, Symbolizer mengubah crash kembali menjadi file dan baris kode Anda, menggunakan simbol yang Anda publikasikan ke Pub bersama aplikasi Anda.
  4. Saat Anda ingin tahu penyebabnya, Anda bertanya kepada Dartastic AI. AI ini membaca telemetri dan kode sumber Anda di Pub, lalu menjawab dengan penyebab dan perbaikannya.
  5. Control Room adalah tempat Anda menyiapkan semua ini: di sinilah token yang membuka setiap panah dalam diagram dibuat.

Bagian-bagiannya

BagianFungsinyaTempat Anda menemuinya
Control RoomAkun Anda. Di sini Anda membuat token, mengundang rekan tim, memilih paket, dan mengunduh Reference Demo.dartastic.io/control-room, setelah Anda masuk
Dartastic PubRegistry package pribadi yang bekerja seperti pub.dev. Anda mendapatkan package Dartastic darinya, menyimpan package pribadi Anda sendiri di sana, dan memublikasikan kode sumber aplikasi Anda ke sana.dart pub get, dart pub publish
Dartastic OTelPackage yang Anda tambahkan ke aplikasi. Package ini mencatat apa yang terjadi di dalamnya (layar, ketukan, panggilan jaringan, error, crash, performa) sebagai OpenTelemetry dan mengirimnya keluar.pubspec.yaml dan main() Anda
ObservatoryTempat Anda melihat. Sesi dengan replay, trace, log, metrik, crash, dashboard, dan alert untuk semua yang dikirim aplikasi Anda.Dibuka dari Control Room
SymbolizerMengubah stack trace yang tidak terbaca dari build release terobfuskasi kembali menjadi nama file dan nomor baris Anda. Berjalan sendiri saat crash tiba.Tidak ada yang perlu dipanggil: Symbolizer membaca simbol yang Anda publikasikan ke Pub
Dartastic AIMenjawab pertanyaan tentang aplikasi Anda dalam bahasa sehari-hari. AI ini membaca telemetri dan kode sumber Anda di Pub, menemukan penyebabnya, dan mengusulkan perbaikan.Tombol “Ask” di Observatory dan Control Room

Yang Anda lihat

Inilah Observatory. Setiap sesi pengguna Anda tercantum dengan layar, ketukan, error, dan sinyal frustrasinya:

Daftar “Sessions” di Observatory, satu baris per sesi pengguna

Buka salah satunya dan putar ulang. Di bawah playhead, Anda melihat trace, log, dan error pada saat itu, dan Anda dapat langsung melompat ke baris kodenya:

Replay sesi dengan linimasanya, trace di bawah playhead, dan log-nya

Token menghubungkan bagian-bagiannya

Setiap panah dalam diagram membutuhkan jenis token sendiri. Anda membuatnya di Control Room, dan setiap token ditampilkan hanya sekali, jadi salin saat Anda membuatnya. Sebagian besar developer belum pernah memakai token dengan dart pub; halaman Pub memandu Anda.

TokenDariKeKegunaannya
Token PubKomputer AndaDartastic Pubdart pub get dapat mengunduh package Dartastic dan package pribadi Anda; dart pub publish dapat mengunggah.
Pertukaran CICI AndaDartastic PubCI Anda membaca dan memublikasikan package tanpa token yang tersimpan di dalamnya.
Token OTLPAplikasi Anda di ponsel atau desktop, server Dart AndaObservatoryAplikasi Anda boleh mengirim telemetri.
Token Browser OTLPAplikasi Flutter web AndaObservatoryAplikasi web Anda boleh mengirim telemetri, hanya dari situs web yang Anda daftarkan.

Setiap token yang Anda miliki tercantum di satu layar. Tokens menjelaskan setiap jenisnya, serta cara mencabut atau menggantinya.

Tempat semuanya berjalan: paket Anda

  • Cloud berjalan di infrastruktur yang dipakai bersama oleh pelanggan Dartastic. Pub Anda adalah pub.dartastic.io.
  • Dedicated memberi organisasi Anda server sendiri, di subdomain pilihan Anda: Pub Anda adalah pub.<subdomain>.dartastic.io.
  • Self-Hosted menjalankan seluruh platform di dalam jaringan Anda sendiri.

Langkah-langkahnya sama di setiap paket. Jika ada URL yang berbeda, halaman ini menampilkan keduanya. Bandingkan paket.

Yang Anda butuhkan

  • Flutter 3.44 dan Dart 3.12 atau yang lebih baru untuk semua fitur; Flutter 3.22 dan Dart 3.4 untuk semua fitur kecuali metrik Flutter. Versi yang dibutuhkan setiap package.
  • Akun Dartastic: daftar gratis. Mendaftar memulai organisasi Anda di Cloud Free, tanpa kartu.
  • Khusus untuk backend cuaca Reference Demo: Docker.

Cara mempelajarinya

Pilih yang paling cocok untuk Anda; semuanya membahas hal yang sama.

  • Baca halaman-halaman ini secara berurutan. Tombol Sebelumnya dan Berikutnya di bagian bawah setiap halaman memandu Anda.
  • Jalankan Dartastic OTel Reference Demo. Ini adalah versi komersial yang disempurnakan dari Dart OTel Reference Demo yang open source: jauh lebih banyak demo, berupa aplikasi Flutter siap pakai yang menunjukkan cara memakai setiap fitur Dartastic, dengan penyiapan yang sudah selesai. Baca kodenya, salin darinya, atau arahkan asisten coding AI Anda ke sana. Dapatkan Reference Demo.
  • Bertanya: Dukungan menjawab pertanyaan Anda.

Istilah di halaman-halaman ini

OpenTelemetry (OTel)
Standar terbuka untuk mencatat apa yang dilakukan software. Dartastic memakainya dari ujung ke ujung, jadi tidak ada kode Anda yang terkunci ke Dartastic.
OTLP
Format transmisi OpenTelemetry: cara aplikasi Anda mengirim apa yang dicatatnya.
Trace dan span
Span adalah satu unit kerja yang diukur waktunya (sebuah ketukan, panggilan jaringan, kueri database). Trace adalah pohon span untuk satu operasi, bahkan yang melintasi aplikasi dan server Anda.
Log
Sebaris teks yang ditulis aplikasi Anda, terkait dengan trace tempat log itu terjadi.
Metrik
Angka yang diukur dari waktu ke waktu: waktu frame, memori, jumlah permintaan.
Sesi
Satu kunjungan seseorang ke aplikasi Anda, dari dibuka hingga ditinggalkan, beserta setiap layar, ketukan, error, dan trace di dalamnya.
Replay
Menonton ulang sebuah sesi. Anda memilih seberapa banyak yang direkam: linimasa event, wireframe, atau piksel aslinya.
RUM
Real User Monitoring (pemantauan pengguna nyata): telemetri dari orang yang benar-benar memakai aplikasi Anda, bukan dari pengujian.
Obfuskasi dan simbol
Build release dapat mengacak nama-namanya (flutter build --obfuscate). File simbol yang ditulisnya (--split-debug-info) adalah kunci untuk mengembalikannya.
Token
String rahasia panjang yang memungkinkan satu hal berkomunikasi dengan satu hal lain. Setiap jenis token membuka satu jalur dalam diagram di atas.