2026 年より、トランク安定版開発モデルに沿ってエコシステムのプラットフォームの安定性を確保するため、第 2 四半期と第 4 四半期に AOSP にソースコードを公開します。AOSP のビルドと投稿には、android-latest-release を使用します。android-latest-release マニフェストブランチは、常に AOSP にプッシュされた最新のリリースを参照します。詳細については、AOSP の変更点をご覧ください。

Google は AI 技術を使用して、コンテンツをご希望の言語に翻訳しています。AI 翻訳には誤りが含まれる場合があります。

ユーザーガイド

シミュレーションは、提供されているウェブデモを使用するか、REST API を直接呼び出すことで実行できます。

入力と出力

入出力ファイルは、Terraform の設定で指定した Cloud Storage バケットを使用します。

入力ディレクトリには、metrics_config.zip ファイルと publisher_config.zip ファイルが含まれている必要があります。必要に応じて、パスを定義できます。

出力用のバケットには simulations ディレクトリが含まれています。このディレクトリには、各シミュレーションが ID 別に保存されます。各シミュレーションディレクトリには、コピーされた入力ファイルを含む inputs フォルダと outputs フォルダが含まれています。outputs フォルダには、バグレポート、logcat ファイル、生成されたシミュレータファイルが含まれています。

ウェブデモを使用する

このプラットフォームには、シミュレーションの表示、作成、管理を行うためのデモ用の Flutter ベースのウェブアプリケーションが含まれています。ニーズに合わせて独自のユーザーインターフェースを構築することをおすすめします。

デモアプリは App Engine にデプロイされており、Google アカウントでログインする必要があります。これは、Google Cloud プロジェクトで構成された OAuth 2.0 クライアント ID を使用して保護されます。ログインしたアカウントには、デプロイされた Cloud Functions を呼び出すための IAM 権限が必要です。Cloud Functions 起動元ロール（roles/cloudfunctions.invoker）など、必要な権限をユーザーアカウントに付与する手順については、IAM でアクセスを認可するをご覧ください。

ユーザーワークフロー

OAuth 2.0 プロセスを使用して認証された Google アカウントでログインします。
メインページでシミュレーションを表示します。このページには、すべての実行情報を保持する Firestore データベースをクエリして、すべてのシミュレーションが一覧表示されます。
右下にある + 操作ボタンをクリックして、新しいシミュレーションをスケジュールするフォームに移動します。入力パス、ビルド ID、インスタンスタイプなど、いくつかのパラメータを指定します。詳細については、シミュレーションを作成するをご覧ください。
シミュレーションリストの更新でモニターのステータスを確認します。これにより、新しいシミュレーションのステータス（PENDING、RUNNING、COMPLETED など）が表示されます。
シミュレーションが完了したら、生成されたレポートとアーティファクトを確認します。入力ファイル、出力レポート、ログ、Logcat、バグレポートは Cloud Storage に保存されます。
省略可: スケジュール設定されたシミュレーションまたは実行中のシミュレーションをキャンセルします。

API の使用

他のシステムとの自動化と統合には、REST API を使用できます。

[Authentication] セクションとエンドポイント定義で使用されているプレースホルダ CLOUD_FUNCTION_URL は、呼び出される Cloud Functions の関数のベース URL を参照します。関数の URL は、Google Cloud コンソールの [Cloud Functions] ページで確認できます。各関数の URL は、[関数の詳細] ページの [トリガー] タブに表示されます。これらの URL は、apply コマンドの実行後に出力される Terraform の出力でも確認できます。

認証

すべての API リクエストは、呼び出し元の ID を証明する ID トークンを使用して認証する必要があります。ID（ユーザーまたはサービスアカウント）には、ターゲット関数に対する Cloud Functions 起動元の権限が必要です。

ユーザー呼び出し（ローカルと CLI）: ローカルマシンまたは Google Cloud 以外の環境から API を呼び出す場合は、ユーザーアカウント用に取得した Google 発行の ID トークンを使用する必要があります。
```
TOKEN=$(gcloud auth print-identity-token)
```
サービスアカウントの呼び出し（Google Cloud 内）: Google Cloud リソース（Compute Engine VM、別の Cloud Functions の関数、Kubernetes クラスタなど）から API を呼び出す場合は、リソースに接続されているサービスアカウントの ID を使用します。トークンは、リソースのメタデータサーバーから取得する必要があります。
```
TOKEN=$(curl -s "http://metadata.google.internal/computeMetadata/v1/instance/service-accounts/default/identity?audience=CLOUD_FUNCTION_URL" -H "Metadata-Flavor: Google")
```

取得したトークンを Bearer トークンとしてリクエストの Authorization ヘッダーに含めます。

エンドポイント

Cloud Telemetry Simulation スタックのユーザー向けエンドポイントを使用すると、シミュレーションの作成と削除、データベースからのシミュレーション情報の読み取りを行うことができます。

シミュレーションを作成する

このエンドポイントは、新しいシミュレーションリクエストを作成し、実行をスケジュールします。

エンドポイント: POST https://CLOUD_FUNCTION_URL/simulation-orchestrator-receive-requests
リクエストの本文:
```
{
  "build_id": "latest",
  "file_path": "inputs/my-test-case/",
  "instance_type": "n1-standard-8",
  "owner": "user@example.com",
  "max_simulation_time": 300,
  "max_report_count": 5
}
```
- build_id（文字列）: 使用するエージェント Docker イメージのタグ（例: latest）。
  
  重要: これは、インフラストラクチャの許可されたイメージマップで定義されているタグ（latest、stable など）と一致する必要があります。Terraform で SHA256 マップが定義されている場合、システムは不明なタグを拒否します。
- file_path（文字列）: metrics_config.zip と publisher_config.zip を含むフォルダへの GCS バケット内のパス。
- instance_type（文字列）: Compute Engine マシンタイプ。このタイプは、n1、n2、t2d シリーズなど、ネストされた仮想化をサポートしている必要があります。詳細については、ネストされた仮想化の概要をご覧ください。
- owner（文字列）: シミュレーションを開始するユーザーのメールアドレス。
- max_simulation_time（整数）: シミュレーションが実行される最大時間（秒単位）。
- max_report_count（整数）: シミュレーションが終了するまでのテレメトリーレポートの数。
成功レスポンス（200 OK）:
```
{ "id": "sim-a1b2c3d4e5f6" }
```

シミュレーションを削除する

このエンドポイントは、保留中または実行中のシミュレーションをキャンセルし、関連するリソースを削除します。

エンドポイント: POST https://CLOUD_FUNCTION_URL/simulation-orchestrator-delete-simulation
ヘッダー:
- Content-Type: application/json
リクエストの本文:
```
{ "id": "sim-a1b2c3d4e5f6" }
```
成功レスポンス（200 OK）: プレーンテキストメッセージ（Request accepted and is being processed）。

シミュレーションデータを読み取る

シミュレーションデータを読み取るには、simulation-reader 関数を操作します。これらのエンドポイントは、GET メソッドを使用して履歴、ステータス、システム構成を取得します。

シミュレーションを一覧表示する

フィルタリングと並べ替えをサポートするシミュレーションのページ分けされたリストを取得します。

エンドポイント: GET https://CLOUD_FUNCTION_URL/simulation-reader/simulations
クエリパラメータ（すべて省略可）:
- status（文字列）: シミュレーションステータス（running、Simulation request received、cancelled、completed、failed）でフィルタします。
- owner（文字列）: オーナーのメールアドレスでフィルタします。
- sort_by（文字列）: 並べ替えに使用するフィールド（received_at、status_updated_at、started_at）。デフォルトは received_at です。
- sort_order（文字列）: 並べ替え順（asc または desc）。デフォルトは desc です。
- page_size（整数）: 1 ページあたりの結果の数。デフォルト値は 20 です。
- page_token（文字列）: 結果の次のページを取得するためのトークン。

リクエストの例:

curl -H "Authorization: Bearer $TOKEN"
"https://CLOUD_FUNCTION_URL/simulation-reader/simulations?status=completed&owner=user@example.com&sort_by=status_updated_at"

成功レスポンス（200 OK）:

シミュレーションの配列とオプションの next_page_token を含む JSON オブジェクトを返します。

{
  "simulations": [
    {
      "id": "1234-abcd",
      "owner": "some@email.com",
      "status": "completed",
      "status_updated_at": "2025-12-05T14:50:00.952Z",
      "received_at": "2025-12-05T14:46:43.106Z",
      "started_at": "2025-12-05T14:47:05.848Z",
      "ended_at": "0001-01-01T00:00:00Z",
      "instance_id": "sim-1234-abcd",
      "ip": "10.156.15.230",
      "build_id": "europe-west3-docker.pkg.dev/your-project/simulation/simulation-agent:latest",
      "instance_type": "n1-standard-8",
      "file_path": "gs://your-project-simulation_files/path/",
      "max_simulation_time": 60,
      "max_report_count": 1
    },
    {
      "id": "5678-efgh",
      "owner": "some@email.com",
      "status": "completed",
      "status_updated_at": "2025-11-07T14:49:54.25Z",
      "received_at": "2025-11-07T14:46:54.959Z",
      "started_at": "2025-11-07T14:47:13.714Z",
      "ended_at": "0001-01-01T00:00:00Z",
      "instance_id": "sim-5678-efgh",
      "ip": "10.156.15.221",
      "build_id": "europe-west3-docker.pkg.dev/your-project/simulation/simulation-agent:latest",
      "instance_type": "n1-standard-8",
      "file_path": "gs://your-project-simulation_files/path/",
      "max_simulation_time": 60,
      "max_report_count": 1
    }
  ],
  "next_page_token": "M7bydGsAptLncj8SOCb1"
}

特定のシミュレーションを取得する

特定のシミュレーションの詳細を ID で取得します。

エンドポイント:

GET https://CLOUD_FUNCTION_URL/simulation-reader/simulations/[SIMULATION_ID]

成功レスポンス（200 OK）: リクエストされたシミュレーションの詳細を含む JSON オブジェクトを返します。

{
  "id": "1234-abcd",
  "owner": "some@email.com",
  "status": "completed",
  "status_updated_at": "2025-12-05T14:50:00.952Z",
  "received_at": "2025-12-05T14:46:43.106Z",
  "started_at": "2025-12-05T14:47:05.848Z",
  "ended_at": "0001-01-01T00:00:00Z",
  "instance_id": "sim-1234-abcd",
  "ip": "10.156.15.230",
  "build_id": "europe-west3-docker.pkg.dev/your-project/simulation/simulation-agent:latest",
  "instance_type": "n1-standard-8",
  "file_path": "gs://your-project-simulation_files/path/",
  "max_simulation_time": 60,
  "max_report_count": 1
}

システム指標と構成を取得する

これらのエンドポイントは、シミュレーションインフラストラクチャの現在の負荷と構成に関する分析情報を提供します。

実行中のシミュレーション数を取得する: 実行中のシミュレーションの数を返します。
- エンドポイント:
```
GET https://CLOUD_FUNCTION_URL/simulation-reader/simulations/running/count
```
- 成功レスポンス（200 OK）:
```
{
  "count": 0
}
```
最大同時実行 VM 数を取得する: 構成されている同時実行 VM の最大数を返します。
- エンドポイント:
```
GET https://CLOUD_FUNCTION_URL/simulation-reader/config/max-running-vms
```
- 成功レスポンス（200 OK）:
```
{
  "max_running_vms": 5
}
```