# コラボレーション体験のはじめに

{% hint style="info" %}
この製品の拡張にはCollaboration Experienceのライセンスが必要です。 Nexthinkの担当者に連絡して詳細情報を入手してください。
{% endhint %}

Collaboration Experienceは以下のような機能を通じて、通話品質の問題をより効率的に発見、診断、修正します:

* 組織、デバイス、通話レベルで問題を検出し、調査するのに役立つダッシュボード。
* Nexthink Libraryからインストールし、品質の低い通話を通知するアラートモニター。
* Applicationのパフォーマンスと通話品質を関連付けるためにApplicationモジュールにインポートできる構成。
* アプリケーションのクラッシュ、Microsoft TeamsやZoomの活動、周辺機器の使用状況を追加で収集するためのRemote Actions。

Collaboration Experienceは、Microsoft Teams Roomsを実行している個々のコンピュータやデバイスでの通話品質の問題のトラブルシューティングを支援します。

<figure><img src="/files/LgA5WgcCJBRCwE40izIm" alt="Collaboration tools dashboard and tabs."><figcaption></figcaption></figure>

## Collaboration Experienceを使用して通話品質の問題を検出し診断する <a href="#gettingstartedwithcollaborationexperience-detectinganddiagnosingcallqualityissues" id="gettingstartedwithcollaborationexperience-detectinganddiagnosingcallqualityissues"></a>

通話品質の問題を検出し診断するためにCollaboration Experienceを活用するために、さまざまなNexthinkの機能を利用してください。

* [Collaboration Tools](/platform/ja/user-guide/collaboration-experience/using-collaboration-tools.md)は組織全体の通話品質の問題を以下の方法で特定および相関させます：
  * TeamsとZoomのAPIからの**通話品質**データを統合。
  * **MS Teams Rooms**のパフォーマンス指標をモニター。
* [デバイスビュー](/platform/ja/user-guide/collaboration-experience/using-device-view-for-call-quality-issues.md)を使用することで、デバイスのアクティビティ、リソース消費、接続性、アプリケーションの使用状況を関連付けて、通話品質にアクセスできます。
* **Nexthink Library**モジュールは、設定をサポートするライブラリコンテンツを提供します：
  * Microsoft TeamsとZoomアプリケーションでのセッションの数を追跡する[アラートモニター](/platform/ja/user-guide/collaboration-experience/using-alerts-for-call-quality-issues.md)。
  * リモートアクションおよびカスタムフィールドがMicrosoft Teams Roomsデータ収集とストレージをサポートします。

## 通話品質データの調査とクエリ <a href="#gettingstartedwithcollaborationexperience-theinvestigationsmodule" id="gettingstartedwithcollaborationexperience-theinvestigationsmodule"></a>

[Investigations](/platform/ja/user-guide/investigations.md) を使用して `collaboration.sessions` テーブルを介してコラボレーションデータにアクセスし、[NQLデータモデル](/platform/ja/understanding-key-data-platform-concepts/nql-data-model.md) の下で利用します。

統一された`call.quality`メトリックを使用して、音声、ビデオ、画面共有の品質、および通話に影響を与える接続の問題など、複数の要因の組み合わせを基に通話全体の品質を評価します。

```
collaboration.sessions過去24時間
| 通話.品質=悪いのカウントを要約する
device.nameごとの貧弱な通話
| 貧弱な通話を降順に並び替え
```

### Collaboration Experienceはどのように通話品質を定義しますか？ <a href="#gettingstartedwithcollaborationexperience-definingthecallquality" id="gettingstartedwithcollaborationexperience-definingthecallquality"></a>

コラボレーションエクスペリエンスで使用される主要指標は、個々のコラボレーションセッションの通話品質を良好、悪い、または未分類（不明）に分類します。

これらの分類は、Microsoft TeamsまたはZoomから直接取得され、様々な要因に基づいています。

システムは次の論理を使用して`call.quality`を計算します:

* **良い品質**: 音声品質が良く、ビデオ品質が良い。
* **悪い品質**: 音声品質が悪い、またはビデオ品質が悪い。

システムは通話品質をいくつかの要素に分解し、各要素に特定の閾値を設けています。 閾値を超えると、通話の品質が影響を受けます。

| 測定                  | 単位      | 閾値      | 説明                                                                                                                               |
| ------------------- | ------- | ------- | -------------------------------------------------------------------------------------------------------------------------------- |
| ジッタ                 | ミリ秒     | 30ms未満  | ジッタはデータストリームのパケット遅延の変動の測定です。 これが高すぎると、音声が途切れる可能性があります。                                                                           |
| パケット損失              | パーセンテージ | 10%未満   | パケット損失は、データパケットが宛先に届かない場合に発生します。 損失されたパケットの割合は、送信されたパケットの総数に基づいています。                                                             |
| 往復時間                | ミリ秒     | 500ms未満 | 往復時間（RTT）は、単一のパケットがクライアントからリモートエンドポイントまで行き、クライアントに戻るのに要する時間です。 高いRTTは、ストリームの再生に遅延を引き起こす可能性があります。                                 |
| フレームレート（ビデオ通話のみ）    | フレーム毎秒  | 7未満     | 送信ビデオストリームの場合、フレームレート（FPS）はクライアントが送信する1秒あたりのビデオフレーム数です。 期待される値より低い場合、システムリソースの制約、不十分なネットワーク帯域幅、またはビデオキャプチャデバイスの故障が示唆される可能性があります。 |
| フレームロスパーセンテージ（画面共有） | パーセンテージ | 50%以上   | フレームロスパーセンテージは、画面共有中に失われたフレームの割合を示します。 誰かが画面を共有すると、フレーム（個々の画像）がネットワークを介して送信されます。 フレームが失われたり遅れたりすると、視聴体験に影響を与えます。                 |

### Microsoft Teams の通話データは時間の経過とともにどのように更新されますか？

Microsoft は、通話終了直後に Teams の通話品質データを最初に公開し、その後、時間の経過とともに初期データセットを補完または更新します。

Nexthink は、通話終了後最大 48 時間にわたり、初期データと後続の更新データの両方を処理します。 空のフィールドは後から埋められる場合があり、既存の値が変更される場合もあります。 その結果、通話品質評価は通話終了後に変わる可能性があり、最初は悪いと評価された通話が後に良いと評価される、またはその逆の場合もあります。

#### 通話品質データ更新で想定されること

Microsoft による段階的な通話品質データ公開アプローチは、プラットフォームの他の部分にさまざまな影響を与えます。

* [Investigations](/platform/ja/user-guide/investigations.md)、[Live Dashboards](/platform/ja/user-guide/live-dashboards.md)、および [Workspace](/platform/ja/user-guide/search-and-workspace/using-workspace.md) のデータは、通話終了後最大 48 時間にわたり変更される可能性があります。
* アラートは、その後重要でない値に更新されるデータに基づいてトリガーされる場合があります。
* DEX スコアは、通話記録が後から更新された場合でも、初期の通話品質評価に依存します。
* データエクスポートは、エクスポート時点で利用可能な最新の通話データを反映します。
* カスタムトレンドは、1 日に 1 回、利用可能な最新データを保存し、その後データが変更されても遡及的には更新されません。

#### NQL を使用した通話品質データ更新の追跡

`collaboration.sessions` テーブルの `last_update` フィールドは、特定のセッションの通話データがシステムによって最後に更新された時刻を示します。 このフィールドは、初期の通話データが受信されたときに最初に設定され、その通話に対して新しいデータが取り込まれるたびに更新されます。

通話記録が更新されると、`last_update` の値は参加しているすべてのセッションで更新されます。 これにより、セッションのデータが最後に変更されたタイミングを特定できます。

このフィールドは、データの精度や更新タイミングの把握が重要となるさまざまなシナリオで利用できます。

たとえば、通話品質の低下によりアラートがトリガーされたものの、後でデータを確認すると値が正常に見える場合があります。 もし `last_update` のタイムスタンプがアラート時刻より新しい場合、アラートは後に重要でない値へ更新された、より早いバージョンのデータによってトリガーされた可能性があります。

`collaboration.sessions` テーブルを使用した**クエリ例**

```
collaboration.sessions during past 7d | list session.call.start_time, session.call.end_time, session.call.id, last_update
```

### 通話とセッションの違いは何ですか？ <a href="#gettingstartedwithcollaborationexperience-callsvssessions" id="gettingstartedwithcollaborationexperience-callsvssessions"></a>

通話の各参加者には、別々のコラボレーションセッションIDがあります。 通話には常に 1 つの通話 ID があり、少なくとも 2 つのセッションで構成されます。

Microsoft TeamsとZoomは、コラボレーションセッションレベルで通話品質を決定します。 その結果、通話品質に関するすべてのメトリックは、セッションIDに基づくコラボレーションを計算します。

これらの2つの測定に関するNQL参照は以下の通りです:

* コラボレーションセッション: `collaboration.sesssions.id`
* 通話: `collaboration.sessions.call.id`

## Collaboration Experienceの権限を付与する <a href="#gettingstartedwithremoteactions-whatarethepermissionsrequiredtouseremoteactions" id="gettingstartedwithremoteactions-whatarethepermissionsrequiredtouseremoteactions"></a>

{% hint style="warning" %}
ユーザー権限を付与する前に、管理者として[Collaboration Experienceを設定](/platform/ja/user-guide/collaboration-experience/configuring-collaboration-experience.md)する必要があります。
{% endhint %}

管理者としてCollaboration Experienceの適切な権限を有効にするには:

1. メインナビゲーションパネルから **管理 >** [役割](https://github.com/nexthink/documentation.online-product-documentation/blob/develop/ja_docs/configuring_nexthink/configuring-your-platform/administration/account-management/roles/README.md) を選択します。
2. **新しいロールを作成**するか、既存のロールを編集するには、その上にカーソルを合わせます。
3. **権限**セクションで、ロールに適切な権限を有効にするために**コラボレーションツール**のセクションまでスクロールします。

### ドメインの影響をコラボレーションツールの権限で確認 <a href="#amplify-dataprivacysettingsforamplify" id="amplify-dataprivacysettingsforamplify"></a>

{% hint style="info" %}
[役割](https://github.com/nexthink/documentation.online-product-documentation/blob/develop/ja_docs/configuring_nexthink/configuring-your-platform/administration/account-management/roles/README.md) のドキュメントを参照して、**権限**、**ビュー ドメイン** オプション、[データ プライバシー](https://github.com/nexthink/documentation.online-product-documentation/blob/develop/ja_docs/configuring_nexthink/configuring-your-platform/administration/account-management/roles/README.md#roles-dataprivacy) 細分設定の詳細な説明をご覧ください。
{% endhint %}

必要な権限が有効になっている場合、完全アクセスと限定アクセスを持つユーザーが行える内容を以下の表で示します。

***

関連トピック:

* [通話品質問題のアラートを使用する](/platform/ja/user-guide/collaboration-experience/using-alerts-for-call-quality-issues.md)
* [Collaboration Toolsの使用](/platform/ja/user-guide/collaboration-experience/using-collaboration-tools/using-collaboration-tools.md)
* [通話品質問題のデバイスビューの使用](/platform/ja/user-guide/collaboration-experience/using-device-view-for-call-quality-issues.md)
* [Collaboration Experienceの設定](/platform/ja/user-guide/collaboration-experience/configuring-collaboration-experience.md)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.nexthink.com/platform/ja/user-guide/collaboration-experience/getting-started-with-collaboration-experience.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
