Microsoft Teams
-
Citrix Director の Microsoft Teams ダッシュボードは、ユーザー全体の Microsoft Teams 通話に関する可視性を提供し、参加者の詳細や通話パフォーマンスを示すメトリックも表示します。このダッシュボードには、以下の機能があります。
- Microsoft Teams の利用状況の概要を評価
- 選択した期間の Microsoft Teams 通話の詳細をフィルタリングして表示
-
パフォーマンスメトリックを使用して個々の通話を評価
前提条件
Citrix Director の許可リストに Microsoft Graph Application Programming Interface (API) を追加します。
- Director が通話記録にアクセスできるように、Director がインストールされているすべてのマシンでアウトバウンドインターネットアクセスが利用可能であることを確認します。特に、https://graph.microsoft.com URL にアクセスできることを確認
- プロキシサーバーを使用している場合は、Microsoft Graph API の URL (https://graph.microsoft.com) にアクセスできることを確認
はじめに
Microsoft Graph API への接続
Microsoft の通話詳細は Microsoft Graph API から取得されます。Citrix Director が API にアクセスするには、必要な権限を持つアプリを Microsoft Entra ID で作成する必要があります。Graph API の URL も Director の許可リストに追加する必要があります。
接続を完了するには、以下の手順を実行します。
ステップ 1: Microsoft Entra ID でのアプリケーション登録
-
Microsoft Entra ID で、[App registrations] -> [New registration] の順に移動
- アプリ登録に必要な手順を実行
- 登録後、アプリケーションのクライアント ID とテナント ID をコピー
ステップ 2: Microsoft Entra ID での Microsoft Graph 権限の追加
- [API permissions] -> [Add a permission] の順に移動
-
[Microsoft Graph] を選択し、次に [Application permissions] を選択
-
CallRecords.Read.All および User.Read.All に権限を追加
-
[Grant admin consent for MSFT] をクリックします。この操作には Entra ID グローバル管理者が必要
ステップ 3: クライアントシークレットの作成
-
Microsoft Entra ID で、[Certificates & secrets] -> [Client secrets] -> [New client secret] の順に移動します。既存のシークレットを再利用することも可能
- シークレットの名前と有効期限を指定します。接続を維持するために、有効期限が切れる前にシークレットを更新することを確実にする
- Director UI で使用するためにクライアントシークレットをコピー
問題が発生した場合は、公式の Azure ドキュメント を参照してください。
ステップ 4: Director での接続の完了
-
Director で、[Settings] -> [Connect real-time communications apps] の順に移動
-
[Create connection] をクリックし、アプリ登録からコピーしたアプリケーション ID、ディレクトリ ID、およびクライアントシークレットを入力
-
有効な資格情報と通話詳細を取得するための権限が利用可能な場合、接続は正常に確立されます。
-
- 行の末尾にある省略記号をクリックして、接続を編集および削除
Microsoft Teams ダッシュボード
- Director UI の [Real time Communications] タブに移動します。Microsoft Teams ダッシュボードには、確立された Microsoft Graph 接続から収集されたデータが入力されます。通話詳細は、通話終了後約 15 分で利用可能になります。
テーブルビューには、すべての通話に関する以下の詳細が表示されます。
| 列名 | 説明 |
|---|---|
| 通話 ID | 各通話の一意の識別子。 |
| 通話タイプ | 通話がピアツーピアかグループ通話かを示します。 |
| モダリティ | 通話中に使用されるモード (オーディオ、ビデオ、画面共有など) を示します。 |
| 開始時刻 | 通話が開始された日付と時刻。 |
| 終了時刻 | 通話が終了した日付と時刻。 |
| 期間 (mm: ss) | 通話の分数と秒数での期間。 |
テーブル内の個々の通話をクリックすると、ユーザーごとの障害およびパフォーマンスの詳細が表示されます。
グループ通話では、ユーザーが切断して再参加した場合、それは別のセッションとして扱われます。この考慮事項は、特定のネットワークに接続した際の高い遅延など、特定の問題を特定するのに役立ちます。
通話詳細テーブルの各行には、以下の情報が含まれています。
| 列名 | 説明 |
|---|---|
| 開始時刻 | 通話または参加者のセグメントが開始された日付と時刻。 |
| ラウンドトリップ時間 (平均) | データパケットの平均ラウンドトリップ時間。 |
| パケット損失率 (平均) | 通話中に失われたパケットの平均割合。 |
| ジッター (平均) | 受信パケットの遅延の平均変動。 |
| 障害ステージ | セットアップ中や通話中など、通話障害が発生したステージを示します。 |
| 終了時刻 | 通話または参加者のセグメントが終了した日付と時刻。 |
| 発信者 | 通話の参加者の名前。 |
| 帯域幅推定 (平均) | 通話中に使用された推定平均帯域幅。 |
ユーザーは、Citrix ユーザー名または Microsoft Teams ユーザー名の 2 つの方法でフィルタリングできます。ページ上部のラジオボタンを使用して、これらのオプションを切り替えることができます。
- Citrix ユーザー名: ユーザー名の入力を開始すると、システムが一致するユーザーを提案します。その後、詳細を表示するために特定のユーザーを選択可能
- Microsoft Teams ユーザー名: Microsoft Teams アカウントに関連付けられているメールアドレスまたはユーザープリンシパル名 (UPN) が Citrix アカウント ID と異なる場合に、このオプションを使用します。この方法を使用する場合、完全で有効なメールアドレスを入力する必要がある
トラブルシューティング
-
「Azure API blocked. To create a connection, add Azure API to your allow list」というエラーでオンボーディングが失敗したのはなぜですか
解決策: 前提条件に従い、Microsoft Graph API エンドポイントを許可リストに追加していることを確認してください。
-
通話を表示する際に「Microsoft Graph API blocked」というエラーが表示されるのはなぜですか
解決策: 前提条件に従い、Microsoft Graph API エンドポイントを許可リストに追加していることを確認してください。
-
接続画面に「Missing required application permissions in Microsoft Entra ID」と表示されるのはなぜですか
解決策: アプリケーション権限 CallRecords.Read.All および User.Read.All が Entra ID アプリケーションに割り当てられていることを確認してください。