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:

Tiga sinyal

OpenTelemetry mencatat tiga jenis data, yang disebut sinyal:

Trace
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.
Metrik
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.
Log
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.

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. 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.

Anda tiba di Control Room. Organization menampilkan nama dan ID organisasi Anda.

2. Unduh Reference Demo

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.

  1. Di Control Room, buka Tokens:
    Layar “Tokens” Control Room: “Generate Token”, dengan “+ Pub”, “+ Symbolizer”, “+ OTLP”, dan “+ Browser OTLP”
  2. Buat token Pub: tekan + Pub. Jendela berikut terbuka:
    Jendela “Generate Pub Token”: “Name”, akses yang diberikan token, organisasi, dan “Allow write (publish) access”
    • 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.
  3. Klik Generate. Token Anda ditampilkan sekali:
    Token Pub baru: “Token ID”, token rahasia dengan tombol salin, perintah dart pub token add, dan “Granted scopes: Pub”
    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.
  4. 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.
  5. 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:

shell
export OTEL_EXPORTER_OTLP_HEADERS="authorization=Bearer <your OTLP token>"

5. Jalankan demo

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.

Berikutnya