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

概要

Dartasticは、DartとFlutterのアプリがユーザーの手元で実際にどう動いているかを示し、問題の修正を支援します。このページは全体の地図です。一度読んでから、はじめにの手順に沿って進めてください。

プラットフォーム

どのヘルプページにも同じ図があり、そのページで扱う部分が強調されているので、今どこにいるかが常にわかります。

ビルド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トークンで送信
  1. ビルドは、お客様のコンピューターとCIで行います。アプリはDartasticのパッケージを、pub.devからパッケージを取得するのと同じ方法でDartastic Pubから取得します。
  2. アプリが動くのは、スマートフォンやデスクトップ、ブラウザー、そしてDartサーバーです。アプリに組み込んだDartastic OTelのパッケージが動作を記録し、Observatoryに送信します。
  3. 何かが壊れたときは、Symbolizerが、アプリと一緒にPubに公開したシンボルを使って、クラッシュをお客様のファイル名と行番号に戻します。
  4. 原因を知りたいときは、Dartastic AIに尋ねます。テレメトリーとPub上のソースコードを読み、原因と修正案を答えます。
  5. Control Roomは、これらすべてを設定する場所です。図の各矢印を通すトークンを発行します。

構成要素

要素役割使う場所
Control Roomお客様のアカウントです。トークンの発行、チームメンバーの招待、プランの選択、Reference Demoのダウンロードをここで行います。ログイン後のdartastic.io/control-room
Dartastic Pubpub.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です。ユーザーのセッションが一つずつ、画面、タップ、エラー、フラストレーションシグナルとともに一覧表示されます:

Observatoryの「Sessions」一覧。ユーザーセッションごとに1行

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

タイムライン、再生位置のトレース、そのログが表示されたセッションリプレイ

トークンが要素をつなぐ

図の各矢印には、それぞれ専用の種類のトークンが必要です。トークンはControl Roomで発行し、それぞれ一度だけ表示されるので、発行したときにコピーしてください。dart pubでトークンを使ったことのある開発者は多くありませんが、Pubページで手順を説明しています。

トークン送信元送信先できること
Pubトークンお客様のコンピューターDartastic Pubdart pub getでDartasticのパッケージとプライベートパッケージをダウンロードでき、dart pub publishでアップロードできます。
CIでの交換お客様のCIDartastic PubCIにトークンを保存せずに、パッケージを読み取り、公開できます。
OTLPトークンスマートフォンやデスクトップのアプリ、DartサーバーObservatoryアプリがテレメトリーを送信できます。
Browser OTLPトークンFlutter WebアプリObservatoryWebアプリが、指定した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つ開きます。