このヘルプにはCloudのURLが表示されています。Dedicatedでログインすると、お客様のサーバーのURLが表示されます。

Dartastic OTel Reference Demo

Dartasticのすべての機能を示す、設定済みのFlutterアプリ群です。実行してDartasticがエンドツーエンドで動く様子を確かめ、コードを読んで流用してください。

オープンソースのDart OTel Reference Demoを強化した商用版で、デモの数もはるかに多くなっています。どのアプリもパッケージをお客様のDartastic Pubから取得し、テレメトリーをお客様のObservatoryに送信します。そのため、デモが動けば、アカウントが正しく機能していることを確認できます。

ビルドDartasticアーキテクチャユーザートークンIssuePubトークンプッシュCIトークン交換アプリをユーザーへ配布:アプリストア、Web、サーバーシンボルクラッシュスタックトレースソーステレメトリー開発用コンピューターflutter run · dart pub getCIGitHub Actions、GitLab、…Control Roomトークン発行 · ロールベースのアクセス制御コントロールプレーン組織 · ロール · トークンDartastic Pubパッケージ · ソースObservatoryセッション · トレース · ログSymbolizerクラッシュ → ソースコードの行Dartastic AI両方のデータから回答IssueトラッカーGitHub · Jira · Linearモバイル・デスクトップアプリスマートフォン · タブレット · デスクトップOTLPトークンで送信Webアプリブラウザーで動作Browser OTLPトークンで送信Dartサーバーバックエンド · サービスOTLPトークンで送信

ダウンロード

Control Roomにログインし、各画面の上部、「Help」の隣にあるReference Demoを押します:

「Help」と「Sign Out」の隣に「Reference Demo」ボタンがあるControl Roomのヘッダー

dartastic-otel-reference-demo-<version>.tar.gzがダウンロードされます。コードを置いている場所に展開してください:

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

最上位にあるREADME.mdが完全なガイドです。以下の手順で、最初の実行までたどり着けます。

Dedicatedの場合:お客様のサーバーを指定する

デモは最初からDartastic Cloudを指しているため、Cloudではここで行うことはありません。Dedicatedでは、お客様のサブドメインを指定して次のコマンドを1回実行してください:

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

サブドメインを.env(gitの管理対象外)に書き込み、pubspecを更新します。別のサブドメインで再実行すると切り替わり、""で実行するとCloudに戻ります。

必要なトークン

どのトークンもControl RoomのTokens画面で発行します。各トークンは一度しか表示されないため、発行したときにコピーしてください。

トークン用途
Pubトークン
dart pub token add(1回のみ)
すべてのデモ:flutter pub getがお客様のDartastic Pubからパッケージを取得します。
OTLPトークン
OTEL_EXPORTER_OTLP_HEADERS
すべてのデモ:アプリがテレメトリーをお客様のObservatoryに送信します。
Symbolizerトークン
DARTASTIC_SYMBOLIZER_TOKEN
symbolizer_demo_flutterのみ。

symbolizer_demo_flutterとcrash_demo_flutterを除くすべてのデモは、読み取り専用のPubトークンで動きます。この2つはお客様のPubに公開するため、読み書きできるトークンが必要です。Pubトークンの追加と、ほかのトークンのエクスポートの手順ははじめにで説明しています。

トークンは.envに書き込まず、シェルでエクスポートしてください。共有されたりコミットされたりした.envは、シークレットが漏えいするよくある原因です。

デモを実行

デモは1つのFlutterワークスペースなので、最上位のフォルダーで、すべてのアプリのパッケージを一度に取得します:

shell
flutter pub get

これが成功すれば、Dartastic PubとPubトークンは機能しています。次にアプリを起動します。tool/launch.shが、どの端末で実行するかを尋ねます:

shell
tool/launch.sh --list          # every demo app
tool/launch.sh                 # weather_flutter
tool/launch.sh rum_demo_flutter
  • Dockerが必要なのはweather_flutterとall_demos_flutterだけです。この2つはお客様のマシン上で天気APIを起動し、アプリとサーバーにまたがる1つのトレースを示します。
  • デモはAndroid、iOS、macOS、Windows、Linuxの実機とシミュレーターで動作します。Webでは動作しません。

収録内容

アプリ内容
weather_flutter1回のタップをエンドツーエンドでトレース:アプリ、天気API、そのキャッシュ、外部の天気サービスを1つのトレースで。
all_demos_flutterほぼすべてのデモを、1つのアプリのタブとして。
rum_demo_flutterセッション、画面表示、タップ、フラストレーションシグナルと、セッションリプレイ。
crash_demo_flutterアプリが落ちても記録され、確実に届くクラッシュ。
symbolizer_demo_flutterスタックトレースがお客様のファイル名と行番号に戻る、難読化されたリリースビルド。ウィジェットまでたどれるジャンク。
anr_demo_flutterANR(アプリが応答しない状態)の検出。
pii_demo_flutter個人情報をテレメトリーに含めない方法。
webview_demo_flutterアプリ内のWebページから送られ、アプリのトレースに結び付くテレメトリー。
プラットフォームの主要指標リリースの健全性、Android Vitals、iOSのMetricKit、アプリの起動、端末の状態、温度状態、ネットワークの不安定さ、ユーザー体験、Linuxサーバーの主要指標。それぞれ1つのアプリで。

各アプリには、送信した内容をObservatoryで開くリンクがあります。機能を学ぶには、そのアプリを実行してからコードを読んでください。その機能の、動作する最小の例です。AIコーディングアシスタントに読ませるのも効果的です。

Observatoryで見えるもの

デモを1回実行したときの画面です。ご自身で実行すると数値は変わりますが、各画面が示す内容は同じです。

フレームのビルド時間

flutter.frame.buildの「Metric」画面に、ヒートマップで表示したall_demos_flutter:4分間のフレームで、実行が進むにつれてp95の線が上がっています。
flutter.frame.buildの「Metric」画面に、ヒートマップで表示したall_demos_flutter:4分間のフレームで、実行が進むにつれてp95の線が上がっています。

リリースの健全性

リリースの健全性デモのflutter.sessionスパン(セッションごとに1つ)で絞り込んだ「Traces」。赤い行が、クラッシュしたセッションです。
リリースの健全性デモのflutter.sessionスパン(セッションごとに1つ)で絞り込んだ「Traces」。赤い行が、クラッシュしたセッションです。

アプリの起動

flutter.app.startup.durationの「Metric」画面のヒートマップ:約2.2秒のコールドスタートが3回、33msと63msのホットスタートが2回。
flutter.app.startup.durationの「Metric」画面のヒートマップ:約2.2秒のコールドスタートが3回、33msと63msのホットスタートが2回。

ネットワークの不安定さ

dartastic.network.flaky = trueで絞り込んだ「Traces」:不安定なリクエストが2件。1件は6.56秒かかり、もう1件は114msでエラーになりました。
dartastic.network.flaky = trueで絞り込んだ「Traces」:不安定なリクエストが2件。1件は6.56秒かかり、もう1件は114msでエラーになりました。

Interaction to Next Paint

flutter.experience.inpの「Metric」画面のヒートマップ:8回の操作のうち、2回が16ms未満、6回が200〜250ms。
flutter.experience.inpの「Metric」画面のヒートマップ:8回の操作のうち、2回が16ms未満、6回が200〜250ms。

First Contentful Paint

flutter.experience.fcpの「Metric」画面:First Contentful Paintが1回、2.67秒。
flutter.experience.fcpの「Metric」画面:First Contentful Paintが1回、2.67秒。

App Not Responding(イベント)

anr_demo_flutterのdartastic.app.anrイベントで絞り込んだ「Logs」:ANRが3件。イベントには重大度がないため「Unspecified」として数えられ、各行にはイベント名が表示されています。
anr_demo_flutterのdartastic.app.anrイベントで絞り込んだ「Logs」:ANRが3件。イベントには重大度がないため「Unspecified」として数えられ、各行にはイベント名が表示されています。

App Not Responding(継続時間)

同じ3件のANRを、flutter.anr.durationの「Metric」画面で:いずれも6.0〜6.6秒で、エクスポートされた時点に表示されています。
同じ3件のANRを、flutter.anr.durationの「Metric」画面で:いずれも6.0〜6.6秒で、エクスポートされた時点に表示されています。

iOSのMetricKitによるアプリの終了

dartastic.app.exit.countの「Metric」画面の棒グラフ:5分間の1ステップに50回の終了。内訳は正常終了43回、メモリ不足3回、ウォッチドッグ3回、タイムアウト1回。
dartastic.app.exit.countの「Metric」画面の棒グラフ:5分間の1ステップに50回の終了。内訳は正常終了43回、メモリ不足3回、ウォッチドッグ3回、タイムアウト1回。