Observability Operational Commands

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 time-series.

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

Invalid Metric Configuration

Example for invalid metric configurations

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

  Value: 3 sampled at 30-JUL-2025 06:45:10
  Labels:
    attribute_name                : af_configured
    bd_name                       : bgp.iod.1
    element_name                  : L1-STD-1-1047
    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: 21 sampled at 30-JUL-2025 06:45:10
  Labels:
    attribute_name                : af_configured
    bd_name                       : bgp.iod.1
    element_name                  : L1-STD-1-1047
    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: 3 sampled at 30-JUL-2025 06:45:10
  Labels:
    attribute_name                : af_configured
    bd_name                       : bgp.iod.1
    element_name                  : L1-STD-1-1047
    error_type                    : invalid_filter_attribute_type
    instance                      : localhost:3102
    job                           : bds_rtbrick_error
    metric_name                   : bgp_default_peer_state
    pod_name                      : rtbrick-pod
    profile_name                  : bgp_metrics

  Value: 3 sampled at 30-JUL-2025 06:45:10
  Labels:
    attribute_name                : invalid_label
    bd_name                       : bgp.iod.1
    element_name                  : L1-STD-1-1047
    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: 3 sampled at 30-JUL-2025 06:45:10
  Labels:
    attribute_name                : invalid_filter
    bd_name                       : bgp.iod.1
    element_name                  : L1-STD-1-1047
    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: 3 sampled at 30-JUL-2025 06:45:10
  Labels:
    attribute_name                : invalid_attribute
    bd_name                       : bgp.iod.1
    element_name                  : L1-STD-1-1047
    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

Time-series 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>