API 監査

重要:

この機能は、現在プレビューとして利用可能です。

このタブには、過去 30 日間に GetAll - Jobs エンドポイントと QueueItems エンドポイントに対して行われた呼び出しの数が表示されます。また、特定の日にドリルダウンするオプションを利用できます。

The graphs display a green bar if our 100 requests/minute/tenant rate limit is observed, and an orange bar if it is exceeded.

Each graph includes a View API button which directs you to the corresponding Swagger endpoint.

This requires the Audit - View permission.

重要:

• カウントは、最初の 10 個の API 呼び出しの後に開始されます。
• データは最大 20 分遅れで表示されます。
• 一部の内部呼び出しがグラフに含まれる場合がありますが、レート制限にはカウントされません。ただし、制限を超える内部呼び出しが表示される場合がありますが、ステータス コードは成功になります。
• グラフの時間は UTC で表されます。

スパイクの詳細

You can view spike details for each minute logged in the API audit panel.

これを行うには、目的の分に対応するスパイクを選択します。サイド パネルが開き、リクエストが最も多い最大 100 件の結果がリストされ、プロセス、プロセスが存在するフォルダー、ホスト名、選択した分の間にそのエンドポイントに対して実行された呼び出しの数、ステータス コード、およびユーザー エージェントなどの情報が表示されます。

API 呼び出しが外部ソースから行われた場合、またはプロセスに関する詳細が十分でない場合は、対応する列に [N/A] が表示されます。

選択したスパイクの詳細のサイド パネルで実行できるアクションは次のとおりです。

• 右上隅の展開ボタンをクリックして、パネルをフルサイズのウィンドウで開く。
• プロセスに対応する目のアイコンをクリックして、関連付けられたジョブの詳細を表示する。
  注:

  This option is not available if you do not have view permissions for the folder where the process is configured.

重要:

リクエストの数は、リクエストが行われた瞬間から正確な秒までカウントされます。ただし、わかりやすくするため、グラフには秒単位ではなく分単位で増分が表示されます。

つまり、次のようなシナリオが考えられます。

• 午後 1:10:30 から午後 1:10:59:99 の間に 50 件のリクエストを行います。
• その後、午後 1:11:00 から午後 1:11:30 の間にさらに 60 件のリクエストを行います。

各分に対応するグラフの棒は緑色になりますが、実際には、追加の 10 件のリクエストはレート制限されます。

API 監査データをエクスポートする

You can export the last 7 days' worth of API audit data using the Export report button, which features two options: QueueItems and Jobs. The resulting report is named for the option you choose.

The exported report is automatically downloaded in the background, to your browser's default download location. It is also available on the My reports page, allowing you to download it at your own convenience, within 7 days of when it was generated.

注:

• フォルダーの権限がない場合は、レポート内の対応するアイテムに NO_ACCESS のマークが付きます。
• API 呼び出しが外部ソースから行われた場合、またはプロセスに関する詳細が十分でない場合は、対応する列に [N/A] が表示されます。