Last updated: March 3, 2026
TimeSeriesTable Definition
Displays time series data in a tabular format with configurable column formats, sorting, and aggregation.
Kind: TimeSeriesTable
Spec Properties
| Property | Type | Required | Description |
|---|---|---|---|
dash0Extensions | object with keys: maxTimeSeries | No | |
formats | object | No | |
maxDesiredDataPoints | number | null | No | Maximum number of data points to display in the widget (0–1000). Lower values improve performance, higher values increase resolution. Null means use the default. |
sort | object — Sorting configuration for table or list displays. | No | Sorting configuration for table or list displays. |
calculation | string — enum: first, last, first-number, last-number, mean, sum, min, max, instant | No | Aggregation function applied to reduce a time series to a single value. 'last' returns the most recent value, 'mean' computes the average, 'sum' totals all values, 'min'/'max' return extremes, 'first-number'/'last-number' skip non-numeric values, and 'instant' returns the value at the end of the time range. |
Shared Definitions
formatOptions
Value format configuration. Choose one of: time, percent, decimal, bytes, bytes/s, throughput, currency, or temperature.
One of: timeFormatOptions | percentFormatOptions | decimalFormatOptions | bytesFormatOptions | bytesPerSecondFormatOptions | throughputFormatOptions | currencyFormatOptions | temperatureFormatOptions
timeFormatOptions
Format options for displaying time duration values.
| Property | Type | Required |
|---|---|---|
unit | string — enum: nanosecond, microsecond, milliseconds, seconds, minutes, hours, days, weeks, months, years | Yes |
decimalPlaces | number | No |
percentFormatOptions
Format options for displaying percentage values.
| Property | Type | Required |
|---|---|---|
unit | string — enum: percent, percent-decimal, % | Yes |
decimalPlaces | number | No |
decimalFormatOptions
Format options for displaying plain decimal numbers.
| Property | Type | Required |
|---|---|---|
unit | string — enum: decimal | Yes |
decimalPlaces | number | No |
shortValues | boolean | No |
bytesFormatOptions
Format options for displaying byte values.
| Property | Type | Required |
|---|---|---|
unit | string — enum: bytes | Yes |
decimalPlaces | number | No |
shortValues | boolean | No |
base | string — enum: decimal, binary | No |
bytesPerSecondFormatOptions
Format options for displaying byte rate values (bytes per second).
| Property | Type | Required |
|---|---|---|
decimalPlaces | number | No |
shortValues | boolean | No |
base | string — enum: decimal, binary | No |
unit | string — enum: bytes/s, bytes/sec | Yes |
throughputFormatOptions
Format options for displaying throughput/rate values.
| Property | Type | Required |
|---|---|---|
unit | string — enum: counts/sec, events/sec, messages/sec, ops/sec, packets/sec, reads/sec, records/sec, errors/sec, requests/sec, rows/sec, writes/sec, /m, /s | Yes |
decimalPlaces | number | No |
shortValues | boolean | No |
currencyFormatOptions
Format options for displaying monetary/currency values.
| Property | Type | Required |
|---|---|---|
unit | string — enum: currency-usd, currency-eur, currency-cny, currency-jpy | Yes |
decimalPlaces | number | No |
shortValues | boolean | No |
temperatureFormatOptions
Format options for displaying temperature values.
| Property | Type | Required |
|---|---|---|
unit | string — enum: celsius, fahrenheit | Yes |
decimalPlaces | number | No |
shortValues | boolean | No |
maxDesiredDataPoints
Maximum number of data points to display in the widget (0–1000). Lower values improve performance, higher values increase resolution. Null means use the default.
One of: number | null
sortConfiguration
Sorting configuration for table or list displays.
| Property | Type | Required |
|---|---|---|
sortField | string | null | No |
sortDirection | string — enum: asc, desc | No |
calculationType
Aggregation function applied to reduce a time series to a single value. 'last' returns the most recent value, 'mean' computes the average, 'sum' totals all values, 'min'/'max' return extremes, 'first-number'/'last-number' skip non-numeric values, and 'instant' returns the value at the end of the time range.
Type: string
Values: first, last, first-number, last-number, mean, sum, min, max, instant