概要
Dartasticは、DartとFlutterのアプリがユーザーの手元で実際にどう動いているかを示し、問題の修正を支援します。このページは全体の地図です。一度読んでから、はじめにの手順に沿って進めてください。
プラットフォーム
どのヘルプページにも同じ図があり、そのページで扱う部分が強調されているので、今どこにいるかが常にわかります。
- ビルドは、お客様のコンピューターとCIで行います。アプリはDartasticのパッケージを、pub.devからパッケージを取得するのと同じ方法でDartastic Pubから取得します。
- アプリが動くのは、スマートフォンやデスクトップ、ブラウザー、そしてDartサーバーです。アプリに組み込んだDartastic OTelのパッケージが動作を記録し、Observatoryに送信します。
- 何かが壊れたときは、Symbolizerが、アプリと一緒にPubに公開したシンボルを使って、クラッシュをお客様のファイル名と行番号に戻します。
- 原因を知りたいときは、Dartastic AIに尋ねます。テレメトリーとPub上のソースコードを読み、原因と修正案を答えます。
- Control Roomは、これらすべてを設定する場所です。図の各矢印を通すトークンを発行します。
構成要素
| 要素 | 役割 | 使う場所 |
|---|---|---|
| Control Room | お客様のアカウントです。トークンの発行、チームメンバーの招待、プランの選択、Reference Demoのダウンロードをここで行います。 | ログイン後のdartastic.io/control-room |
| Dartastic Pub | pub.devと同じように使えるプライベートなパッケージレジストリです。Dartasticのパッケージをここから取得し、お客様のプライベートパッケージを置き、アプリのソースコードを公開します。 | dart pub get, dart pub publish |
| Dartastic OTel | アプリに追加するパッケージです。アプリで起きたこと(画面、タップ、ネットワーク呼び出し、エラー、クラッシュ、パフォーマンス)をOpenTelemetryとして記録し、送信します。 | pubspec.yamlとmain() |
| Observatory | データを見る場所です。アプリが送るすべてのデータについて、リプレイ付きのセッション、トレース、ログ、メトリクス、クラッシュ、ダッシュボード、アラートを提供します。 | Control Roomから開きます |
| Symbolizer | 難読化されたリリースビルドの読めないスタックトレースを、お客様のファイル名と行番号に戻します。クラッシュが届くと自動で動作します。 | 呼び出しは不要:Pubに公開したシンボルを読み取ります |
| Dartastic AI | アプリについての質問に、普段の言葉で答えます。テレメトリーとPub上のソースコードを読み、原因を見つけて修正を提案します。 | ObservatoryとControl Roomの「Ask」ボタン |
表示される内容
これがObservatoryです。ユーザーのセッションが一つずつ、画面、タップ、エラー、フラストレーションシグナルとともに一覧表示されます:

セッションを開いてリプレイします。再生位置の下に、その瞬間のトレース、ログ、エラーが表示され、該当するコードの行に直接移動できます:

トークンが要素をつなぐ
図の各矢印には、それぞれ専用の種類のトークンが必要です。トークンはControl Roomで発行し、それぞれ一度だけ表示されるので、発行したときにコピーしてください。dart pubでトークンを使ったことのある開発者は多くありませんが、Pubページで手順を説明しています。
| トークン | 送信元 | 送信先 | できること |
|---|---|---|---|
| Pubトークン | お客様のコンピューター | Dartastic Pub | dart pub getでDartasticのパッケージとプライベートパッケージをダウンロードでき、dart pub publishでアップロードできます。 |
| CIでの交換 | お客様のCI | Dartastic Pub | CIにトークンを保存せずに、パッケージを読み取り、公開できます。 |
| OTLPトークン | スマートフォンやデスクトップのアプリ、Dartサーバー | Observatory | アプリがテレメトリーを送信できます。 |
| Browser OTLPトークン | Flutter Webアプリ | Observatory | Webアプリが、指定したWebサイトからだけテレメトリーを送信できます。 |
お持ちのトークンは、すべて1つの画面に一覧表示されます。各種類の説明と、取り消しや置き換えの方法はトークンで説明しています。
実行場所:プラン
- Cloudは、Dartasticが複数のお客様で共有するインフラで稼働します。Pubは
pub.dartastic.ioです。 - Dedicatedでは、お客様の組織専用のサーバーが、選んだサブドメインで稼働します。Pubは
pub.<subdomain>.dartastic.ioです。 - Self-Hostedでは、プラットフォーム全体がお客様のネットワーク内で稼働します。
手順はどのプランでも同じです。URLが異なる箇所では、両方を示しています。プランを比較。
必要なもの
- すべての機能を使うにはFlutter 3.44とDart 3.12以降が必要です。Flutterのメトリクス以外は、Flutter 3.22とDart 3.4で使えます。各パッケージに必要なバージョン。
- Dartasticアカウント:登録は無料です。登録すると、組織はCloud Freeで始まり、カードは不要です。
- Docker(Reference Demoの天気バックエンドにのみ必要)。
学び方
お好きな方法でどうぞ。扱う内容は同じです。
- ヘルプを読む:これらのページを順番に。各ページ下部の「前へ」と「次へ」で順に進めます。
- Dartastic OTel Reference Demoを実行する。オープンソースのDart OTel Reference Demoを強化した商用版で、デモの数もはるかに多く、Dartasticのすべての機能の使い方を示す、設定済みのFlutterアプリが揃っています。コードを読む、流用する、AIコーディングアシスタントに読ませる、どの使い方もできます。Reference Demoを入手。
- 質問する:サポートが質問にお答えします。
このヘルプで使う用語
- OpenTelemetry(OTel)
- ソフトウェアの動作を記録するためのオープン標準です。Dartasticは端から端までこの標準に従うため、お客様が書いたものがDartasticに縛られることはありません。
- OTLP
- OpenTelemetryの送信形式です。アプリが記録した内容を送る方法を定めています。
- トレースとスパン
- スパンは、時間を計測した1つの処理(タップ、ネットワーク呼び出し、データベースクエリ)です。トレースは1つの操作のスパンのツリーで、アプリとサーバーにまたがることもあります。
- ログ
- アプリが書き出したテキストの行で、それが起きたトレースに結び付いています。
- メトリクス
- 時間とともに測定される数値:フレーム時間、メモリ、リクエスト数。
- セッション
- 1人のユーザーがアプリを起動してから離れるまでの利用です。その間のすべての画面、タップ、エラー、トレースを含みます。
- リプレイ
- セッションを再生して見ることです。記録する量は選べます:イベントのタイムライン、ワイヤーフレーム、または実際のピクセル。
- RUM
- リアルユーザーモニタリング:テストではなく、実際にアプリを使っている人からのテレメトリーです。
- 難読化とシンボル
- リリースビルドでは名前を難読化できます(flutter build --obfuscate)。そのときに書き出されるシンボルファイル(--split-debug-info)が、元に戻すための鍵です。
- トークン
- あるものが、別の1つのものと通信できるようにする長いシークレット文字列です。種類ごとに、上の図の経路を1つ開きます。