# tt_dispatch_dispatch_blocked_count

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

## Name

### Prometheus Metric Name

```
tt_dispatch_dispatch_blocked_count
```

### Metric Path (tt-telemetry)

Schema:

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

Example path:

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

## Description

The number of times the dispatch core for this command queue (CQ) became blocked waiting on its
upstream (the prefetch core) during the last telemetry collection interval. Whereas
[tt_dispatch_dispatch_waiting_on_upstream](tt_dispatch_dispatch_waiting_on_upstream.md) is an
instantaneous flag, this counts stall *events*: a rising value means the dispatcher is regularly
running dry between commands because the prefetcher is not keeping it fed.

**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 events that occurred 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 dispatch stall events in the last interval. For example, `5` means
the dispatch core blocked on the prefetch core 5 times 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`, ...).|