App Optimize API の概要

App Optimize API を使用して、支出とリソース使用量を把握します。 Google Cloud デベロッパーと管理者は、この API を使用して、詳細な費用と使用状況データをプログラムで取得し、この情報をチームのダッシュボード、ツール、日常のワークフローに組み込むことができます。

API は、SQL クエリの結果と同様に、構造化された表形式でデータを返します。これにより、他のシステムへの解析と取り込みが簡単になります。

App Optimize API を使用する理由

プロジェクトと App Hub アプリケーションのレポートをエクスポートして、傾向分析を行ったり、他のビジネスデータと結合したりできます。また、この API を使用して、内部ダッシュボードの強化、カスタム アラート システムの駆動、デプロイ パイプラインへの費用と使用状況のチェックの組み込みを行うこともできます。

これらの統合により、管理者とアプリケーション デベロッパーは、ソフトウェア ライフサイクル全体を通して、データドリブンで費用を意識した意思決定を行うことができます。

分析ツールと統合する

主なユースケースは、費用と使用状況データの分析ツールへの定期的なエクスポートの自動化です。Cloud Run と Cloud Scheduler を使用してスケジュールされたジョブを設定すると、API を毎日呼び出して最新のデータを取得できます。

カスタム ダッシュボードを強化する

API は、カスタムの内部ダッシュボードを強化することもできます。チームは、事前構築済みのコンソール ビューに限定されるのではなく、特定の費用と使用状況の指標をオンデマンドで遅延読み込みするウェブ アプリケーションを構築できます。JavaScript を使用すると、ダッシュボードは API を呼び出し、バックグラウンドでデータが取得されている間も応答性を維持できます。これにより、チームのワークフローに直接埋め込まれた費用と効率のデータをカスタマイズして表示できます。

データドリブンな意思決定を可能にする

App Optimize API をシステムに統合することで、効果的なクラウド財務管理とリソース最適化に必要なデータに柔軟かつ自動的にアクセスできます。これらのプログラムによるアクセス パターンは、費用対効果に関する重要な質問に答えるのに役立ちます。最近費用が急増したサービスを特定したり、使用率の低いリソースを見つけたり、特定の期間内の特定のアプリケーションの正確な費用を計算したり、さまざまなプロダクトやリージョンでの支出の傾向をモニタリングしたりできます。

主な機能

App Optimize API の主な機能は次のとおりです。

  • 詳細なレポート。プロジェクト、個々のリソース、SKU、期間、App Hub アプリケーション、サービス、ワークロードなど、さまざまなディメンションにわたってデータを集計するレポートを生成します。
  • 費用と使用状況データ。金銭的費用、CPU 使用率（平均と 95 パーセンタイル）、CPU コアの使用量と割り当て、メモリ使用率（平均と 95 パーセンタイル）、メモリの使用量と割り当てなど、さまざまな情報にアクセスできます。
  • 柔軟なフィルタリング。Common Expression Language（CEL）を使用して、 レポートに含めるデータを正確にフィルタできます。期間、リソースタイプ、特定の App Hub アプリケーション、その他の利用可能な属性に基づいてフィルタして、分析対象を絞り込むことができます。

データを把握する

App Optimize API で生成されたレポートは有益な分析情報を提供しますが、データの性質と制限事項を理解することが重要です。

費用データ

  • ソース: 費用データは、Cloud Billing レポートとエクスポートの基盤となる情報と同じです。
  • レイテンシ: Google Cloud プロダクトは、 Cloud Billing プロセスに使用量データと費用データについてさまざまな間隔で報告します。プロダクトの使用と、App Optimize API レポートで使用量と費用が利用可能になるまでの間に遅延が生じる場合があります。 Google Cloud 通常、費用は 1 日以内に反映されますが、24 時間以上かかる場合もあります。
  • 総費用: 表示される費用は通常、総費用であり、確約利用割引、継続利用割引、プロモーション クレジットなどのクレジットが適用される前の契約料金での使用量を反映しています。
  • 通貨: App Hub アプリケーションでスコープを設定する場合、費用を集計するには、そのアプリケーション内のすべての基盤となるリソースで同じ通貨を使用する必要があります。リソースが異なる通貨の請求先アカウントにリンクされている場合、そのアプリケーションの費用データが不完全になったり、返されなかったりする可能性があります。
  • 個別に報告される費用: データ移転と Persistent Disk の費用は、データ移転または Persistent Disk の料金が発生するプロダクトのリソースレベルの費用とは別に報告されます。
  • 可用性: レポートフィルタの最長期間は、現在の日付の 90 日前です。開始時刻は 90 日間の時間枠内である必要があります。
  • プロダクト カテゴリ: App Optimize API レポートで使用されるプロダクト名は、論理的で使いやすいように設計されています。Cloud Billing レポートで使用されるサービス カテゴリとは異なる方法で費用がグループ化される場合があります。たとえば、App Optimize API レポートの「Compute Engine」の費用には、Cloud Billing の観点から複数の基盤となるサービスが含まれる場合があります。

使用状況データ

  • ソース: 使用状況の指標は Cloud Monitoring から取得されます。
  • 可用性:
    • レポートフィルタの最長期間は、現在の日付の 90 日前です。開始時刻は 90 日間の時間枠内である必要があります。Cloud Run の指標は、現在の日付の 6 週間前まで使用できます。
    • 可用性は、リソースタイプと、詳細な指標を収集するように適切なエージェント（Ops エージェントなど）が構成されているかどうかによって異なります。

App Optimize API の仕組み

費用と使用状況のレポートを生成するプロセスには、主に次の 3 つの段階があります。

  1. レポートをリクエストします。期間、対象とするリソースまたはアプリケーション、データのグループ化方法、必要な費用と使用状況の詳細など、関心のあるデータを指定します。レポートを作成した後は、その定義を変更することはできません。パラメータを変更する必要がある場合は、新しいレポートを作成する必要があります。
  2. データの準備が整うまで待ちます。データの収集と整理には時間がかかるため、このステップは非同期で実行されます。API には、レポートの準備ができたかどうかを確認する方法が用意されています。
  3. レポートデータを取得します。処理が完了したら、リクエストに基づいて行と列でフォーマットされたレポートをダウンロードできます。

生成されたレポートは、24 時間後に API から自動的に削除されます。

料金

プレビュー期間中は、レポートの作成、レポートの読み取り、レポート メタデータの読み取りなど、App Optimize API の使用に追加料金はかかりません。

App Optimize API にデータを提供するプロダクトに関連する費用については、次の情報をご覧ください。 Google Cloud

次のステップ