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-name> |
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