API 使用状況ビュー


前提条件
  • Oauth > クライアント > ビュー 権限

API の使用状況ビューを使用すると、数を確認できます。 API コンタクト センターが行う要求と、それらの要求を行うクライアント。を超える場合 API のフェアユース ポリシーこの情報は、どのクライアントが最も多くの要求を行うか、および組織が最も頻繁に使用する要求の種類を判断するのに役立ちます。この情報を使用して、API の使用を合理化し、超過分の回避や計画を行うことができます。

このビューのデータには、カスタムまたは 3 番目の相手 アプリケーション、統合、およびソリューションをサポートするために組織から行われたすべての PUT、POST、GET、または DELETE の呼び出しが含まれます。 AppFoundry アプリ. また、PureCloud パブリック API へのデータ アクションも含まれます。

このビューには、PureCloud がブラウザー、Web、モバイル アプリの機能をサポートするために行う API 要求に関するデータ、または外部プラットフォームへの送信データ アクションは含まれません。また、行われた API 要求も含まれません。 PureCloud 埋め込みクライアントChrome PureCloud、Firefox PureCloud、PureCloud Salesforce、PureCloud for Zendesk を含む。

PureCloud は、00 :00 :00 ~ 23 :59 :59 の間に行われたすべての API 要求の集計として、API 使用状況データを毎日計算します。この計算は、utC 時間 標準 に従い、PureCloud 請求 データに合わせて計算されます。

API の使用状況ビューを表示するには、 パフォーマンス > API の使用状況.

注意:このビューには、現在の日付のデータは含まれません。

API 使用状況データの計算

使いやすさのために、API 使用状況ビューは、ローカルタイムゾーン に API 要求の日付を表示します。場合によっては、UTC からローカル タイムゾーン への調整は、API 使用状況ビューで表される API 要求の日付が、クライアントのローカル タイムゾーン に従って、要求が行われた日付と異なる可能性があることを意味します。

ビューを解釈する

ビューには、グラフと 2 つの主要なセクションが含まれています。OAuth クライアントと API 要求。各セクションには、特定のクライアントまたは要求に関連するデータの列があります。

データのグラフ

このグラフには、OAuth クライアントと API 要求セクションに適用されているフィルタがある場合でも、選択した期間のすべての API 要求が表示されます。ただし、日付範囲として 1 日を選択した場合、グラフにはデータは表示されません。

データに関する詳細を表示するには、グラフのバーにカーソルを合わせます。は バーの上はその期間の最大の金額を表し、 最低額を表します。

オースクライアント

[OAuth クライアント] セクションには、選択した期間内に API 要求を行ったクライアントの一覧が表示されます。これらのクライアントには、カスタムまたは 3 番目の相手 アプリケーション、統合、およびソリューションが含まれます。 AppFoundry アプリ. クライアントをクリックして、[API 要求] セクションでそのクライアントが行った要求を強調表示します。

API 要求

[API 要求] セクションには、OAuth クライアントによって行われたすべての PUT、POST、GET、または DELETE 呼び出しの一覧が表示されます。API 要求をクリックして、要求を行ったクライアントを強調表示します。

セクション列

デフォルト 、各セクションには4つの列があります。

  • その特定のセクションのクライアントまたは API 要求のリスト
  • クライアントまたは API への要求の数エンドポイント
  • クライアントまたは API に対する要求の割合エンドポイント
  • 要求の総数と比較した要求の割合の視覚的な表現

説明
画像をクリックして拡大します。API 使用状況ビュー名列 OAuth クライアントまたは API 要求 API 要求を行う特定の OAuth クライアント、または組織が行った特定の API 要求。
画像をクリックして拡大します。API 使用状況ビュー要求列数 要求の数 OAuth クライアントが行った要求の数、または組織が行った特定の API 要求の数。
画像をクリックして拡大します。API 使用状況ビュー 要求列の割合 要求の割合

OAuth クライアントが行った要求の割合、または組織が行った特定の API 要求の数 (要求の合計数に関連する)。

画像をクリックして拡大します。API 使用状況ビュービジュアル表現列 視覚的表現 要求のパーセンテージを視覚的に表します。


クライアントまたはデータのフィルター処理要求をクリックすると、列数とパーセンテージ列の間に別の列が表示されます。この新しい列には、要求の合計数に関連するフィルターに一致する要求の割合が表示されます。選択した要求フィルタに一致する要求がない場合、ビューにはフィルタされたパーセンテージは表示されません。

フィルタを適用すると、他の列がフィルターに一致するように更新されます。

  • クライアントまたは API 要求の一覧は、クリックしたクライアントまたは API 要求を強調表示します。
  • フィルタに一致する要求の数を表示するために変更された要求の数。フィルタに一致する要求がない場合、数値は灰色になります。
  • 要求の合計に対する割合が灰色に変わります。
  • ビジュアル表現は、フィルタに一致する要求の割合と合計要求の割合の両方を示すために分割された実線バーからバーに変更されます。2 つのパーセンテージ間の違いは、バーの灰色の部分として表示されます。

説明

画像をクリックして拡大します。

API 使用状況ビュー フィルター処理された要求列

OAuth クライアントまたは API 要求 API 要求を行う特定の OAuth クライアント、または組織が行った特定の API 要求。クリックしてフィルター処理する行がビューでハイライト表示されます。
画像をクリックして拡大します。API 使用状況ビュー フィルター処理された要求数列 要求の数

OAuth クライアントが行った要求の数、または組織がフィルタに一致した特定の API 要求の数。選択したフィルタに一致する要求がない場合、その数は理由に一致する要求の合計数として残りますが、数値は淡色表示されます。

画像をクリックして拡大します。API 使用状況ビューフィルター処理されたパーセンテージ列 フィルター処理された要求の割合

クライアントまたはデータのフィルター処理要求をクリックすると、この列が表示され、フィルタ処理されたクライアントまたは要求に一致する要求の割合が表示されます。選択したフィルタに一致する要求がない場合、ビューにはフィルタされたパーセンテージは表示されません。

画像をクリックして拡大します。API 使用状況ビューフィルター処理された要求列の合計パーセンテージ 要求の割合 OAuth クライアントが行った要求の割合、または組織が行った特定の API 要求の数 (要求の合計数に関連する)。
画像をクリックして拡大します。API 使用状況ビューフィルター表示表示列 視覚的表現

フィルターに一致する要求の割合と合計要求の割合を視覚的に表します。2 つのパーセンテージ間の違いは、バーの灰色の部分として表示されます。


注意:一度に 1 つの OAuth クライアントまたは 1 つの API 要求でフィルタリングできます。別のクライアントまたは要求をクリックすると、フィルタはそのクライアントまたは要求に変わります。

ビューをカスタマイズする

特定のデータのみを表示するようにビューをカスタマイズします。 ビューのフィルターと日付の設定を保存します、クリック セーブ 。 


メモ: 現在の日のデータを表示できません。日付範囲には、現在の日付のデータが含めありません。

日付フィルターを使用して、 分析ビューをカスタマイズします。

使用フィルタにプリセットメトリクス日までに、またはカスタムの日付範囲を設定します。

フィルタにプリセットを使用するには、 メトリクス 、次の手順を実行します。

  1. 日付をクリックして、日付フィルターを表示します。
  2. [プリセット]リストで、プリセットの日付オプション選択します。

日付のプリセット

プリセット 説明
現在のインターバル

現在の30分間のデータを表示します。

注意:詳細ビューには間隔 データグリッドでは、現在のインターバル これらのビューにはプリセットは表示されません。

今日 現在のインターバルを含む期間のデータを表示します。
昨日 前日のデータを表示します。
今週 日曜日から土曜日までの期間のデータを表示します。
先週 前週の日曜日から土曜日までのデータを表示します。
過去 7 日間 過去 7 日間のデータを表示します。
今月 現在の月のデータを表示します。余分な日はありません。
今月の週ごと 日曜日に始まり土曜日に終わる現在の暦月のデータを表示します。月が日曜日に始まらないか土曜日に終わらない場合は、余分な日を含みます。
前月 前の暦月のデータを追加日なしで表示します。
過去30日間 過去30日間のデータを表示します。
過去3か月 過去3か月間のデータを表示します。
インターバル

30分間のデータを表示します。

注意:詳細ビューには間隔 データグリッドでは、間隔 これらのビューにはプリセットは表示されません。

曜日 1日24時間のデータを表示します。
日曜日から土曜日までの期間のデータを表示します。
追加日なしで正確な月のデータを表示します。現在の月が選択されている場合、現在の日付までのデータが表示されます。
週ごと 日曜日に始まり土曜日に終わる暦月のデータを表示します。月が日曜日に始まらないか土曜日に終わらない場合は、余分な日を含みます。

 

カスタムの日付範囲を使用してメトリクスをフィルタリングするには、次の手順を実行します。

  1. 日付をクリックして、日付フィルターを表示します。
  2. カレンダーで開始日と終了日を選択し、フィルター矢印をクリックします。
    日付ピッカーを適用する

 

同じ日付プリセットを使用して異なる期間のデータを表示するには、日付表示の両側にある矢印をクリックします。

たとえば、前日のデータを表示するには、をクリックします プリセットをクリックし、日付の左側にある矢印をクリックします。



特定のクライアントまたは API 要求によってデータをフィルター処理するには、その要求をクリックします。

一度に 1 つの OAuth クライアントまたは 1 つの API 要求でフィルタリングできます。別のクライアントまたは要求をクリックすると、フィルタはそのクライアントまたは要求に変わります。

フィルター処理時にビューがどのように変化するかの詳細については、 セクション列 この記事のセクション。