The list widget displays a list of events and issues, which can come from a variety of sources such as Logs, RUM, or Events. Search and query across sources to narrow down the events you want the widget to highlight and display.

エラー追跡問題を表示するリストウィジェット

エラーの一覧、エラー数、エラー量を表示するリストウィジェットです。

セットアップ

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

構成

  1. Choose the type of data to graph. You can create a list widget from Issues, Logs, Audit Trail, Watchdog Alerts, or Events depending on which products are available for your organization.

  2. ディスプレイの環境設定を行います。スクリーンボードとノートブックの場合にのみ、ウィジェットがカスタムタイムフレームを持つか、グローバルタイムフレームを使用するかを選択します。

  3. オプション: グラフにタイトルを付けます (または、提案されたタイトルを使用するには空白のままにします)。

オプション

リストウィジェットの種類によって、それぞれ構成が異なります。

問題

ソート方法

問題については、以下でソートすることができます。

  • エラー数 (デフォルト)
  • 最初に遭遇
  • 影響を受けたセッション

注: “Sorting by” の選択を変更しても、表示される列は変わりません。影響を受けたセッションでソートするようにリストを変更し、これをウィジェットに表示したい場合、グラフエディタに “Impacted Sessions” も選択または追加する必要があります。

Logs

グループ化

ログについては、以下でグループ化することができます。

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

RUM イベントリストオプション

ソート方法

RUM については、以下でソートすることができます。

  • セッションタイプ
  • 使用時間
  • 表示回数
  • エラー数
  • アクション数
  • セッションフラストレーション数
  • 初期ビュー名
  • 最終ビュー名

昇順または降順

イベント

レポートフォーマットのサイズ:

イベントについては、ウィジェットでの表示方法を選択することができます。

  • 小 (タイトルのみ)
  • 大 (イベント全体)

インシデント

ソート方法

For incidents, you can sort by:

  • Created time
  • 重大度
  • ステータス

昇順または降順

API

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

Expand All

フィールド

種類

説明

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.

is_clustering_pattern_field_path

boolean

Identifies the clustering pattern field column, usable only with logs_pattern_stream.

width [required]

enum

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

query [required]

object

Updated list stream widget.

clustering_pattern_field_path

string

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

default: message

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,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. 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,event_stream,rum_stream,llm_observability_stream

default: apm_issue_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.

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

storage

string

Option for storage location. Feature in Private Beta.

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.

Option 1

object

Wrapper for live span

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,1mo,3mo,6mo,week_to_date,month_to_date,1y,alert

Option 2

object

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

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.

Option 3

object

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

from [required]

int64

Start time in seconds since epoch.

to [required]

int64

End time in seconds 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

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

その他の参考資料