eas-observe について
EAS Observe で本番アプリのパフォーマンスやエラーを監視する Expo 開発者向けのスキルです。計測の組み込み、CLI や Expo MCP Server による指標の照会、結果の読み解き方を説明します。
主な機能
- 01起動と画面遷移の計測
- 02カスタムイベントとエラーの記録
- 03EAS CLI による指標照会
- 04Expo MCP Server による指標照会
- 05パフォーマンス指標の解釈
活用シーン
- 01アプリ起動の遅延調査
- 02ルートとセッション指標の確認
- 03JavaScript エラーとネイティブクラッシュの発見
- 04ライブラリ連携が報告したイベントの確認
MCP 対応
Expo MCP Server の `observe_*` ツールを使った EAS Observe の照会方法と、CLI フラグとの入力の違いを説明します。
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ expo/ skills --skill eas-observeインストール後、Claude Code で/eas-observeを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
agents/openai.yamlreferences/library-integrations.mdmetrics.mdqueries.mdsetup.mdthird-party.md詳細
EAS Observe
EAS のサービスです。料金が発生します。 EAS Observe は Expo Application Services の製品です。無料の EAS プランでは、機能が一部に限られますが、月間アクティブユーザー数 10,000 人まで利用できます。それを超える利用には有料サブスクリプションが必要です。詳細は https://expo.dev/pricing#plan-features をご覧ください。
EAS Observe は、本番環境の Expo アプリの起動、画面遷移、カスタムイベントのパフォーマンスを追跡し、JavaScript エラーとネイティブクラッシュを記録します。開発ビルドまたは本番ビルドが必要です。ネイティブライブラリは Expo Go に含まれていません。
信頼できる情報源: https://docs.expo.dev/eas/observe/ — API の詳細が重要な場合は、必ず公式ドキュメントを参照してください。特に「はじめに」、設定、統合、メトリクスのリファレンスを確認してください。EAS Observe は進化を続けているため、このスキルのリファレンスは正確さを保つように記述していますが、ドキュメントより古い場合があります。
参照するリファレンス
./references/ にある 5 つのリファレンスファイルでは、このスキルでよく必要となる内容を扱っています。
- プロジェクトに EAS Observe を追加する →
./references/setup.md。インストール、ルートレイアウトのラップ(SDK 55 ではAppMetricsRoot、SDK 56 以降ではObserveRoot)、アプリをインタラクティブとしてマークする方法(SDK 55 ではグローバルなmarkInteractive()、SDK 56 以降ではuseObserve()フックまたは<ObserveInteractiveMarker />)、Expo Router / React Navigation の統合によるオプションのルートごとのナビゲーションメトリクス、Observe.logEventによるユーザー定義イベント(SDK 56 以降)、エラー報告、ランタイム設定(サンプリング、ディスパッチ、環境、カスタムエンドポイント)について説明します。 - ターミナルからメトリクスをクエリする →
./references/queries.md。eas observe:*コマンド(metrics-summary、metrics、routes、events、session、versions、errors、event)について、フラグ、メトリクスのエイリアス、テーブルのレイアウト、JSON の形式、一般的なワークフローを説明します。Expo MCP Server の対応するobserve_*ツールと、CLI のフラグとの入力の違いについても説明します。 - ダッシュボードまたは CLI 出力を読み取る →
./references/metrics.md。各メトリクスの目標しきい値、自動 TTI パラメーター(frameRate.*、device.*、network.*)の意味、起動が遅くても滑らかな場合と、メインスレッドの競合、ハードブロック、スロットリングされたデバイスを見分ける診断パターンについて説明します。 - ライブラリ統合による問題を報告する →
./references/library-integrations.md。ライブラリが検出した問題をイベントまたはエラーとして報告する、現在および今後の統合について、オプション、制限、レポートのクエリ方法を説明します。現在はexpo-image(画面よりもはるかに大きいサイズにデコードされた画像のexpo-image.oversizedイベント)とreact-native-reanimated(reanimated.errorエラー、およびオプションのreanimated.warningイベント)に対応しています。 - ライブラリで Observe の統合を提供する →
./references/third-party.md。パッケージ作成者向けの内容のみです(SDK 57 以降)。オプションのピア依存関係、設定の宣言マージ、Observe.registerIntegration()、イベント名について説明します。
ドキュメントへのクイックリンク
- はじめに:https://docs.expo.dev/eas/observe/get-started/
- ダッシュボードガイド:https://docs.expo.dev/eas/observe/dashboard/
- EAS CLI でクエリを実行する:https://docs.expo.dev/eas/observe/eas-cli/
- Expo MCP Server でクエリを実行する:https://docs.expo.dev/eas/observe/mcp/
- メトリクスのリファレンス:https://docs.expo.dev/eas/observe/reference/metrics/
- Expo Router の統合:https://docs.expo.dev/eas/observe/integrations/expo-router/
- React Navigation の統合:https://docs.expo.dev/eas/observe/integrations/react-navigation/
- Expo Image の統合:https://docs.expo.dev/eas/observe/integrations/expo-image/
- Reanimated の統合:https://docs.expo.dev/eas/observe/integrations/react-native-reanimated/
- ユーザー定義イベント:https://docs.expo.dev/eas/observe/events/
- エラー報告:https://docs.expo.dev/eas/observe/errors/
- 設定:https://docs.expo.dev/eas/observe/configuration/
- サードパーティ統合:https://docs.expo.dev/eas/observe/integrations/third-party/
- EAS Update のダウンロードパフォーマンス:https://docs.expo.dev/eas/observe/eas-update/
- トラブルシューティング:https://docs.expo.dev/eas/observe/reference/troubleshooting/
フィードバックの送信
このスキルにエラー、誤解を招く情報、または古い情報がある場合は、Expo が改善できるよう報告してください。
npx --yes @expo/agent-cli@latest feedback --category skills --subject "eas-observe" "<actionable feedback>"
具体的で実行可能な報告事項がある場合にのみ送信してください。関連するコンテキストをできるだけ詳しく記載してください。
エージェントが Expo のタスクで繰り返し失敗した場合や、ユーザーが介入する必要があった場合は、タスクの概要、期待される結果、問題点を簡潔に報告し、--category evals と、関連する Expo パッケージまたはコマンドを --subject として指定してください。