Dari proses masuk pertama Anda hingga jawaban tentang aplikasi Anda di produksi.
Halaman ini menampilkan URL Cloud. Masuk di Dedicated, lalu halaman ini menampilkan URL server Anda.
Memulai
Dari perkenalan pertama dengan OpenTelemetry hingga trace Anda sendiri di Observatory. Setiap langkah melanjutkan langkah sebelumnya, jadi ikuti secara berurutan.
Tentang OpenTelemetry
Mulai dengan OpenTelemetry
Dartastic dibangun di atas OpenTelemetry (OTel), standar terbuka untuk mencatat apa yang dilakukan software. Dartastic mengikuti spesifikasi OpenTelemetry dengan cermat: nama, data, dan cara pengirimannya mengikuti standar. Apa yang Anda pelajari tentang OpenTelemetry berlaku untuk Dartastic, dan apa yang Anda bangun dengan Dartastic tetap OpenTelemetry standar.
Spesifikasinya mudah dipahami. Sebelum melangkah lebih jauh, luangkan satu jam dengan dokumentasi OpenTelemetry untuk pemahaman dasar:
Apa yang terjadi, langkah demi langkah, dan berapa lama setiap langkah berlangsung. Trace adalah pohon span: sebuah ketukan, panggilan jaringan yang dibuatnya, pekerjaan server di balik panggilan itu, dan kueri database di bawahnya. Satu trace dapat melintas dari aplikasi ke server Anda.
Angka yang diukur dari waktu ke waktu: waktu frame, memori, permintaan per menit, error per release. Murah untuk disimpan, jadi metrik menunjukkan tren dan memicu alert.
Baris teks dengan waktu dan tingkat keparahan. Di OpenTelemetry, log membawa trace tempat log itu ditulis, jadi dari sebuah log Anda dapat membuka semua hal lain yang terjadi pada saat itu.
Ketiganya membawa resource: aplikasi mana yang mengirimnya, versi berapa, dan di perangkat apa. Dartastic menambahkan pemantauan pengguna nyata di atasnya (sesi, layar, ketukan, dan replay), yang juga dicatat sebagai sinyal standar. Ikhtisar menjelaskan istilah lain yang dipakai halaman-halaman ini.
1. Masuk
Masuk ke dartastic.io. Saat pertama kali, Anda menyiapkan organisasi Anda: akun tempat token, rekan tim, dan paket Anda berada. Jika rekan tim mengundang Anda, masuklah dengan alamat email yang diundang, dan Anda bergabung ke organisasi mereka.
Mendaftar memulai organisasi Anda di Cloud Free, tanpa kartu. Anda diminta mengisi:
Nama organisasi dan subdomain: nama organisasi, dan subdomain tujuan aplikasi Anda mengirim telemetri. Subdomain itu milik Anda selamanya.
Wilayah: tempat telemetri Anda disimpan. Tidak dapat diubah nanti.
Batas RUM: tingkat replay tertinggi yang boleh direkam engine Anda. Cloud Free sampai Wireframe; Shadow dan Pixel tersedia di paket berbayar. Engine Anda ditempa dengan pilihan Anda, dan tidak ada apa pun di perangkat yang dapat melampauinya.
Dartastic AI: berjalan dengan kunci model Anda sendiri, yang dapat Anda tambahkan saat itu atau nanti.
Untuk Dartastic Pub saja, pilih paket Pub di Harga sebelum mendaftar. Anda memberi nama organisasi dan memilih wilayahnya, dan tidak ada lagi yang diminta.
Tekan Reference Demo di bagian atas Control Room, lalu ekstrak arsipnya. Anda menjalankannya di langkah 5: ini cara tercepat melihat Dartastic bekerja, dan kodenya menunjukkan cara memakai setiap fitur. Selengkapnya tentang Reference Demo.
3. Hubungkan dart pub ke Dartastic Pub Anda
Package Dartastic berasal dari Dartastic Pub Anda, bukan pub.dev, dan dart pub membutuhkan token untuk membacanya. Sebagian besar developer belum pernah melakukan ini; hanya butuh satu menit, sekali per komputer.
Dartastic Pub juga meneruskan permintaan ke pub.dev. Definisikan package Anda di pubspec.yaml seperti biasa, dan package dari pub.dev otomatis diambil dari pub.dev, berdampingan dengan package Dartastic dan package pribadi Anda.
Buat token Pub: tekan + Pub. Jendela berikut terbuka:
Name: nama apa saja yang membedakan token Anda; kami menyarankan pub-org-read-write.
Organization: organisasi yang package-nya dibaca dan dipublikasikan oleh token ini.
Allow write (publish) access: centang untuk memublikasikan ke Dartastic Pub Anda dengan token ini. Tanpanya, token hanya dapat membaca, dan itu sudah cukup untuk seluruh Reference Demo kecuali symbolizer_demo_flutter dan crash_demo_flutter, yang memublikasikan ke Pub Anda.
Klik Generate. Token Anda ditampilkan sekali: Salin token dengan tombol salinnya sekarang: setelah jendela ini ditutup, token tidak dapat ditampilkan lagi. Granted scopes: Pub berarti token ini hanya untuk Pub: token ini tidak dapat mengirim telemetri atau memanggil layanan lain.
Di terminal, berikan token ke dart pub:
shell
dart pub token add https://pub.dartastic.io
Saat muncul prompt Enter secret token:, tempel token dan tekan Enter. Prompt tidak menampilkan apa pun saat Anda menempel; itu memang wajar. Jawabannya:
terminal
Enter secret token:
Requests to "https://pub.dartastic.io" will now be authenticated using the secret token.
Di folder Reference Demo, ambil package-nya:
shell
flutter pub get
Jika berhasil, Pub dan token Anda berfungsi.
dart pub menyimpan token untuk host tersebut dan hanya mengirimnya ke sana. Pub membahas cara menampilkan, mengganti, dan menghapus token, serta memublikasikan package.
Package yang dapat dijangkau token Pub
Token Pub menjangkau package yang boleh dipakai pemiliknya, tidak lebih.
Admin organisasi memiliki akses ke setiap package di organisasi, begitu pula token mereka.
Rekan tim lainnya hanya dapat membuat token untuk package yang telah diberikan kepada mereka. Admin memberikan package kepada rekan tim.
Lihat Undang rekan tim untuk peran, dan Pub untuk memberikan package kepada anggota organisasi.
4. Izinkan aplikasi Anda mengirim telemetri
Di Tokens, buat token OTLP, lalu ekspor di shell Anda dalam bentuk standar OpenTelemetry. Tulis authorization dengan huruf kecil:
Pastikan Docker berjalan, lalu jalankan demo cuaca dari folder Reference Demo dan pilih perangkat:
shell
tool/launch.sh weather_flutter
Ketuk untuk mengambil data cuaca. Ketukan itu memulai trace yang melintasi aplikasi, API cuaca, cache-nya, dan layanan cuaca eksternal.
6. Lihat di Observatory
Ketukan Anda sampai di Observatory dalam hitungan detik. Aplikasi menautkan ke data yang dikirimnya: ikuti link-nya untuk membuka trace dan melihat setiap langkah serta berapa lama langkah itu berlangsung.
Kami menggunakan cookie esensial untuk menjalankan situs ini, serta cookie analitik hanya dengan persetujuan Anda. Lihat Kebijakan Cookie dan Kebijakan Privasi kami.