分析ダッシュボード

IBM® API Connect 分析には、分析データを表示するためのダッシュボードが用意されています。

分析ダッシュボード

API Manager UI の分析ダッシュボードには、プロバイダー組織、カタログ、およびスペースの有効範囲での API イベント・データが表示されます。 表示される分析データの範囲は、分析ダッシュボードへのアクセス方法によって異なります：アナリティクスへのアクセス。

プロバイダ組織スコープのダッシュボードは、ナビゲーションペインの [Analytics] アイコン 分析アイコン からアクセスできます：

アナリティクス・ダッシュボード

スペースを有効範囲とするダッシュボードには、スペースの表示時に 「分析」 タブからアクセスします。

スペース・スコープ型分析ダッシュボード

12種類のダッシュボードが用意されている：
サマリー
通話量、待ち時間、時間ベースのトレンドなど、ハイレベルなメトリクスを表示します。
使用量
ゲートウェイによって処理されたAPIコールの総数を経時的に追跡する。 このデータを消費ベースのライセンシングに使用する。
API
どのAPIが呼び出され、どのAPIが呼び出されていないかを特定する。
製品
全体的にどの製品が最も人気があるのか、またその使用率が時間とともにどのように変化していくのかをご覧ください。
消費者
どの消費者組織がAPIコールを最も多く行っているかを、総計と時間の両方で判断する。
アプリケーション
どのアプリケーションがAPIコールを最も多く生成しているかを、全体的かつ時系列的に分析する。
AI 使用状況
AIサービスの利用状況を監視する。 消費者別のトークン数とAIモデルの使用状況を追跡。
状況
APIコールの成功率と失敗率を経時的にレビューする。 HTTP レスポンスコードの内訳を含む。
待ち時間
APIの応答時間を測定する。 最も速いAPIと最も遅いAPIを特定し、応答時間の経時変化を追跡する。
データ転送
リクエストとレスポンスのペイロードサイズを分析する。 最大のペイロードの原因となるAPI、コンシューマー、アプリケーションを特定する。
お客様情報
誰がどのデバイスからAPIを呼び出しているかを確認できます。
注： インターネットにアクセス可能なIPアドレスだけが、地理的位置に解決できる。 内部 IP アドレスは無視されます。 GeoIP データベースは、 API Connect フィックスパックごとに更新されます。 最新のフィックスパックを適用し、精度を維持する。
ゲートウェイ操作
各ゲートウェイ・サービスの各ゲートウェイのコール量とレイテンシーを表示します。 このデータを使って負荷分散をチェックし、パフォーマンスの低いゲートウェイを特定する。

ダッシュボード内の各グラフは、PNG イメージまたは JPG イメージとしてエクスポートできます。 各グラフのソース・データは、JSON ファイルまたは CSV ファイルとしてエクスポートできます。 チャートをエクスポートするには、右上の Actionsをクリックします：分析円グラフ

フルスクリーンアイコン をクリックすると、チャートをフルスクリーンに拡大することも可能です。 ソース・データを表形式で見るには、 表形式のアイコン をクリックする。

「ディスカバー」ビュー

デフォルトでは、 「ダッシュボード」 タブが表示されます。 APIイベントデータを表形式で表示するには、 Discoverを選択します：「ディスカバー」ビュー

UI からアクセスできる API イベントの最大数は、10,000 です。 「Discover」 ビューでページごとに表示できるイベント・レコードの最大数は 200 です。

このビューからAPIイベントデータをエクスポートするには、右上の Actionsをクリックします： 「エクスポート」メニュー・オプション

注: 「Discover」 ビューからエクスポートする場合、結果の現行ページに表示されているデータのみがエクスポートされます。 すべてのページからデータをエクスポートする場合は、各ページから個別にエクスポートする必要があります。

レポートビュー

デフォルトでは、「 ダッシュボード 」タブが表示されます。 レポートにアクセスするには、 「レポート 」を選択します。 レポートビューは、長期的なデータ保持と分析のために設計されています。 レポートは、過去の傾向と保管効率に焦点を当て、戦略的洞察に最適です。 フィルタリングオプションは、過去30日、過去90日、またはそれ以上など、拡張された時間範囲に最適化されています。

「分析フィルター」ウィンドウ

6つのレポートが用意されている：
通話量の推移
API、製品、プランにまたがるAPIコール量の長期的傾向を分析する。
消費者の傾向
コンシューマー組織やアプリケーションのアプリケーション数、サブスクリプション数、APIコール数の長期的なトレンドを追跡します。
消費レポート
このスコープで、ゲートウェイが処理するAPIコールの長期的な傾向を検証する。 このデータを消費ベースのライセンシングに使用する。
非アクティブ製品
サブスクリプションやトラフィックがなく、プロモーションや非推奨が必要な製品を特定する。
非アクティブなコンシューマー組織
APIを積極的に利用していない消費者組織を発見する。
非推奨の製品
まだトラフィックを受けている非推奨製品を特定する。 これらのコンシューマーを代替プランにマイグレーションすることを検討してください。

APIコール量リーダーボードをダウンロードするには、ページをスクロールダウンし、必要なリーダーボードのダウンロードアイコンをクリックします。 リーダーボードは、最も頻繁にアクセスされるAPI、製品、プラン、アプリケーション、消費者組織、ゲートウェイ・サービス、コンフィグ・シンク・データ、カタログ別内訳のランキング概要を提供します。 カタログでスペースが有効になっている場合、リーダーボードにはスペースのリーダーボードが含まれる。

API コール・ボリューム・リーダーボード

表示データのフィルタリング

照会を定義することで、 「ダッシュボード」 ビューおよび 「ディスカバー」 ビューに表示されるデータをフィルターに掛けることができます。 「フィルター」 セクションを展開して、表示されているデータに対する分析照会を表示、定義、および適用します。

「分析フィルター」ウィンドウ

定義した照会を保存して共有することができます。
  • 共有照会は、同じ有効範囲のすべてのユーザーに表示されます。 別のスコープ内のユーザーには表示されません。 例えば、 Cloud Manager UI ユーザーによって共有される照会は、 API Manager UI ユーザーには表示されません。 API Manager UI 内では、カタログ・スコープで作成された照会は、プロバイダー組織スコープで分析データを表示しているユーザーには表示されません。
  • 他のユーザーは、共有している照会を編集または削除することはできませんが、編集および共有できる重複照会を作成することはできます。
  • すべての照会には、名前とオプションの説明があります。 名前は固有である必要はありません。

保存された照会は、REST API および ツールキット CLI 照会で使用するためにストリングとしてエクスポートできます。以下に例を示します。

「分析コピー照会」メニュー・オプション は次の文字列をクリップボードにコピーする：
api_name=equals:boo&timeframe=last30days

アナリティクスでデフォルトのクエリを設定する

アナリティクスのダッシュボードまたはディスカバーページにアクセスしたときに自動的に適用されるデフォルトクエリを設定できるようになりました。 デフォルトのクエリは、ユーザーごと、スコープ（組織、カタログ、スペース）ごとに設定されます。
注:
  • デフォルト・クエリとして設定できるのは、共有クエリのみです。
  • 各スコープは、ユーザーごとに1つのデフォルトクエリを持つことができます。 カタログやスペースごとに異なるデフォルトクエリを設定することができる。
  1. デフォルトに設定したいクエリが保存されていることを確認してください。
  2. 保存したクエリを共有するには、以下の手順を実行します。
    • 保存」 タブをクリックする。
    • オプションメニューから「 共有 」をクリックする。
    • クエリの共有] ウィンドウで、[ 共有] をクリックします。
  3. 共有 」タブをクリックする。
  4. オプションメニューから、 Set as default queryをクリックします。Editanalytics_copy_query.png
  5. Default query ウィンドウで、 Defaultをクリックします。
  6. デフォルトのクエリーをすぐに適用するには 「適用」をクリックします。 デフォルトのクエリは、そのスコープ内のすべてのユーザーに対して即座に適用されます。 デフォルトのクエリを設定した後に［ 適用 ］をクリックしないと、次に ［ダッシュボード ］または［ 発見］ タブにアクセスしたときに自動的に適用されます。