次の方法で共有

通話自動化メトリックの概要

  • [アーティクル]

現在、Azure Communication Services では、すべての Communication Services プリミティブのメトリックが提供されています。

メトリックを確認できる場所

Communication Services のプリミティブは、API 要求とコールバック イベントのメトリックを出力します。 これらのメトリックを見つけるには、Communication Services リソースの メトリック タブを参照してください。 Communication Services リソースのブック タブを使って永続的なダッシュボードを作成することもできます。

測定基準の定義

Call Automation は、アクション イベント ドリブン プログラミング モデルの非同期操作に対して動作します。 API 要求は、要求が受け入れられたかどうかを示す即時応答になります。 その後、指定したコールバック URI に Webhook イベントが発行されます。 これらの Webhook イベントは、要求が処理された後にトリガーされ、アクションの結果に関する情報を格納しています。 たとえば、AddParticipant API は最初の応答を返し、後で AddParticipantSucceeded イベントまたは AddParticipantFailed イベントをトリガーします。

Call Automation は、API 要求/応答と、対応する Webhook イベントの両方のメトリックを発行し、開発者が API の正常性を監視したり、失敗シナリオのアラートを構成できるようにします。

このドキュメントでは、メトリック データのフィルター処理に使用できる 2 つのメトリックとさまざまなディメンションについて説明します。 これらのディメンションは、 Count 集計の種類を使用してまとめて集計できます。 これらは、Sum、Average、Min、Max など、すべての標準的な Azure 集計時系列をサポートします。

サポートされる集計の種類と時系列集計の詳細については、「Azure メトリックス エクスプローラーの高度な機能」を参照してください。

Call Automation API 要求

API 要求メトリックは、一般公開されているすべての操作に対して発行されます。 このメトリックには、メトリック データをフィルター処理するために使用できる 3 つのディメンションが含まれています。

  • 操作 - Call Automation で呼び出すことができるあらゆる操作またはルート。
  • 状態コード - この要求に対して送信された状態コードの応答。
  • StatusSubClass: 状態コード シリーズ。

Call Automation のコールバック イベント

このメトリックが対象とするすべてのコールバック イベントの種類の一覧を参照してください。

メトリックは、次のディメンションでフィルター処理できます。

  • EventTypeName: コールバック イベントの種類の名前。
  • Code: コールバック イベントの状態コード。
  • CodeClass: コールバック イベントの状態コード シリーズ。
  • SubCode: コールバック イベントのサブ コード。
  • バージョン: コールバック イベントのバージョン。

Code と SubCode の値は、メトリックと、コールバック URI に発行されたコールバック イベントで公開されます。 これらの値を使用して、イベントの理由 (呼び出しが切断されたなど) を特定できます。 公開されているコードとその意味の詳細については、トラブルシューティング ガイドを参照してください。

次のステップ

データ プラットフォームのメトリックの詳細を確認します。