# tt_dispatch_program_count

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

## Name

### Prometheus Metric Name

```
tt_dispatch_program_count
```

### Metric Path (tt-telemetry)

Schema:

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

Example path:

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

## Description

The number of programs the dispatch core for this command queue (CQ) launched onto worker cores
during the last telemetry collection interval. This is the output rate of the fast-dispatch
pipeline (host → prefetch core → dispatch core → worker cores). Comparing it against
[tt_dispatch_prefetch_command_count](tt_dispatch_prefetch_command_count.md) and the blocked/waiting
signals shows whether incoming commands are being converted into work efficiently or getting stuck
along the way.

**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 programs launched 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 programs launched in the last interval. For example, `256` means
the dispatch core launched 256 programs onto worker cores 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`, ...).|