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