TSDB Operational Commands

TSDB Show Commands

High-level time-series show command and options:

supervisor@rtbrick.net: cfg> show time-series
 alert
 metric
 statistics

Alert Details

Display information about the time-series alerts.

Syntax:

show time-series alert <alert-name>

Option Description

-

Without any option, the command lists all firing alerts.

<alert-rule>

All alerts for the given alert rule.

pipe (|)

Allows you to specify options: grep and count.

grep <grep_str>

Specify the grep string.

Example: Information about time-series alert

supervisor@rtbrick.net: cfg> show time-series alert
State       Since                  Level        Summary
firing      26-JUN-2025 09:40:24   Critical     Process confd has crashed.

Example:

supervisor@rtbrick.net: cfg> show time-series alert | count
3

Metric Details

Display information about timeseries metrics.

Syntax:

show time-series metric <metric-name>

Option Description

-

Without any option, displays information about all metrics.

rtbrick_invalid_metric_config

Displays the list of misconfigurations in TSDB.

Example: Information for a specified metric.

supervisor@rtbrick.net: cfg> show time-series metric process_status
Metric: process_status
  Value: 1 sampled at 23-JUN-2025 10:20:08
  Labels:
    administrative_state          : UP
    bd                            : bgp.appd.1
    bd_name                       : etcd
    element_name                  : L1-STD-2-2008
    instance                      : localhost:1002
    job                           : bds_up_metrics
    pod_name                      : rtbrick-pod

  Value: 1 sampled at 23-JUN-2025 10:20:08
  Labels:
    administrative_state          : UP
    bd                            : bgp.iod.1
    bd_name                       : etcd
    element_name                  : L1-STD-2-2008
    instance                      : localhost:1002
    job                           : bds_up_metrics
    pod_name                      : rtbrick-pod

  Value: 1 sampled at 23-JUN-2025 10:20:08
  Labels:
    administrative_state          : UP
    bd                            : confd
    bd_name                       : etcd
    element_name                  : L1-STD-2-2008
    instance                      : localhost:1002
    job                           : bds_up_metrics
    pod_name                      : rtbrick-pod

  Value: 1 sampled at 23-JUN-2025 10:20:08
  Labels:
    administrative_state          : UP
    bd                            : fibd
    bd_name                       : etcd
    element_name                  : L1-STD-2-2008

Example for invalid metric configurations

supervisor@rtbrick.net: cfg> show time-series metric rtbrick_invalid_metric_config
Metric: rtbrick_invalid_metric_config

  Value: 34283 sampled at 02-JUL-2025 05:16:25
  Labels:
    attribute_name                : af_configured
    bd_name                       : bgp.iod.1
    element_name                  : L1-STD-10-1102
    error_type                    : invalid_attribute_type
    instance                      : localhost:3102
    job                           : bds_rtbrick_error
    metric_name                   : bgp_default_peer_state
    pod_name                      : rtbrick-pod
    profile_name                  : bgp_metrics

  Value: 302 sampled at 02-JUL-2025 05:16:25
  Labels:
    attribute_name                : af_configured
    bd_name                       : bgp.iod.1
    element_name                  : L1-STD-10-1102
    error_type                    : invalid_label_attribute_type
    instance                      : localhost:3102
    job                           : bds_rtbrick_error
    metric_name                   : bgp_default_peer_state
    pod_name                      : rtbrick-pod
    profile_name                  : bgp_metrics

  Value: 34283 sampled at 02-JUL-2025 05:16:25
  Labels:
    attribute_name                : invalid_label
    bd_name                       : bgp.iod.1
    element_name                  : L1-STD-10-1102
    error_type                    : invalid_label_attribute
    instance                      : localhost:3102
    job                           : bds_rtbrick_error
    metric_name                   : bgp_default_peer_state
    pod_name                      : rtbrick-pod
    profile_name                  : bgp_metrics

  Value: 34283 sampled at 02-JUL-2025 05:16:25
  Labels:
    attribute_name                : invalid_filter
    bd_name                       : bgp.iod.1
    element_name                  : L1-STD-10-1102
    error_type                    : invalid_filter_attribute
    instance                      : localhost:3102
    job                           : bds_rtbrick_error
    metric_name                   : bgp_default_peer_state
    pod_name                      : rtbrick-pod
    profile_name                  : bgp_metrics

  Value: 34283 sampled at 02-JUL-2025 05:16:25
  Labels:
    attribute_name                : invalid_attribute
    bd_name                       : bgp.iod.1
    element_name                  : L1-STD-10-1102
    error_type                    : invalid_attribute
    instance                      : localhost:3102
    job                           : bds_rtbrick_error
    metric_name                   : bgp_default_peer_state
    pod_name                      : rtbrick-pod
    profile_name                  : bgp_metrics

Timeseries Statistics

The show time-series statistics that provides visibility into the time-series processing on RBFS. It helps to identify any existing configuration errors and displays the number of active jobs currently, running to collect time-series data. The number of active jobs depends on the applied time-series metric configuration.

Syntax:

show time-series statistics

Option Description

-

Without any option, the command displays all statistics.

pipe (|)

Allows you to specify options: grep and count.

grep <grep_str>

Specify the grep string.

Example: Time-series statistics

supervisor@rtbrick.net: cfg> show time-series statistics
Scrape Targets
Metric Profile                       Daemons
bgp_metrics                          1
rtbrick_error                        1
up_metrics                           1

Error Counters
Name                                                               Count       Increase (in last 5 mins)
prometheus_target_scrapes_sample_duplicate_timestamp_total         0           0
prometheus_target_scrapes_exemplar_out_of_order_total              0           0
prometheus_target_scrapes_sample_out_of_bounds_total               0           0
prometheus_target_scrapes_sample_out_of_order_total                0           0
prometheus_target_scrapes_exceeded_sample_limit_total              0           0
supervisor@L1-STD-2-2008>bm08-tst.hel.rtbrick.net: cfg>

Example: Time-series data table

supervisor@rtbrick.net: cfg> show datastore confd table global.time-series.config
Object: 0, Sequence 3, Last update: Mon May 23 09:02:28 GMT +0000 2022
Attribute                        Type                 Length   Value
configuration_name (1)           string (9)            8        rtbrick
time-series-history-enable (2)   boolean (6)           1        False

Example for profile configuration for rtbrick_error_type:

supervisor@rtbrick.net: cfg> show datastore confd table global.time-series.profile.config
Object: 0, Sequence: 1, Last update: Mon Jun 30 05:24:08 GMT +0000 2025
  Attribute                                               Type                           Length     Value
  profile-name (1)                                        string (9)                          8     default
  scrape-interval (3)                                     string (9)                          3     5s
Object: 1, Sequence: 2, Last update: Mon Jun 30 05:24:08 GMT +0000 2025
  Attribute                                               Type                           Length     Value
  profile-name (1)                                        string (9)                         14     rtbrick_error
  scrape-interval (3)                                     string (9)                          3     5s
metric config for rtbrick_error:

Example for profile configuration for rtbrick_error_type:

supervisor@rtbrick.net: cfg> show datastore confd table global.time-series.metric.config
Object: 1, Sequence: 2, Last update: Mon Jun 30 05:39:22 GMT +0000 2025
  Attribute                                               Type                           Length     Value
  metric-name (1)                                         string (9)                         30     rtbrick_invalid_metric_config
  table-name (2)                                          string (9)                         37     local.time-series.metric.error.stats
  metric-bds-type (3)                                     uint8 (2)                           1     object-metric
  metric-prometheus-type (4)                              uint8 (2)                           1     counter
  metric-description (6)                                  string (9)                         40     Time-series metric configuration issues
  profile-name (9)                                        string (9)                         14     rtbrick_error