# tt_ai_clock_mhz

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

## Name

### Prometheus Metric Name

```
tt_ai_clock_mhz
```

### Metric Path (tt-telemetry)

Schema:

```
{hostname}/tray{tray}/chip{chip}/tt_ai_clock_mhz
```

Example path:

```
bh-glx-c09u02/tray1/chip2/tt_ai_clock_mhz
```

## Description

The AI clock frequency of the ASIC in megahertz (MHz). This is the operating frequency of the AI processing cores on the chip. The value is read from ARC firmware telemetry. When a workload is running on the chip, the clock speed will ramp up to the limit value (`tt_ai_clock_limit_mhz`). A clock speed at or near the limit is therefore indicative of an active workload. This metric is only created if the device reports AI clock data; not all device configurations expose it.

## Values

**Type:** Unsigned Integer

**Units:** Megahertz (MHz)

**Allowable values:**
A non-negative integer representing the clock frequency. For example, a value of `1200` means the AI clock is running at 1200 MHz (1.2 GHz).

## Related Metrics

|Metric|Description|
|---|---|
|[tt_ai_clock_limit_mhz](tt_ai_clock_limit_mhz.md)|The AI clock frequency limit. Represents the hardware limit for this value.|

## 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.|
|unit|The unit of measurement. Always `"MHz"` for this metric.|