マイクロソフト チームズ
Citrix Director の Microsoft Teams ダッシュボードは、ユーザー全体の Microsoft Teams 通話の可視性を提供し、参加者の詳細や通話パフォーマンスを示すメトリックも表示します。このダッシュボードには、次の機能があります。
- Microsoft Teams の使用状況の概要を評価する
- 選択した期間の Microsoft Teams 通話をフィルタリングして詳細を表示する
- パフォーマンスメトリックを使用して個々の通話を評価する
前提条件
Citrix Director の許可リストに、Microsoft Graph アプリケーションプログラミングインターフェイス (API) を追加します。
- Director が通話記録にアクセスできるように、Director がインストールされているすべてのマシンでアウトバウンドインターネットアクセスが利用可能であることを確認してください。特に、https://graph.microsoft.com URL にアクセスできることを確認してください。
- プロキシサーバーを使用している場合は、Microsoft Graph API : https://graph.microsoft.com URL にアクセスできることを確認してください。
はじめに
Microsoft Graph アプリケーションプログラミングインターフェイスへの接続
Microsoft の通話詳細は、Microsoft Graph API から取得されます。Citrix Director が API にアクセスするには、必要な権限を持つアプリを Microsoft Entra ID で作成する必要があります。Graph API の URL も Director の許可リストに追加する必要があります。
接続を完了するには、次の手順を実行します。
ステップ 1: Microsoft Entra ID でのアプリケーション登録
-
Microsoft Entra IDで、アプリの登録 -> 新規登録に移動します。
新規登録(/ja-jp/citrix-virtual-apps-desktops/2507-ltsr/media/new-registration.png)
- アプリの登録に必要な手順を実行します。
- 登録後、アプリケーションのクライアントIDとテナントIDをコピーします。
ステップ2: マイクロソフト エントラ ID でのマイクロソフト グラフ アクセス許可の追加
- APIのアクセス許可 -> アクセス許可の追加に移動します。
-
Microsoft Graphを選択し、次にアプリケーションのアクセス許可を選択します。
マイクロソフト グラフ(/ja-jp/citrix-virtual-apps-desktops/2507-ltsr/media/microsoft-graph.png)
-
CallRecords.Read.All と User.Read.All の両方に対して、アクセス許可を追加してください。
-
MSFTの管理者の同意を付与をクリックします。この操作には、Entra IDのグローバル管理者が必要です。
管理者の同意を付与(/ja-jp/citrix-virtual-apps-desktops/2507-ltsr/media/grant-admin-consent.png)
ステップ3: クライアントシークレットの作成
-
Microsoft Entra IDで、証明書とシークレット -> クライアントシークレット -> 新しいクライアントシークレットに移動します。既存のシークレットを再利用することもできます。
新しいクライアントシークレット(/ja-jp/citrix-virtual-apps-desktops/2507-ltsr/media/new-client-secret.png)
- シークレットの名前と有効期限を指定します。接続を維持するために、有効期限が切れる前にシークレットが更新されていることを確認してください。
- Director UI で使用するためにクライアントシークレットをコピーします。
問題が発生した場合は、公式のAzure ドキュメントを参照してください。
ステップ 4: Director で接続を完了する
-
Director で、設定 -> リアルタイム通信アプリを接続に移動します。
-
接続の作成をクリックし、アプリ登録からコピーしたアプリケーション ID、ディレクトリ ID、およびクライアントシークレットを入力します。
有効な資格情報と通話の詳細を取得するための権限が利用可能であれば、接続は正常に確立されます。
-
行の末尾にある省略記号をクリックすると、接続を編集および削除できます。
マイクロソフト Teams ダッシュボード
Director UI のリアルタイム通信タブに移動します。Microsoft Teams ダッシュボードには、確立された Microsoft Graph 接続から収集されたデータが入力されます。通話の詳細は、通話終了後約 15 分で利用可能になります。
テーブルビューには、すべての通話に関する以下の詳細が表示されます。
| カラム名 | 説明内容 |
|---|---|
| 通話ID | 各通話の一意の識別子。 |
| 通話タイプ | 通話がピアツーピアかグループ通話かを示します。 |
| モダリティ | 通話中に使用されるモード（オーディオ、ビデオ、画面共有など）を示します。 |
| 開始時刻 | 通話が開始された日時。 |
| 終了時刻 | 通話が終了した日時。 |
| 継続時間 (mm: ss) | 通話の継続時間（分と秒）。 |
テーブル内の個々の通話をクリックすると、ユーザーごとの障害とパフォーマンスの詳細が表示されます。
個別通話(/ja-jp/citrix-virtual-apps-desktops/2507-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 アプリケーションに割り当てられていることを確認してください。