# ライブダッシュボードの使用

このページでは、ライブダッシュボードの主要なコンポーネント、そのアプリケーションと使用法を説明します。

{% hint style="info" %}
ユーザーとして、他のユーザーが作成した**共有**ダッシュボードへのアクセスまたは編集の可否は、以下に依存します。

* あなたのLiveダッシュボードに対する[ユーザー役割](https://github.com/nexthink/documentation.online-product-documentation/blob/develop/ja_docs/configuring_nexthink/configuring-your-platform/administration/account-management/roles/README.md#roles-livedashboards)のパーミッション。
* 特定の共有ダッシュボードに対するあなたの**閲覧**または**編集**権限。

ユーザーアクセスとアクションをマッピングするには、以下の組み合わせの権限に基づいて[ライブダッシュボードの管理](https://docs.nexthink.com/platform/ja/user-guide/managing-live-dashboards#managinglivedashboards-sharingdashboardssharing)のドキュメントを参照してください。
{% endhint %}

## 期間と時間の粒度を設定する <a href="#usinglivedashboards-settingupthetimeframeandtimegranularity" id="usinglivedashboards-settingupthetimeframeandtimegranularity"></a>

ダッシュボードページの右上にある期間選択ツールを使用して、すべてのダッシュボードウィジェットに適用される期間を設定します（対応するNQLクエリを更新）。

**最後の1時間**から**昨年**までの事前定義された期間のいずれかを使用するか、カスタム期間を選択します。 カスタム期間では、最大395日まで遡り最大期間を選択できます。

選択した期間に応じて、パターンを特定し、問題をトラブルシューティングするために、時間の粒度を**15分単位**、**1時間単位**、**1日単位**、**1週間単位**、**1ヶ月単位**に設定できます。 時間の粒度の変更は、ラインチャートのみに更新を適用します。

{% hint style="info" %}
時間枠選択ツールがダッシュボードのNQLクエリにどのように実装されているかについての詳細は、[時間枠選択ツール](https://docs.nexthink.com/platform/ja/user-guide/live-dashboards/widget-types/timeframe-picker)のドキュメントを参照してください。
{% endhint %}

<figure><img src="https://3549141153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeLm8O7QKZDn6z806e7Sv%2Fuploads%2Fgit-blob-640384d565eee1b2e8b05560b419545784203a63%2Ftimeframe_picker.png?alt=media" alt=""><figcaption></figcaption></figure>

## ダッシュボードのフィルタリング <a href="#usinglivedashboards-filteringdashboards" id="usinglivedashboards-filteringdashboards"></a>

フィルタはダッシュボードページの上部に表示され、プラットフォーム、デバイス、ロケーション、ハードウェア、その他設定されたパラメータでダッシュボードをフィルタリングできます。

[ライブダッシュボードの管理](https://docs.nexthink.com/platform/ja/user-guide/live-dashboards/managing-live-dashboards)により、フィルタを追加、管理、カスタマイズする方法についてのドキュメントを参照してください。

{% hint style="info" %}
ダッシュボードのNQLクエリにフィルタを実装する方法についての詳細は、[フィルタウィジェット](https://docs.nexthink.com/platform/ja/user-guide/live-dashboards/widget-types/filter-widget)のドキュメントを参照してください。
{% endhint %}

<figure><img src="https://3549141153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeLm8O7QKZDn6z806e7Sv%2Fuploads%2Fgit-blob-ac1eb3ecb7276078166f34c187003a66067b6be1%2Ffiltering_dashboard.png?alt=media" alt=""><figcaption></figcaption></figure>

バー チャートの要素をクリックすると、ページにフィルターが適用されます。 この操作は、プロパティに条件を設定してターゲット オブジェクトをフィルタリングすることで範囲を定義します。

## ダッシュボードウィジェットの使用 <a href="#usinglivedashboards-usingdashboardwidgets" id="usinglivedashboards-usingdashboardwidgets"></a>

{% hint style="info" %}
ユーザー権限に基づいてウィジェットを追加、管理、およびカスタマイズするには、[ライブダッシュボードの管理](https://docs.nexthink.com/platform/ja/user-guide/managing-live-dashboards#managinglivedashboards-editingdashboardcontenteditmode)のドキュメントを参照してください。
{% endhint %}

ダッシュボードウィジェット内の任意の項目や値を右クリックして、選択可能なオプションにアクセスします。 利用可能なオプションは、ウィジェットの種類および選択された項目のデータタイプに依存します。

* **調査を表示**は、ウィジェットの元のNQLにダッシュボードに適用されたフィルタ、期間、および粒度を含めて調査ページを開きます。
* **ドリルダウン**は、NQLクエリの結果から次のいずれかの代替案をリストする調査ページを開きます。

  * 元のクエリのルートテーブル、たとえば `execution.crashes`。
  * 関連するオブジェクトテーブル、たとえば `binaries`や`devices`。

  ドリルダウンのNQLクエリは、元のクエリのコンテキストを保持します。
* **コピー** はウィジェット上に表示されているフォーマット済みの値を単位と共にコピーします。例： `1m 26s`、`306 GB`、または `32.5%`。
* **生の値をコピー**すると、例えば次のような完全な基礎値をコピーします。
  * `1m 26s` は `86.42345139288133`（合計秒数）としてコピーされます。
  * `306GB` は `328676378256`（バイト）としてコピーされます。
  * `32.5%` は `0.325057090224`（小数形式）としてコピーされます。
* ユーザー、デバイス、バイナリなどのインベントリオブジェクトの場合：
  * ケースに応じて、**デバイスビューを開く**、**ユーザーの概要を開く**。
  * **Alerts and Diagnostics**モジュールからダッシュボードを使用して問題を診断します。
  * デバイスまたはバイナリのコンテキストで、すべての事前入力された調査クエリを取得します。

{% hint style="info" %}
テーブル型ウィジェットでバイナリ名にカーソルを合わせることで、[バイナリのコンテキスト記述](https://docs.nexthink.com/platform/ja/user-guide/widget-types/table#table-tablespecificfields)を直接取得できます。
{% endhint %}

<figure><img src="https://3549141153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeLm8O7QKZDn6z806e7Sv%2Fuploads%2Fgit-blob-4d42f4efbdef398923ab4bf2cc624d007ca33ec0%2FAction%20menus.jpg?alt=media" alt="Opening Device View from a dashboard widget value."><figcaption></figcaption></figure>

以下の例では、ダッシュボード ページから行われた変更で対応する調査クエリがどのように更新されるかを説明しています。

<details>

<summary>ダッシュボードからの調査の表示例</summary>

**調査を表示**は、過去1日のクラッシュしたデバイス数を示すKPIダッシュボードウィジェットです。

KPIの元のNQLは以下の通りです。

```
devices
| with execution.crashes during past 1d
| summarize devices = count()
```

ダッシュボードに次のフィルタを適用します。

* 期間選択ツールから**最後の1時間**。
* OSフィルタから**Mac**。

調査ページは、変更されたNQLクエリを使用して結果を表示します。

```
devices during past 60min 
| where device.operating_system.platform == macOS 
| with execution.crashes during past 60min 
| where device.operating_system.platform == macOS 
| summarize devices = count()
```

調査ページにおける変更されたクエリには次の点が含まれます。

* フィルタ変更 `|where device.operating_system.platform == macOS`
* 期間選択ツールの変更 `during past 60min`

</details>

<details>

<summary>ダッシュボードからの調査へのドリルダウン例</summary>

**ドリルダウン**は、過去1日のクラッシュしたデバイス数を示すKPIダッシュボードウィジェットです。

KPIの元のNQLは以下の通りです。

```
devices
| with execution.crashes during past 1d
| summarize devices = count()
```

ダッシュボードに次のフィルタを適用します。

* 期間選択ツールから**最後の1時間**
* OSフィルタから**Mac**

調査ページは、変更されたNQLクエリを使用して結果を表示します。

```
devices during past 60min 
| where device.operating_system.platform == macOS 
| include execution.crashes during past 60min 
| where device.operating_system.platform == macOS 
| compute number_of_events_ = crash.number_of_crashes.sum() 
| where number_of_events_ != 0 
| list 
  device.name, 
  device.entity, 
  device.hardware.model, 
  device.hardware.type, 
  device.operating_system.name
```

調査ページにおける変更されたクエリには次の点が含まれます。

* フィルタ変更 `where device.operating_system.platform == macOS`
* 期間選択ツールの変更 `during past 60min`
* `summarize`行の変換を`list`行にする

`list`行が返すフィールドは以下の通りです。

* ルートテーブルのデフォルトフィールド、たとえばクエリの最初の行で参照するテーブル
* 特定のフィールドに集計を行う場合、特定のフィールドが返されます:\
  `summarize num_freezes = execution.event.number_of_freezes.sum()`は\
  `list [デフォルトのフィールド], execution.event.number_of_freezes`に変換されます。

調査ページから、調査ページのアクションバーを使用して追加の操作やドリルダウンを行うことができます。

調査ページでの調査ドリルダウンの詳細については、調査[NQLエディタ](https://docs.nexthink.com/platform/ja/user-guide/investigations/creating-investigations/nql-editor)のアクションバーの\_調査オプション\_セクションを参照してください。

</details>

## ダッシュボードの編集とエクスポート <a href="#usinglivedashboards-editingandexportingadashboard" id="usinglivedashboards-editingandexportingadashboard"></a>

ダッシュボードページの右上隅にあるアクションメニューをクリックして、ライブダッシュボードを**編集**および**エクスポート**します。

ダッシュボードページの同じアクションメニューを使用して、ダッシュボードを**複製**または**削除**することができます。

{% hint style="info" %}
ダッシュボード作成、管理、およびカスタマイズの仕方を学ぶには、[ライブダッシュボードの管理](https://docs.nexthink.com/platform/ja/user-guide/live-dashboards/managing-live-dashboards)のドキュメントを参照してください。
{% endhint %}

<figure><img src="https://3549141153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeLm8O7QKZDn6z806e7Sv%2Fuploads%2Fgit-blob-0ce4463f36254b541a6cebd0b6f1e483bcd0d04f%2Fediting_dashboard.png?alt=media" alt=""><figcaption></figcaption></figure>

## ダッシュボードURLの共有 <a href="#usinglivedashboards-sharingadashboardurl" id="usinglivedashboards-sharingadashboardurl"></a>

自分のダッシュボードのURLをコピーして、他のユーザーと共有することができます。 ただし、受取人はURLを正常に開くためにライブダッシュボードへのアクセスが必要です。

ダッシュボードURLには次の情報が含まれます。

* 選択されている期間
* 選択されたフィルタとその値
* 現在選択されているタブ

受取人は、意図した状態のままダッシュボードを読み込みます。

{% hint style="info" %}
ダッシュボードの共有と権限付与に関する詳細については、[ライブダッシュボードの管理](https://docs.nexthink.com/platform/ja/user-guide/managing-live-dashboards#managinglivedashboards-sharingdashboardssharing)のドキュメントを参照してください。
{% endhint %}

***

関連トピック

* [ライブダッシュボードの管理](https://docs.nexthink.com/platform/ja/user-guide/live-dashboards/managing-live-dashboards)
* [ウィジェットの種類](https://docs.nexthink.com/platform/ja/user-guide/live-dashboards/widget-types)
* [ライブダッシュボードNQLの例](https://docs.nexthink.com/platform/ja/user-guide/live-dashboards/live-dashboards-nql-examples)