Dartastic OTel Reference Demo
Dartasticのすべての機能を示す、設定済みのFlutterアプリ群です。実行してDartasticがエンドツーエンドで動く様子を確かめ、コードを読んで流用してください。
オープンソースのDart OTel Reference Demoを強化した商用版で、デモの数もはるかに多くなっています。どのアプリもパッケージをお客様のDartastic Pubから取得し、テレメトリーをお客様のObservatoryに送信します。そのため、デモが動けば、アカウントが正しく機能していることを確認できます。
ダウンロード
Control Roomにログインし、各画面の上部、「Help」の隣にあるReference Demoを押します:

dartastic-otel-reference-demo-<version>.tar.gzがダウンロードされます。コードを置いている場所に展開してください:
tar -xzf dartastic-otel-reference-demo-*.tar.gz
cd dartastic-otel-reference-demo-*最上位にあるREADME.mdが完全なガイドです。以下の手順で、最初の実行までたどり着けます。
Dedicatedの場合:お客様のサーバーを指定する
デモは最初からDartastic Cloudを指しているため、Cloudではここで行うことはありません。Dedicatedでは、お客様のサブドメインを指定して次のコマンドを1回実行してください:
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ワークスペースなので、最上位のフォルダーで、すべてのアプリのパッケージを一度に取得します:
flutter pub getこれが成功すれば、Dartastic PubとPubトークンは機能しています。次にアプリを起動します。tool/launch.shが、どの端末で実行するかを尋ねます:
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_flutter | 1回のタップをエンドツーエンドでトレース:アプリ、天気API、そのキャッシュ、外部の天気サービスを1つのトレースで。 |
all_demos_flutter | ほぼすべてのデモを、1つのアプリのタブとして。 |
rum_demo_flutter | セッション、画面表示、タップ、フラストレーションシグナルと、セッションリプレイ。 |
crash_demo_flutter | アプリが落ちても記録され、確実に届くクラッシュ。 |
symbolizer_demo_flutter | スタックトレースがお客様のファイル名と行番号に戻る、難読化されたリリースビルド。ウィジェットまでたどれるジャンク。 |
anr_demo_flutter | ANR(アプリが応答しない状態)の検出。 |
pii_demo_flutter | 個人情報をテレメトリーに含めない方法。 |
webview_demo_flutter | アプリ内のWebページから送られ、アプリのトレースに結び付くテレメトリー。 |
| プラットフォームの主要指標 | リリースの健全性、Android Vitals、iOSのMetricKit、アプリの起動、端末の状態、温度状態、ネットワークの不安定さ、ユーザー体験、Linuxサーバーの主要指標。それぞれ1つのアプリで。 |
各アプリには、送信した内容をObservatoryで開くリンクがあります。機能を学ぶには、そのアプリを実行してからコードを読んでください。その機能の、動作する最小の例です。AIコーディングアシスタントに読ませるのも効果的です。
Observatoryで見えるもの
デモを1回実行したときの画面です。ご自身で実行すると数値は変わりますが、各画面が示す内容は同じです。
フレームのビルド時間

リリースの健全性

アプリの起動

ネットワークの不安定さ

Interaction to Next Paint

First Contentful Paint

App Not Responding(イベント)

App Not Responding(継続時間)

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