tt_process_count

<< Home | << Metrics

Name

Prometheus Metric Name

tt_process_count

Metric Path (tt-telemetry)

Schema:

{hostname}/processes/tt_process_count

Example path:

bh-glx-c09u02/processes/tt_process_count

Description

The number of distinct host processes that currently hold an open handle to a Tenstorrent kernel-mode driver (KMD) device. It is computed by scanning each per-device directory under /proc/driver/tenstorrent/, reading the pids file in each, and counting the union of all PIDs. A process attached to more than one device is counted only once (duplicate PIDs are removed).

This is a host-level metric (not scoped to a tray or chip path). It is driver-independent: it reads procfs directly and does not require UMD/driver initialization, so it persists across warm resets. It is only created when device telemetry collection is enabled, and its value is refreshed on every collection cycle. If no Tenstorrent device directories are found under /proc/driver/tenstorrent/, a warning is logged and the value is reported as 0.

Values

Type: Unsigned Integer

Units: None

Allowable values: Non-negative integer representing the number of distinct processes holding a handle to any Tenstorrent device (for example 0 when no process has a device open, or 3 when three distinct processes hold handles).

Related Metrics

Metric	Description
tt_chip_count	Number of Tenstorrent chips discovered on the host via PCI device enumeration.
tt_driver_initialized	Whether the device driver is initialized. tt_process_count is assessed independently of driver initialization.

Prometheus Labels

Label Name	Value
hostname	The host from which the metric was collected.