リストウィジェットは、ログ、RUM、イベントなど、さまざまなソースからのイベントや問題のリストを表示します。ソース全体を検索およびクエリして、ウィジェットでハイライトおよび表示したいイベントを絞り込みます。

エラートラッキングの問題を表示するリストウィジェット

エラーのリスト、エラー数、およびボリュームを表示するリストウィジェット。

セットアップ

リストウィジェットの構成モーダル

構成

  1. グラフ化するデータのタイプを選択します。リストウィジェットは、組織で有効になっている製品に応じて、多くのデータソースをサポートしています。全リストについては、サポートされているデータソース を参照してください。

  2. 表示設定を行います。スクリーンボードや Notebooks では、ウィジェットにカスタムの時間枠を使用するかグローバルな時間枠を使用するかを選択します。

  3. オプション: グラフにタイトルを付けます (空白のままにすると、推奨タイトルが使用されます)。

サポートされているデータソース

ソースのドロップダウンで利用可能なデータソースは、組織で有効になっている製品によって異なります。次のテーブルに、各データソース、表示されるデータ、および製品要件を記載します。利用可能な場合は、テーブル内のデータソースをクリックしてその構成オプションに移動できます。

(プレビュー) とマークされたデータソースはプレビュー版であり、組織では利用できない場合があります。

データソース説明要件
Audit Trail組織全体のアクティビティを追跡する監査イベント。Audit Trail
Casesチーム間で作業を追跡およびトリアージするケース。Case Management
CD Deployments (プレビュー)Continuous Delivery デプロイメント実行。CD Visibility
CI パイプラインCI パイプラインの実行。CI Pipeline Visibility
CI TestCI テストの実行。Test Optimization
Data Observability (プレビュー)Data Observability から得られるデータセットやリネージなどのデータアセット。Data Observability
Database Recommendations (プレビュー)Database Monitoring からの最適化推奨事項。Database Monitoring
DDSQL EditorDDSQL クエリの結果。None
Detection Rules (プレビュー)セキュリティ検出ルール。Cloud SIEM または Cloud Security
Developer Portal (プレビュー)サービス、API、データストアを含む、ソフトウェアエンティティのビュー。Internal Developer Portal
Eventsイベントエクスプローラーからのイベント情報。None
IncidentsIncident Management からのインシデント。Incident Management
Infrastructure Resources (プレビュー)ホストやコンテナなどのインフラストラクチャーリソース。Infrastructure Monitoring
IssuesAPM、ログ、RUM、およびその他のソース全体にわたる Error Tracking の問題。Error Tracking
Agent ObservabilityAgent Observability からのトレースとスパン。Agent Observability
Logs個々のログイベント。ログをパターンやトランザクションごとにグループ化することもできます。Log Management
Notebookノートブックセルからのデータ。Notebooks
On-CallOn-Call イベントとページ。Datadog On-Call
Product Analytics (プレビュー)Product Analytics イベント。Product Analytics
RecommendationsCloud Cost Management からのクラウドコスト最適化の推奨事項。Cloud Cost Management
Reference Tables参照テーブルからの行。Reference Tables
RUMReal User Monitoring イベント。Real User Monitoring
Security Signals (プレビュー)検出ルールによって生成されるセキュリティシグナル。Cloud SIEM
SpansAPM スパン。APM
Watchdog AlertsWatchdog による Alerts。None
Workload Protection Agent (プレビュー)Datadog Agent からの Workload Protection イベント。Workload Protection

注: Recommendations データソースには、Cloud Cost Management の推奨事項のみが表示されます。APM の推奨事項は、リストウィジェットのデータソースとして利用することはできません。組織の Cloud Cost Management が構成されていない場合、ウィジェットに Not Accessible メッセージが表示されます。これは、権限が不足しているのではなく、データソースに Cloud Cost Management が必要であることを示しています。

オプション

各データソースには独自の構成があります。ほとんどのデータソースでは、次の操作が可能です。

  • 表示するを選択します。
  • リストを並べ替えるため、列と方向 (昇順または降順) を選択します。利用可能なソート列は、ウィジェットに表示されている列です。
  • 検索クエリを使用して結果を絞り込みます。

以下のデータソースには、追加または異なるオプションがあります。

並べ替え (昇順または降順):

  • アラート数

  • 最終作成

  • ケースキー

  • 最終更新

  • 優先度

  • ステータス

  • 未割当

表示するレベルを選択: パイプライン、ステージ、ジョブ、ステップ、またはカスタム。

エンティティタイプ (データベーステーブルまたはデータベース列) を選択します。利用可能な列と並べ替えオプションは、エンティティタイプによって異なります。

並べ替え (昇順または降順):

  • 重大度

  • タイプ

  • 初回検出

  • 最終検出

並べ替え可能な列には、名前、作成日、最終更新日、有効、重大度、ソースが含まれます。ルールプロダクトを選択して、表示されるルールを絞り込むこともできます。

レポート形式のサイズ:

  • 小 (タイトルのみ) (デフォルト)

  • 大 (イベント全体)

並べ替え (昇順または降順):

  • 作成

  • 検出

  • 変更

  • 解決

  • 重大度

  • ステータス

  • タイトル

リソースタイプを選択して表示します (例: Pods、Containers、Deployments、Services、Nodes)。利用可能な列と並べ替えオプションは、リソースタイプによって異なります。

並べ替え:

  • 関連性 (デフォルト)
  • 最新
  • 影響を受けたセッション (RUM の問題のみ)

利用可能な列は、問題のソース (ログ、APM、または RUM) によって異なります。

注: 並べ替えの選択を変更しても、表示される列は変更されません。影響を受けたセッションで並べ替えてウィジェットに表示するには、グラフエディターで「影響を受けたセッション」列も追加する必要があります。

グループ化:

  • パターン
  • トランザクション

ログの構成に応じて、ストレージの場所 (Standard Indexes、Standard Indexes + Flex Logs、または Online Archives) を選択することもできます。

メッセージ列については、表示する行数 (1、3、または 10) を選択できます。

これらのデータソースは、保存されたデータセットまたはテーブルの行を表示します。

  • ノートブック および DDSQL Editor: 公開されたデータセットを選択します。
  • Reference Tables: 参照テーブルを選択します。
  • Developer Portal: サービス、API、データストアなどのソフトウェアエンティティテーブルを選択します。

これらのデータソースでは、次の操作が可能です。

  • 最初の行を表示」を設定して、行数 (10、25、50、100、500、1000、またはカスタム値) を制限します。

  • すべての列を表示」を切り替えるか、最大 12 列を選択して表示します。

  • 列の並べ替えアイコンをクリックして並べ替えます。

  • 検索クエリを使用して行をフィルタリングします。

チーム」を選択し、必要に応じてタグを追加して、表示されるイベントをフィルタリングします。

Recommendations データソースの列は固定されており、カスタマイズすることはできません。

これらのデータソースは検索クエリをサポートしていますが、並べ替えオプションは提供していません。Watchdog Alerts には、固定されたフィールドセットが表示されます。

「コンテンツ」列については、表示する行数 (1、3、または 10) を選択できます。

API

このウィジェットは、Dashboards API で使用できます。ウィジェット JSON スキーマ定義 については、以下のテーブルを参照してください。

Expand All

フィールド

タイプ

説明

description

string

The description of the widget.

legend_size

string

Available legend sizes for a widget. Should be one of "0", "2", "4", "8", "16", or "auto".

requests [required]

[object]

Request payload used to query items.

columns [required]

[object]

Widget columns.

field [required]

string

Widget column field.

width [required]

enum

Widget column width. Allowed enum values: auto,compact,full

query [required]

object

Updated list stream widget.

assignee_uuids

[string]

Filter by assignee UUIDs. Usable only with issue_stream.

clustering_pattern_field_path

string

Specifies the field for logs pattern clustering. Usable only with logs_pattern_stream.

compute

[object]

Compute configuration for the List Stream Widget. Compute can be used only with the logs_transaction_stream (from 1 to 5 items) list stream source.

aggregation [required]

enum

Aggregation value. Allowed enum values: count,cardinality,median,pc75,pc90,pc95,pc98,pc99,sum,min

Show 5 more,max,avg,earliest,latest,most_frequent

facet

string

Facet name.

data_source [required]

enum

Source from which to query items to display in the stream. apm_issue_stream, rum_issue_stream, and logs_issue_stream are deprecated. Use issue_stream instead. Allowed enum values: logs_stream,audit_stream,ci_pipeline_stream,ci_test_stream,rum_issue_stream,apm_issue_stream,trace_stream,logs_issue_stream,logs_pattern_stream,logs_transaction_stream

Show 7 more,event_stream,rum_stream,llm_observability_stream,issue_stream,security_runtime_stream,security_signals_stream,incidents_stream

default: logs_stream

event_size

enum

Size to use to display an event. Allowed enum values: s,l

group_by

[object]

Group by configuration for the List Stream Widget. Group by can be used only with logs_pattern_stream (up to 4 items) or logs_transaction_stream (one group by item is required) list stream source.

facet [required]

string

Facet name.

indexes

[string]

List of indexes.

persona

enum

Persona filter for the issue_stream data source. Allowed enum values: all,browser,mobile,backend

query_string [required]

string

Widget query.

sort

object

Which column and order to sort by

column [required]

string

Facet path for the column

order [required]

enum

Widget sorting methods. Allowed enum values: asc,desc

states

[string]

Filter by issue states. Usable only with issue_stream.

storage

string

Option for storage location. Feature in Private Beta.

suspected_causes

[string]

Filter by suspected causes. Usable only with issue_stream.

team_handles

[string]

Filter by team handles. Usable only with issue_stream.

version

enum

Version of the query for the logs transaction stream widget. When omitted, v1 query behavior is preserved. Set to sequential_query to use v2 behavior. This feature is in Preview. Allowed enum values: sequential_query

response_format [required]

enum

Widget response format. Allowed enum values: event_list

show_legend

boolean

Whether or not to display the legend on this widget.

time

 <oneOf>

Time setting for the widget.

Object 1

object

Wrapper for live span

hide_incomplete_cost_data

boolean

Whether to hide incomplete cost data in the widget.

live_span

enum

The available timeframes depend on the widget you are using. Allowed enum values: 1m,5m,10m,15m,30m,1h,4h,1d,2d,1w

Show 7 more,1mo,3mo,6mo,week_to_date,month_to_date,1y,alert

<type=live>

object

Used for arbitrary live span times, such as 17 minutes or 6 hours.

hide_incomplete_cost_data

boolean

Whether to hide incomplete cost data in the widget.

type [required]

enum

Type "live" denotes a live span in the new format. Allowed enum values: live

unit [required]

enum

Unit of the time span. Allowed enum values: minute,hour,day,week,month,year

value [required]

int64

Value of the time span.

<type=fixed>

object

Used for fixed span times, such as 'March 1 to March 7'.

from [required]

int64

Start time in milliseconds since epoch.

hide_incomplete_cost_data

boolean

Whether to hide incomplete cost data in the widget.

to [required]

int64

End time in milliseconds since epoch.

type [required]

enum

Type "fixed" denotes a fixed span. Allowed enum values: fixed

title

string

Title of the widget.

title_align

enum

How to align the text on the widget. Allowed enum values: center,left,right

title_size

string

Size of the title.

type [required]

enum

Type of the list stream widget. Allowed enum values: list_stream

default: list_stream

{
  "description": "string",
  "legend_size": "string",
  "requests": [
    {
      "columns": [
        {
          "field": "content",
          "width": "compact"
        }
      ],
      "query": {
        "assignee_uuids": [],
        "clustering_pattern_field_path": "message",
        "compute": [
          {
            "aggregation": "count",
            "facet": "resource_name"
          }
        ],
        "data_source": "logs_stream",
        "event_size": "string",
        "group_by": [
          {
            "facet": "resource_name"
          }
        ],
        "indexes": [],
        "persona": "string",
        "query_string": "@service:app",
        "sort": {
          "column": "",
          "order": "desc"
        },
        "states": [],
        "storage": "indexes",
        "suspected_causes": [],
        "team_handles": [],
        "version": "string"
      },
      "response_format": "event_list"
    }
  ],
  "show_legend": false,
  "time": {
    "hide_incomplete_cost_data": false,
    "live_span": "5m"
  },
  "title": "string",
  "title_align": "string",
  "title_size": "string",
  "type": "list_stream"
}

詳細はこちら