Alibaba Cloud API Gateway は、マイクロサービスの集約、フロントエンドとバックエンドの分離、およびシステム統合を容易にする API ホスティングサービスを提供します。 アクセスログは、 Web サービスによって生成されるログです。 各 API リクエストは、呼び出し元 IP、要求された URL、応答待ち時間、返されたステータスコード、各要求と応答のバイト数、およびその他の情報を含むアクセスレコードに対応します。 前述の情報を使用すると、Web サービスの動作状況を理解できます。

図 1. APIゲートウェイ


Log Service を使用すると、 Data Import Wizard を使用して API Gateway アクセスログを収集できます。

特徴

  1. オンラインログクエリ:ログ内の任意のキーワードを使用して、迅速で正確なファジークエリを実行できます。 この機能を使用すると、問題の特定やクエリのカウントに使用できます。
  2. 詳細な通話記録: API 通話記録の詳細を検索することができます。
  3. カスタマイズされた分析チャート:あなたのビジネス要件を満たす統計的な要件に応じて、任意のログ項目を統計チャートにカスタマイズすることができます。
  4. 解析レポート: API Gateway は、要求量、成功率、失敗率、待ち時間、API を呼び出すアプリケーションの数、障害統計、TOP グループ化、 TOP API、および TOP 遅延を含むいくつかのグローバル統計図を事前定義します。

フィールドの説明

ログフィールド 説明
apiGroupUid API グループ ID。
apiGroupName API グループ名。
apiUid API ID。
apiName API 名。
apiStageUid API ステージ ID。
apiStageName API ステージ名。
httpMethod 呼び出される HTTP メソッド。
path 要求されたパス。
domain 呼び出されるドメイン名。
statusCode HTTP ステータスコード
ErrorMessage エラーメッセージ。
appId 呼び出し元のアプリケーション ID。
appName 呼び出し元のアプリケーション名。
clientIp 呼び出し側のクライアント IP。
Exception バックエンドによって返された特定のエラーメッセージ。
providerAliUid API プロバイダのアカウント ID。
region リージョン、例えば cn-hangzhou。
requestHandleTime リクエスト時間(GMT)。
RequestId リクエスト ID。グローバルに一意です。
requestSize リクエストのサイズ(バイト単位)。
Responsesize 返されるデータのサイズ(バイト単位)。
Servicelatency バックエンドの待ち時間(ミリ秒単位)。

手順

  1. プロジェクトと Logstore を作成します。

    プロジェクトと Logstore の作成方法については、準備をご参照ください。

    Logstore がすでに存在する場合は、この手順をスキップします。

  2. データアクセスウィザードを開始します。

    Logstore を作成したら、Logstore リストページで Data Import Wizard アイコンをクリックしてください。

  3. データタイプを選択します。

    クラウド製品ログAPI Gateway をクリックし、 次へをクリックしてデータソース設定の手順に進みます。

  4. データソースを設定します。

    データソース設定ステップで、次の設定を完了しているかどうかを確認します。

    1. API Gateway サービスを有効にする。

      API Gateway は完全な API ホスティングサービスを提供し、能力、サービス、およびデータを API の形式でパートナーに公開するのに役立ちます。

      API Gateway サービスを有効にしていない場合は、関連ページの指示に従ってサービスを有効にします。

    2. 完全な Resource Access Management (RAM) の承認ログ情報を Logstore に収集できるように、配布ルールを設定する前に RAM を使用して Log Service を認可します。

      配布ルールを設定する前に RAM を使用して Log Service を認可します。

      承認を迅速に行うには、右上隅の承認をクリックします。

    3. 配信ルールを確立する。

      この手順を初めて実行する場合、システムは自動的に API Gateway ログをインポートし、配布ルールを確立します。 以前に API Gateway log collection を設定していた場合、Log distribution rules already exists メッセージが表示されます。 既存の配布ルールを削除することもできます。

    次へをクリックして、検索と分析と視覚化ページに入ります。

  5. 検索と分析と可視化を設定します。

    次の図に示すように、索引を構成します。 ダッシュボードでこの設定を使用するので、この設定を変更するときは注意する必要があります。

    図 2. 索引の構成


    次へをクリックして設定を完了します。 ログシッパーは、必要に応じて個別に設定することができます。

ウィザードの初期化が完了しました。 設定した Logstore api-gateway-access-log を選択して、ログを照会および分析したり、ダッシュボードにアクセスしてレポートを表示することができます。