NQL時間選択

NQLでは、さまざまな形式でタイムフレームを指定できます。

時間の選択形式

過去のNQL

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

例:

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

web.page_views 過去45分
| 合計ナビゲーション = number_of_page_views.sum()

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

web.Page_views 過去1時間
| 合計ナビゲーション = number_of_page_views.sum() 

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

web.Page_views 過去12時間
| 合計ナビゲーション = number_of_page_views.sum() 

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

web.Page_views 過去3日
| 合計ナビゲーション = number_of_page_views.sum() 

NQLから

from to 節を使用すると、開始時刻と終了時刻を指定してカスタムタイムフレームフィルタを適用できます。

固定されたタイムフレームを指定する

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

例:

2023年6月1日から2023年6月15日までのナビゲーション数

2023年6月15日12:30から2023年6月15日16:15までのナビゲーション数

2023年2月1日00:00:00から2023年2月28日23:45:00までのナビゲーション数

2023年2月1日から2023年2月28日までのナビゲーション数

許可されている日付形式についての詳細は、NQLデータ型セクションを参照してください。 NQLエディターでのオートコンプリート機能により、利用可能なデータ形式の提案が提供されます。

相対的なタイムフレームを指定する

現在の時間に対して相対的な時間ウィンドウを定義することで、タイムフレームフィルタを適用します。例:15分前, 2時間前, 1日前

時間は分、時間または日数で表すことができます。

例:

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

3週間の連続期間にわたり7日間の間隔にまとめられたナビゲーション数。

NQLで

on 節を使用すると、特定の日を選択してデータをクエリできます。

例:

2023年7月15日のナビゲーション数

NQL datetime関数

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

NQL datetime関数については、さらに詳しくは参照してください。

時間の粒度と保持

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

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

  • 期間の開始: 開始日の午前0時00分00秒(真夜中)。

  • 期間の終了: 終了日の午後11時59分59秒。

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

circle-info

データの保存と粒度は、特定のテーブルにも依存します。 データの解像度と保存に関する詳細は、ドキュメントページを参照してください。

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

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

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

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

データ解像度を 5 分から 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 まで」) は、ユーザーのタイムゾーンを使用します。

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

例:

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

2人のネクスシンクユーザーが、東部時間(ET)に設定されたネクスシンクプラットフォームを使用してデータをクエリしているとします。

  • 最初のユーザーはNexthinkプラットフォームと同じタイムゾーンで操作しています。 彼らの現時間は、11月11日5時26分15秒です。

  • 2番目のユーザーは中央ヨーロッパ時間(CET)帯で動作しています。 彼らの現時間は、11月11日11時26分15秒です。

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

タイムフレーム選択
ネクスシンクプラットフォームと同じ東部時間(ET)帯のネクスシンクユーザー:
中央ヨーロッパ時間(CET)帯のネクスシンクユーザー:

過去15分

11月11日、午前5時15分00秒 から午前5時30分00秒 ET​​

11月11日、午前11時15分00秒 から午前11時30分00秒 CET

過去2時間

11月11日、午前4時00分00秒 から午前6時00分00秒 ET​

11月11日、午前10時00分00秒 から午後12時00分00秒 CET

過去24時間

11月10日、午前6時00分00秒 から11月11日午前6時00分00秒 ET​

11月10日、午前12時00分00秒 から11月11日午前12時00分00秒 CET

2021年11月11日00:00:00から 2021年11月11日12:00:00まで

2021年11月11日午前12時00分00秒から 2021年11月11日午前12時00分00秒まで

2021年11月11日午前12時00分00秒から 2021年11月11日午前12時00分00秒まで

過去1日

11月11日午前12時00分00秒 から11月12日午前12時00分00秒 ET

11月11日、午前6時00分00秒 から11月12日午前6時00分00秒 CET

2021年11月10日に

11月10日午前12時00分00秒 から11月11日午前12時00分00秒 ET​​

11月10日、午前6時00分00秒 から11月11日午前6時00分00秒 CET

Last updated

Was this helpful?