カスタムタイムフレーム

概要

クエリは UTC 時間で実行されますが、クエリの時間枠はブラウザのタイムゾーンに従って選択されます。ダッシュボードの構成アクションから、デフォルトのタイムゾーンと UTC の表示を切り替えることができます。詳細については、ダッシュボード構成のドキュメントを参照してください。

Datadog のビューの多くでは、特定のタイムフレームに合わせたスコープを定めることができます。共通のタイムフレームのリストや、日付の選択に便利なカレンダーピッカーなど、時間の制御に有用な機能が多数揃っています。

タイムフレームは以下のように定義できます。

  • スライディング: 開始点と終了点の両方が時間の経過とともに進みます (例: 5h は常に最新の 5 時間を表示します)。
  • 成長: 開始点が固定され、終了点が「現在」を追跡します (例: since Jun 1 は 6 月 1 日から現在の時間までのすべてを示します)。
  • 固定: 開始点と終了点の両方が特定の時点に固定されます (例: Jan 1 - Jan 2)。

月、日、年、時間、分でインクリメントを行うには、タイムフレームの対象部分を選択して [↑] および [↓] キーで操作します。

サポート対象の構文

固定日付

形式例
{MMM/MMMM} D1 月 1 日
1 月 1 日
M/D1​/​1
M-D1-1
M/D/{YY/YYYY}19/1/1
2019/1/1
M-D-{YY/YYYY}19-1-1
2019-1-1
{MMM/MMMM} D, h:mm a1 月 1 日、午後 1 時
1 月 1 日、午後 1 時
{MMM/MMMM} D, YYYY, h:mm a2019 年 1 月 1 日、午後 1 時
2019 年 1 月 1 日、午後 1 時
h:mm a午後 1 時
UNIX 秒タイムスタンプ1577883600
UNIX ミリ秒タイムスタンプ1577883600000

固定日付はいずれも、範囲の一部として入力できます。例:

  • 1577883600 - 1578009540
  • Jan 1 - Jan 2
  • 6:00 am - 1:00 pm

相対日付

相対日付は時間の経過とともに更新され、現在の時間から計算されます。

形式説明
N{unit}過去の N 単位のスライディングウィンドウを表示します。使用可能な単位は以下のリストに記載されています。開始点と終了点の両方が時間の経過とともに進みます。例: 3 か月 (過去 3 か月)。終了点が「現在」の成長型ウィンドウを作成するには、to now 構文を使用します (例: 10am to now)。詳細については、成長タイムフレームを参照してください。

以下の文字列は相対日付の {unit} として利用できます。

  • 分: m、min、mins、minute、minutes
  • 時間: h、hr、hrs、hour、hours
  • 日: d、day、days
  • 週: w、week、weeks
  • 月: mo、mos、mon、mons、month、months

成長タイムフレーム

成長タイムフレームは開始点が固定され、現在の時間 (「現在」) まで自動的に延長されます。特定の時点以降の活動をすべて確認したい場合に便利です。

形式説明
{date} to now{date} から現在までの成長型ウィンドウ。例: 1 月 1 日から現在まで。
{date} - now{date} to now に相当します。例: 1 月 1 日 - 現在まで。
since {date}{date} to now に相当します。例: 6 月 1 日以降、5 時間以降、1549116000 以降。
from {date}{date} to now に相当します。例: 6 月 1 日から、5 時間から。

両方の形式の {date} に次のいずれかを利用できます。

  • 相対省略形 (例: 5h、2d、3w)
  • 固定日付 (例: Jun 1、Feb 2 2pm、1/15/2024)
  • 秒またはミリ秒単位の Unix タイムスタンプ (例: 1549116000、1549116000000)

カレンダーに沿った日付

カレンダーに沿った日付は、暦の境界線 (例: 午前 0 時、週の始まり、月の始まり) にスナップし、時間の経過とともに更新されます。

形式説明
today今現在の暦日
yesterday1 日前の暦日
week to date今週月曜日午前 0 時から現在まで
month to date今月 1 日から現在まで
year to date今年 1 月 1 日から現在まで
this {unit}今現在の暦単位。例: 今月、今年
last {unit}1 単位前の暦単位。例: 昨月、昨年
previous {unit}last {unit} に相当します。例: 先週、先月
N {units} agoN 期間前の暦単位。例: 2 週間前、3 か月前

URL

ダッシュボードの URL で時間クエリを操作できます。

次のようなダッシュボード URL を考えてみましょう。

https://app.datadoghq.com/dash/host/<DASHBOARD_ID>?from_ts=<QUERY_START>&to_ts=<QUERY_END>&live=true
  • from_ts パラメーターはクエリ開始時刻の Unix ミリ秒単位のタイムスタンプです。例: 1683518770980。
  • to_ts パラメーターはクエリ終了時刻の Unix ミリ秒単位のタイムスタンプです。例: 1683605233205。
  • live=trueは、クエリが保存または共有されたときに相対時間指定が保持されることを示します。live=false を使用することもできます。