ROUTERSTAT(8) Lustre Configuration Utilities ROUTERSTAT(8)

# [NAME](#NAME)

routerstat - print Lustre router statistics

# [SYNOPSIS](#SYNOPSIS)

`routerstat` \[*INTERVAL*]

# [DESCRIPTION](#DESCRIPTION)

**routerstat** displays LNET router statistics. If no *INTERVAL* is specified, the statistics are sampled and printed only once; otherwise, statistics are sampled and printed every *interval* seconds. Type Control-C to stop statistics printing.

Output includes the following fields:

[**M** -](#M)

Number of messages currently being processed by LNET (The maximum number of messages ever processed by LNET concurrently)

[**E** -](#E)

Number of LNET errors

[**S** -](#S)

Total size (length) of messages sent in bytes. Number of messages sent

[**R** -](#R)

Total size (length) of messages received in bytes. Number of messages received

[**F** -](#F)

Total size (length) of messages routed in bytes. Number of messages routed

[**D** -](#D)

Total size (length) of messages dropped in bytes. Number of messages dropped

When an *interval* is specified, additional lines of statistics are printed including the following fields:

[**M** -](#M~2)

Number of messages currently being processed by LNET (The maximum number of messages ever processed by LNET concurrently)

[**E** -](#E~2)

Number of LNET errors per second

[**S** -](#S~2)

Rate of data sent in Mbytes per second. Count of messages sent per second

[**R** -](#R~2)

Rate of data received in Mbytes per second. Count of messages received per second

[**F** -](#F~2)

Rate of data routed in Mbytes per second. Count of messages routed per second

[**D** -](#D~2)

Rate of data dropped in Mbytes per second. Count of messages dropped per second

# [FILES](#FILES)

/proc/sys/lnet/stats

# [EXAMPLES](#EXAMPLES)

```
# routerstat 1
M 0(13) E 0 S 117379184/4250 R 878480/4356 F 0/0 D 0/0
M   0( 13) E 0 S    7.00/     7 R    0.00/    14 F    0.00/     0 D 0.00/0
M   0( 13) E 0 S    7.00/     7 R    0.00/    14 F    0.00/     0 D 0.00/0
M   0( 13) E 0 S    8.00/     8 R    0.00/    16 F    0.00/     0 D 0.00/0
M   0( 13) E 0 S    7.00/     7 R    0.00/    14 F    0.00/     0 D 0.00/0
M   0( 13) E 0 S    7.00/     7 R    0.00/    14 F    0.00/     0 D 0.00/0
M   0( 13) E 0 S    7.00/     7 R    0.00/    14 F    0.00/     0 D 0.00/0
M   0( 13) E 0 S    7.00/     7 R    0.00/    14 F    0.00/     0 D 0.00/0
M   0( 13) E 0 S    8.00/     8 R    0.00/    16 F    0.00/     0 D 0.00/0
M   0( 13) E 0 S    7.00/     7 R    0.00/    14 F    0.00/     0 D 0.00/0
...
```

# [AVAILABILITY](#AVAILABILITY)

**routerstat** is part of the [**lustre**(7)](/man/enterprise-packages/lustre/lustre.7) filesystem package since release 0.7.0

# [SEE ALSO](#SEE_ALSO)

2024-08-28 Lustre

---

Document: routerstat(8) from lustre 2.17.59-r2 (Chainguard OS)
Source: https://github.com/lustre/lustre-release