NQL時間選択

NQLでは、時間枠をさまざまな形式で指定できます。

時間の選択形式

NQL 過去

during past 条項を使用すると、現在までの特定の期間を指定して結果をフィルタリングできます。 時間は分、時間、または日数で表すことができます。

例:

Retrieving the number of navigations in the past 45 minutes.

web.page_views during past 45min
| summarize total_navigations = number_of_page_views.sum()

過去1時間のナビゲーションの数を取得します。

web.過去1時間のPage_views
| total_navigations = number_of_page_views.sum()を集計 

Retrieving the number of navigations in the past 12 hours.

web.Page_views during past 12h
| summarize total_navigations = number_of_page_views.sum() 

Retrieving the number of navigations in the past 3 days.

web.Page_views during past 3d
| summarize total_navigations = number_of_page_views.sum() 

NQLから<からまで

「from to」句を使用すると、開始時間と終了時間を指定してカスタム期間フィルターを適用することができます。

固定された期間を指定する

期間の開始と終了の日時を固定値として指定して、期間フィルターを適用します。

例:

The number of navigations from June 1, 2023 to June 15, 2023

web.page_views from Jun 1, 2023 to Jun 15, 2023
| summarize total_navigations = number_of_page_views.sum() 

The number of navigations from June 15, 2023 at 12:30 to June 15, 2023 at 16:15

web.page_views from Jun 15, 2023, 12:30 to Jun 15, 2023, 16:15
| summarize total_navigations = number_of_page_views.sum()

2023-02-01 00:00:00から2023-02-28 23:45:00までのナビゲーション数

web.page_views from 2023-02-01 00:00:00 to 2023-02-28 23:45:00
| summarize total_navigations = number_of_page_views.sum()

2023-02-01から2023-02-28までのナビゲーション数

web.page_views from 2023-02-01 to 2023-02-28
| summarize total_navigations = number_of_page_views.sum()

NQLデータ型セクションで許可された日付形式の詳細を確認してください。 NQL editorのオートコンプリート機能は、利用可能なデータ形式の提案を提供することに留意してください。

相対的な期間を指定する

現在の時刻に対して相対的な時間枠を定義することで、時間枠フィルターを適用します。たとえば、「15分前」、「2時間前」、「1日前」などです。

時間は分、時間、または日で表現できます。

例:

前日のナビゲーションの数。

web.page_views from 1d ago to 1d ago
| summarize total_navigations = number_of_page_views.sum() 

3週間連続して7日間の間隔でグループ化されたナビゲーションの数。

devices
| 21日前から13日前までのweb.page_viewsを含む
| week1 = number_of_page_views.sum()を計算
| 14日前から8日前までのweb.page_viewsを含む
| week2 = number_of_page_views.sum()を計算
| 過去7日のweb.page_viewsを含む
| current_week = number_of_page_views.sum()を計算

NQL の

on 条項を使用すると、データをクエリする際に特定の日を選択できます。

例:

The number of navigations on July 15, 2023

web.page_views on Jul 15, 2023
| summarize total_navigations = number_of_page_views.sum() 

web.page_views on 2023-06-15
| summarize total_navigations = number_of_page_views.sum() 

NQL datetime関数

NQL where 条件を使用して、現在の時間以外の時点に対する時間ウィンドウを指定することで、時間選択をさらにカスタマイズできます。例えば、営業時間、営業週、特定の日などです；

nql-date-time-functionsの詳細については、こちらをご覧ください。

時間の細かさと保持

時間選択の精度レベルを選択する柔軟性があります。 より細かいデータを取得するために、NQL時間指定で分または時間を使用してください。 日を使用して、通常、より長い期間をカバーするあまり細かくないデータを取得してください。

特定の時間を指定せずに**日単位で時間枠を指定する場合（たとえば、「過去2日」、「2023年6月1日」、「1日前」など）、システムにはデフォルトで以下が含まれます。

• 期間の開始: 開始日の00:00:00（真夜中）。

• 期間の終了: 終了日の23:59:59。

これにより、指定された範囲内のすべての日が含まれることが保証されます。

データの保存と粒度は、特定のテーブルにも依存します。 データ解像度と保持ページを参照してください。

デスクトップ仮想化用の高解像度データを取得しています

デフォルトでは、VDIイベントデータは5分または1日ごとに解像度が設定されており、時間選択に応じて NQLクエリで利用可能です。 VDIデータ解像度を上げるには、クエリの時間選択の最後に by 30s を追加してください。 過去 2 日間の高解像度データが利用可能です。

以下の例は、vdi_eventsから高解像度データを取得する方法を示しています。

データ解像度を 1 日から 30 秒に増やします。

session.vdi_events during past 1d by 30s

30秒までに2024-08-04に開催されるセッション.vdi_events

データ解像度を 5 分から 30 秒に増やします。

過去24時間のセッション.vdi_events (30秒毎)

session.vdi_events 2024 年 11 月 8 日 15:15 から 2024 年 11 月 8 日 17 時 30 秒まで

タイムゾーン

Nexthinkクラウドインスタンスがユーザーのタイムゾーンとは異なるタイムゾーンにある場合、時間選択単位によって、指定された期間の開始と終了を定義する際にどのタイムゾーンが考慮されるかが決まります。

• フルデイの時間枠（例：過去2日間にわたり、2024-02-07から2024-02-08まで、2024年2月<b>8</b>日）は、クラウドインスタンスのタイムゾーンを使用します。

• 時間と分で表されるタイムフレーム (たとえば、「過去 15 分」、「2024-02-07 14:45:00 から 2024-02-08 14:45:00 まで」) は、ユーザーのタイムゾーンを使用します。

この区別はクエリでカバーされる期間にのみ適用されます。 結果は常にユーザーのタイムゾーンで表示されます。

例:

この機能が実際のシナリオでどのように機能するかを考えてみましょう。

Suppose two Nexthink users query the data using the Nexthink platform set to Eastern Time (ET).

• 最初のユーザーはNexthinkプラットフォームと同じタイムゾーンで操作しています。 The current time for them is November 11, 05:26:15.

• The second user operates in the Central European Time (CET) zone. The current time for them is November 11, 11:26:15.

その場合、2番目のNexthinkユーザーによって行われた時間に関連するクエリは、CETとETのタイムゾーンの違いを考慮して、対応する時間枠に変換されます。 これにより、地理的位置やタイムゾーンに関係なく、正確なデータの取得と分析が保証されます。

時間枠選択	Nexthink Platform と同じく東部時間 (ET) の Nexthink ユーザー：	Nexthink user in the Central European Time (CET) zone:
過去15分	Nov 11, 05:15:00 AM – 05:30:00 AM ET​	Nov 11, 11:15:00 AM – 11:30:00 AM CET
過去2時間	Nov 11, 04:00:00 AM – 06:00:00 AM ET​	Nov 11, 10:00:00 AM – 12:00:00 PM CET
過去24時間	Nov 10, 06:00:00 AM – Nov 11 06:00:00 AM ET​	Nov 10, 12:00:00 PM – Nov 11, 12:00:00 PM CET
2021-11-11 00:00:00 から2021-11-11 12:00:00	2021-11-11 12:00:00 AM から2021-11-11 12:00:00 PM	2021-11-11 12:00:00 AM から2021-11-11 12:00:00 PM
過去1日	Nov 11, 12:00:00 AM – Nov 12, 12:00:00 AM ET	Nov 11, 06:00:00 – Nov 12, 06:00:00 CET
on Nov 10, 2021	Nov 10, 12:00:00 AM – Nov 11, 12:00:00 AM ET​	Nov 10, 06:00:00 – Nov 11, 06:00:00 CET