マイクロソフト チームズ
Citrix DirectorのMicrosoft Teamsダッシュボードは、ユーザー全体のMicrosoft Teams通話の可視性を提供し、参加者の詳細や通話パフォーマンスを示すメトリックも表示します。このダッシュボードでは、次のことが可能です。
-
Microsoft Teamsの使用状況の概要を評価する
-
選択した期間のMicrosoft Teams通話をフィルタリングして詳細を表示する
-
パフォーマンスメトリックを使用して個々の通話を評価する
Microsoft Teamsダッシュボード(/en-us/citrix-virtual-apps-desktops/2607-ltsr/media/ms-teams-dashboard.png)
前提条件
Citrix Directorの許可リストにMicrosoft Graphアプリケーションプログラミングインターフェイス (API) を追加します。
-
Directorが通話記録にアクセスできるようにするには、Directorがインストールされているすべてのマシンでアウトバウンドインターネットアクセスが利用可能であることを確認してください。具体的には、
<https://graph.microsoft.com>URLにアクセスできることを確認してください。 -
プロキシサーバーを使用している場合は、Microsoft Graph API :
<https://graph.microsoft.com>URLにアクセスできることを確認してください。
はじめに
Microsoft Graph APIへの接続
Microsoftの通話詳細はMicrosoft Graph APIから取得されます。Citrix DirectorがAPIにアクセスするには、必要な権限を持つアプリをMicrosoft Entra IDで作成する必要があります。Graph APIのURLもDirectorの許可リストに追加する必要があります。
接続を完了するには、次の手順を実行します。
ステップ1：Microsoft Entra IDでのアプリケーション登録
ステップ2：Microsoft Entra IDでMicrosoft Graphのアクセス許可を追加する
-
API のアクセス許可 -> アクセス許可の追加 に移動します。
-
Microsoft Graph を選択し、次に アプリケーションのアクセス許可 を選択します。マイクロソフト グラフ(/en-us/citrix-virtual-apps-desktops/2607-ltsr/media/microsoft-graph.png)
-
CallRecords.Read.All と User.Read.All へのアクセス許可を追加します。Microsoft Graph のアクセス許可(/en-us/citrix-virtual-apps-desktops/2607-ltsr/media/add-permissions.png)
-
MSFT の管理者の同意を付与 をクリックします。この操作には、Entra ID のグローバル管理者が必要です。管理者の同意を付与(/en-us/citrix-virtual-apps-desktops/2607-ltsr/media/grant-admin-consent.png)
ステップ3：クライアントシークレットの作成
-
Microsoft Entra ID で、証明書とシークレット -> クライアント シークレット -> 新しいクライアント シークレット に移動します。既存のシークレットを再利用することもできます。新しいクライアントシークレット(/en-us/citrix-virtual-apps-desktops/2607-ltsr/media/new-client-secret.png)
-
シークレットの名前と有効期限を指定します。接続を維持するために、有効期限が切れる前にシークレットが更新されていることを確認してください。
-
Director UI で使用するためにクライアントシークレットをコピーします。
問題が発生した場合は、詳細について公式のAzure ドキュメントを参照してください。
ステップ4：Director で接続を完了する
-
Director で、設定 -> リアルタイム通信アプリを接続 に移動します。設定(/en-us/citrix-virtual-apps-desktops/2607-ltsr/media/real-time-settings.png)
-
接続の作成 をクリックし、アプリ登録からコピーしたアプリケーションID、ディレクトリID、およびクライアントシークレットを入力します。接続の作成(/en-us/citrix-virtual-apps-desktops/2607-ltsr/media/real-create-a-connection.png)有効な資格情報と通話の詳細を取得するための権限が利用可能な場合、接続は正常に確立されます。詳細の取得(/en-us/citrix-virtual-apps-desktops/2607-ltsr/media/fetch-details.png)
-
行の末尾にある省略記号をクリックすると、接続を編集および削除できます。
Microsoft Teams ダッシュボード
Director UI の リアルタイム通信 タブに移動します。Microsoft Teams ダッシュボードには、確立された Microsoft Graph 接続から収集されたデータが入力されます。通話の詳細は、通話終了後約15分で利用可能になります。
通話履歴(/en-us/citrix-virtual-apps-desktops/2607-ltsr/media/call-history.png)
テーブルビューには、すべての通話に関する以下の詳細が表示されます。
| 列名 | 説明 |
|---|---|
| 通話ID | 各通話の一意の識別子。 |
| 通話タイプ | 通話がピアツーピアかグループ通話かを示します。 |
| モダリティ | 通話中に使用されるモード（オーディオ、ビデオ、画面共有など）を示します。 |
| 開始時刻 | 通話が開始された日時。 |
| 終了時刻 | 通話が終了した日時。 |
| 期間 (mm: ss) | 通話の分数と秒数での期間。 |
テーブル内の個々の通話をクリックすると、ユーザーごとの障害およびパフォーマンスの詳細が表示されます。
個々の通話(/en-us/citrix-virtual-apps-desktops/2607-ltsr/media/individual-calls.png)
グループ通話で、ユーザーが切断して再参加した場合、それは別のセッションと見なされます。この考慮事項は、特定のネットワークに接続した際の高い遅延など、特定の問題を特定するのに役立ちます。
通話詳細テーブルの各行には、次の情報が含まれています。
| 列名 | 説明 |
|---|---|
| 開始時刻 | 通話または参加者のセグメントが開始された日時。 |
| ラウンドトリップ時間 (平均) | データパケットの平均往復時間。 |
| パケット損失率（平均） | 通話中に失われたパケットの平均割合。 |
| ジッター（平均） | 受信パケットの遅延の平均変動。 |
| 失敗ステージ | セットアップ中や通話中など、通話の失敗が発生したステージを示します。 |
| 終了時刻 | 通話または参加者のセグメントが終了した日時。 |
| 発信者 | 通話の参加者の名前。 |
| 帯域幅の見積もり（平均） | 通話中に使用された推定平均帯域幅。 |
ユーザーは、Citrixユーザー名またはMicrosoft Teamsユーザー名の2つの方法でフィルタリングできます。これらのオプションは、ページ上部のラジオボタンを使用して切り替えることができます。
-
Citrixユーザー名: ユーザー名の入力を開始すると、システムは一致するユーザーを提案します。その後、詳細を表示する特定のアカウントを選択できます。
-
Microsoft Teamsユーザー名: Microsoft Teamsアカウントに関連付けられているメールアドレスまたはユーザープリンシパル名（UPN）がCitrixアカウントIDと異なる場合は、このオプションを使用します。この方法を使用する場合、完全で有効なメールアドレスを入力する必要があります。
トラブルシューティング
-
「Azure API がブロックされました。接続を作成するには、Azure API を許可リストに追加してください」というエラーでオンボーディングが失敗したのはなぜですか？
解決策: 前提条件に従い、Microsoft Graph API エンドポイントを許可リストに追加していることを確認してください。 -
通話を表示すると、「Microsoft Graph API がブロックされました」というエラーが表示されるのはなぜですか？
解決策: 前提条件に従い、Microsoft Graph API エンドポイントを許可リストに追加していることを確認してください。 -
接続画面に「Microsoft Entra ID で必要なアプリケーション権限がありません」と表示されるのはなぜですか？
解決策: アプリケーション権限 CallRecords.Read.All と User.Read.All が Entra ID アプリケーションに割り当てられていることを確認してください。