# tt_dispatch_prefetch_command_count

[<< Home](../index.md) | [<< Metrics](../metrics.md)

## Name

### Prometheus Metric Name

```
tt_dispatch_prefetch_command_count
```

### Metric Path (tt-telemetry)

Schema:

```
{hostname}/tray{tray}/chip{chip}/cq{cq}/tt_dispatch_prefetch_command_count
```

Example path:

```
bh-glx-c09u02/tray1/chip2/cq0/tt_dispatch_prefetch_command_count
```

## Description

The number of commands the prefetch core for this command queue (CQ) processed — that is, pulled
from the host command queue and forwarded downstream — during the last telemetry collection
interval. This is a throughput gauge for the front of the fast-dispatch pipeline (host → prefetch
core → dispatch core → worker cores): how many dispatch commands are flowing in. It is a useful
companion to [tt_dispatch_program_count](tt_dispatch_program_count.md) (the pipeline's output rate)
when reasoning about how efficiently incoming commands turn into launched programs.

**This is a per-interval delta, not a monotonic total.** The device-side counter is reset each time
telemetry is read, so each sample reports only the commands processed since the previous collection
cycle. Do not apply Prometheus `rate()`/`increase()` as you would to a cumulative counter.

A separate metric is emitted for every command queue the chip can support (`cq0`, `cq1`, ...). CQs
absent from a given read, and chips whose firmware bundle is below version `19.12.0`, report the
default value of `0`.

## Values

**Type:** Unsigned Integer

**Units:** None

**Allowable values:**
A non-negative integer count of commands processed in the last interval. For example, `1024` means
the prefetch core processed 1024 commands since the previous read.

## Prometheus Labels

|Label Name|Value|
|---|---|
|hostname|The host from which the metric was collected.|
|hall|The datacenter hall where the host is located. Sourced from the Factory System Descriptor (FSD).|
|aisle|The datacenter aisle where the host is located. Sourced from the Factory System Descriptor (FSD).|
|rack|The rack number where the host is located. Sourced from the Factory System Descriptor (FSD).|
|shelf_u|The shelf U position in the rack where the host is located. Sourced from the Factory System Descriptor (FSD).|
|tray|The tray (UBB) that the device is located on.|
|chip|The ASIC location within the tray.|
|cq|The hardware command queue index (`0`, `1`, ...).|