Bu sayfalar Cloud'un URL'lerini gösterir. Dedicated'da giriş yapın, sayfalar sunucunuzun URL'lerini göstersin.

Başlarken

OpenTelemetry'ye ilk bakıştan Observatory'deki kendi trace'inize kadar. Her adım bir öncekinin üzerine kurulur, bu yüzden sırayla ilerleyin.

OpenTelemetry hakkında

OpenTelemetry ile başlayın

Dartastic, yazılımın ne yaptığını kaydetmek için açık standart olan OpenTelemetry (OTel) üzerine kuruludur. Dartastic, OpenTelemetry spesifikasyonunu yakından izler: Adlar, veriler ve verinin gönderilme biçimi standart olanlardır. OpenTelemetry hakkında öğrendikleriniz Dartastic için de geçerlidir; Dartastic ile geliştirdikleriniz de standart OpenTelemetry olarak kalır.

Spesifikasyon anlaşılır bir metindir. Devam etmeden önce temel bir anlayış edinmek için OpenTelemetry dokümantasyonuna bir saat ayırın:

Üç sinyal

OpenTelemetry, sinyal adı verilen üç tür veri kaydeder:

Trace'ler
Adım adım ne olduğu ve her adımın ne kadar sürdüğü. Bir trace, span'lardan oluşan bir ağaçtır: bir dokunma, onun yaptığı ağ çağrısı, o çağrının arkasındaki sunucu işi ve onun altındaki veritabanı sorgusu. Tek bir trace uygulamanızdan sunucunuza geçebilir.
Metrikler
Zaman içinde ölçülen sayılar: frame süreleri, bellek, dakika başına istek, sürüm başına hata. Saklaması ucuzdur; bu yüzden eğilimleri gösterir ve uyarıları tetikler.
Loglar
Bir zamanı ve bir önem derecesi olan metin satırları. OpenTelemetry'de bir log, içinde yazıldığı trace'i taşır; böylece bir logdan, o anda olan diğer her şeyi açabilirsiniz.

Üçü de bir kaynak taşır: onları hangi uygulamanın, hangi sürümün, hangi cihazda gönderdiği. Dartastic bunların üzerine gerçek kullanıcı izlemeyi (oturumlar, ekranlar, dokunmalar ve replay) ekler; bunlar da standart sinyaller olarak kaydedilir. Bu sayfalarda kullanılan diğer kavramları Genel bakış sayfası açıklar.

GELİŞTİRMEDARTASTIC MİMARİSİKULLANICILARtoken'larissue'larPub token'ıpushCI token değişimiuygulamalar kullanıcılara ulaşır: uygulama mağazaları, web, sunucularsembollerçökmelerstack trace'lerkaynak kodtelemetriGeliştirici bilgisayarıflutter run · dart pub getCIGitHub Actions, GitLab, …Control Roomtoken oluşturma · rol tabanlı erişim denetimiControl Planekuruluşlar · roller · token'larDartastic Pubpaketler · kaynak kodObservatoryoturumlar · trace'ler · loglarSymbolizerçökmeler → kaynak kod satırlarıDartastic AIikisinden de beslenen yanıtlarIssue takip aracıGitHub · Jira · LinearMobil ve masaüstü uygulamalartelefonlar · tabletler · masaüstleriOTLP token'ı ile gönderirWeb uygulamalarıtarayıcılardaBrowser OTLP token'ı ile gönderirDart sunucularıbackend'ler · servislerOTLP token'ı ile gönderir

1. Giriş yapın

dartastic.io'ya giriş yapın. İlk girişinizde kuruluşunuzu kurarsınız: token'larınızın, ekip arkadaşlarınızın ve planınızın bağlı olduğu hesap. Bir ekip arkadaşınız sizi davet ettiyse davet edilen e-posta adresiyle giriş yapın; bu durumda onun kuruluşuna katılırsınız.

Kaydolduğunuzda kuruluşunuz kart gerekmeden Cloud Free ile başlar. Sizden şunlar istenir:

  • Kuruluş adı ve alt alan adı: kuruluşun adı ve uygulamalarınızın telemetri gönderdiği alt alan adı. Alt alan adı kalıcı olarak sizindir.
  • Bölge: telemetrinizin saklandığı yer. Sonradan değiştirilemez.
  • RUM sınırı: motorunuzun kaydedebileceği en yüksek replay düzeyi. Cloud Free, Wireframe düzeyine kadar çıkar; Shadow ve Pixel ücretli planlardadır. Motorunuz seçiminize göre forge edilir ve cihazdaki hiçbir şey bu sınırı aşamaz.
  • Dartastic AI: kendi model anahtarınızla çalışır; anahtarı o sırada veya sonradan ekleyebilirsiniz.

Yalnızca Dartastic Pub için, kaydolmadan önce Fiyatlandırma sayfasında bir Pub planı seçin. Kuruluşunuza ad verir ve bölgesini seçersiniz; başka bir şey istenmez.

Control Room açılır. “Organization” sayfası kuruluşunuzun adını ve ID'sini gösterir.

2. Reference Demo'yu indirin

Control Room'un üstündeki “Reference Demo” düğmesine basın ve dosyayı açın. Demoyu 5. adımda çalıştırırsınız: Dartastic'in çalıştığını görmenin en hızlı yoludur ve kodu her özelliğin nasıl kullanılacağını gösterir. Reference Demo hakkında daha fazla bilgi.

3. dart pub komutunu Dartastic Pub'ınıza bağlayın

Dartastic paketleri pub.dev'den değil, Dartastic Pub'ınızdan gelir ve dart pub komutunun oradan okumak için bir token'a ihtiyacı vardır. Çoğu geliştirici bunu daha önce hiç yapmamıştır; bilgisayar başına bir kez, bir dakika sürer.

Dartastic Pub, pub.dev'e de aktarım yapar. Paketlerinizi pubspec.yaml dosyasında her zamanki gibi tanımlayın; pub.dev'deki paketler, Dartastic paketleri ve özel paketlerinizle birlikte otomatik olarak pub.dev'den çözümlenir.

  1. Control Room'da “Tokens” ekranına gidin:
    Control Room'un “Tokens” ekranı: “+ Pub”, “+ Symbolizer”, “+ OTLP” ve “+ Browser OTLP” seçenekleriyle “Generate Token”
  2. Bir Pub token'ı oluşturun: “+ Pub” düğmesine basın. Pencere açılır:
    “Generate Pub Token” penceresi: “Name”, token'ın verdiği yetkiler, kuruluş ve “Allow write (publish) access”
    • Name: token'larınızı birbirinden ayırt etmenizi sağlayan herhangi bir ad; önerimiz pub-org-read-write.
    • Organization: bu token'ın paketlerini okuyup yayımladığı kuruluş.
    • Allow write (publish) access: Bu token ile Dartastic Pub'ınıza yayımlamak için işaretleyin. İşaretlenmezse token yalnızca okuyabilir; Pub'ınıza yayımlayan symbolizer_demo_flutter ve crash_demo_flutter dışında Reference Demo'nun ihtiyacı da yalnızca budur.
  3. “Generate” düğmesine tıklayın. Token'ınız bir kez gösterilir:
    Yeni Pub token'ı: “Token ID”, kopyalama düğmesiyle gizli token, dart pub token add komutu ve “Granted scopes: Pub”
    Token'ı şimdi kopyalama düğmesiyle kopyalayın: Bu pencereyi kapattıktan sonra bir daha gösterilemez. “Granted scopes: Pub”, bu token'ın yalnızca Pub için olduğu anlamına gelir: Telemetri gönderemez ve başka hiçbir hizmeti çağıramaz.
  4. Bir komut kabuğunda token'ı dart pub komutuna verin:
    shell
    dart pub token add https://pub.dartastic.io
    Enter secret token: isteminde token'ı yapıştırıp Enter'a basın. Yapıştırırken istem hiçbir şey göstermez; bu beklenen bir durumdur. Yanıt şöyledir:
    terminal
    Enter secret token:
    Requests to "https://pub.dartastic.io" will now be authenticated using the secret token.
  5. Reference Demo'nun klasöründe paketlerini alın:
    shell
    flutter pub get
    Başarılı olursa Pub'ınız ve token'ınız çalışıyor demektir.

dart pub, token'ı o host için saklar ve yalnızca oraya gönderir. Token'ları listeleme, değiştirme, kaldırma ve yayımlama Pub sayfasında anlatılır.

Bir Pub token'ı hangi paketlere erişir

Bir Pub token'ı, sahibinin kullanabildiği paketlere erişir, fazlasına değil.

  • Kuruluş yöneticileri kuruluştaki her pakete erişir, dolayısıyla token'ları da erişir.
  • Diğer ekip arkadaşları yalnızca kendilerine verilen paketler için token oluşturabilir. Bir yönetici, bir ekip arkadaşına paket verir.

Roller için Ekip arkadaşlarını davet etme sayfasına, kuruluş üyelerine paket vermek için Pub sayfasına bakın.

4. Uygulamanızın telemetri göndermesine izin verin

“Tokens” ekranında bir OTLP token'ı oluşturun, ardından onu kabuğunuzda OpenTelemetry'nin standart biçiminde dışa aktarın. authorization adını küçük harfle yazın:

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

5. Demoyu çalıştırın

Docker çalışırken hava durumu demosunu Reference Demo'nun klasöründen başlatın ve bir cihaz seçin:

shell
tool/launch.sh weather_flutter

Hava durumunu almak için dokunun. Bu dokunma; uygulama, hava durumu API'si, onun önbelleği ve dış hava durumu hizmeti boyunca ilerleyen bir trace başlatır.

6. Observatory'de görün

Dokunmanız saniyeler içinde Observatory ortamına ulaşır. Uygulama, gönderdiği verilere bağlantı verir: Trace'i açmak ve her adımı ve ne kadar sürdüğünü görmek için bağlantıyı izleyin.

Sonraki adımlar