Red Hat Summit第31章 API アクセスを管理および最適化するための 3scale API Management API 解析の実装
3scale API 解析を実装して API アクセスを管理および最適化することで、時間と共に変化する使用状況の傾向などを追跡することができます。トラフィックを管理し、ピーク時に対応し、API に最も多くのリクエストを送信しているユーザーを特定するためには、ご自分の API がどのように使用されているかを知ることが重要なステップとなります。
3scale では、以下のレベルで定義可能なメソッドおよびメトリックに関する API 解析を収集します。
- プロダクト: Hits は、API へのトラフィックを追跡する組み込みのメトリックです。追加のメトリックを作成して、解析を取得する API にメソッドを指定することができます。
- バックエンド: 3scale では、メソッドおよびメトリックが API バックエンドに登録されます。これにより、メソッドおよびメトリックがバックエンドを使用する各プロダクトに属するかのように機能します。バックエンドレベルのメトリックの制限および課金ルールを、プロダクトレベルで定義されるアプリケーションプランに設定することができます。
- アプリケーション: 3scale で作成した各アプリケーションの解析レポートを取得することができます。
前提条件
- スタートガイドの手順 を完了している。
- あるいは、他のインテグレーション方法の類似作業フローに従います。利用可能なインテグレーションオプションの詳細は、「API ゲートウェイの管理」の APIcast の運用 の章を参照してください。
31.1. API の使用状況を把握する 3scale API Management API メトリクスおよびメソッド
3scale は、API プロダクトの統計値に関して無限にスケーラブルなデータリポジトリーとして機能します。メトリックおよびメソッドを使用して API プロダクトの統計値を取得することで、API へのアクセスを最適に管理するために必要な情報を取得できます。以下に例を示します。
- Hits/transactions
- API プロダクトへの呼び出し。Hits は、すべての API にデフォルトでメトリクスとして含まれています。Hits は、API プロダクトへの全呼び出し数とすることも、API プロダクトの個々のメソッドにブレークダウンすることもできます。
- Data transfer
- API プロダクトを通じてアップロードおよびダウンロードされたデータ量 (MB/GB 単位)
- CPU hours
- API プロダクトへの呼び出しに関連する処理時間 (またはその他の内部リソース)
- Results returned
- 返されるレコードまたはデータオブジェクトの数
- Disk storage
- アカウントにより使用されているディスクストレージの合計
ご自分の API プロダクトに関連するより多くのメトリックを追跡することができます。時間の経過と共に増加する数量であれば、3scale では任意の数のメトリックおよびメソッドを追加することができます。
使用するメトリックを選択したら、プロダクトおよびバックエンドへのメトリックの追加 に記載の手順に従って、管理ポータルにそれらのメトリックを登録します。
選択したプロダクトまたはバックエンドにメトリックおよびメソッドを追加することができます。それらに分かりやすい名前およびシステム名を設定します (3scale はこれらの名前をプラグイン設定で使用します)。メソッドおよびメトリックの作成に関する詳細は、使用状況の詳細を把握するためのメソッドの指定およびメトリックの追加 を参照してください。
'%20d='M201.5%20305.5c-13.8%200-24.9-11.1-24.9-24.6%200-13.8%2011.1-24.9%2024.9-24.9%2013.6%200%2024.6%2011.1%2024.6%2024.9%200%2013.6-11.1%2024.6-24.6%2024.6zM504%20256c0%20137-111%20248-248%20248S8%20393%208%20256%20119%208%20256%208s248%20111%20248%20248zm-132.3-41.2c-9.4%200-17.7%203.9-23.8%2010-22.4-15.5-52.6-25.5-86.1-26.6l17.4-78.3%2055.4%2012.5c0%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.3%2024.9-24.9s-11.1-24.9-24.9-24.9c-9.7%200-18%205.8-22.1%2013.8l-61.2-13.6c-3-.8-6.1%201.4-6.9%204.4l-19.1%2086.4c-33.2%201.4-63.1%2011.3-85.5%2026.8-6.1-6.4-14.7-10.2-24.1-10.2-34.9%200-46.3%2046.9-14.4%2062.8-1.1%205-1.7%2010.2-1.7%2015.5%200%2052.6%2059.2%2095.2%20132%2095.2%2073.1%200%20132.3-42.6%20132.3-95.2%200-5.3-.6-10.8-1.9-15.8%2031.3-16%2019.8-62.5-14.9-62.5zM302.8%20331c-18.2%2018.2-76.1%2017.9-93.6%200-2.2-2.2-6.1-2.2-8.3%200-2.5%202.5-2.5%206.4%200%208.6%2022.8%2022.8%2087.3%2022.8%20110.2%200%202.5-2.2%202.5-6.1%200-8.6-2.2-2.2-6.1-2.2-8.3%200zm7.7-75c-13.6%200-24.6%2011.1-24.6%2024.9%200%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.1%2024.9-24.6%200-13.8-11-24.9-24.9-24.9z'/%3e%3c/svg%3e){kind=small}