# tt_ethernet_heartbeat

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

## Name

### Prometheus Metric Name

```
tt_ethernet_heartbeat
```

### Metric Path (tt-telemetry)

Schema:

```
{hostname}/tray{tray}/chip{chip}/channel{channel}/tt_ethernet_heartbeat
```

Example path:

```
bh-glx-c09u02/tray1/chip2/channel0/tt_ethernet_heartbeat
```

## Description

Whether the Ethernet firmware heartbeat is alive for a specific channel. This monitors the device firmware's heartbeat counter via ARC telemetry. If the heartbeat stops incrementing, it indicates the Ethernet firmware on that channel may be hung. Note: this is a device-level check -- all channels on the same device share the same underlying heartbeat status. This metric is only created if Ethernet heartbeat data is available from ARC telemetry.

## Values

**Type:** Boolean

**Units:** None

**Allowable values:**
- **True (1)**: The Ethernet firmware heartbeat is alive and incrementing.
- **False (0)**: The heartbeat has stopped, indicating a potential firmware issue.

## 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.|
|channel|The Ethernet channel number on the chip.|
|port_type|The physical port type (e.g., QSFP, backplane). Present when topology information is available.|
|port_id|The physical port ID. Present when topology information is available.|
|remote_hostname|The hostname of the remote endpoint. Present when remote endpoint information is available.|
|remote_tray|The tray number of the remote endpoint. Present when remote endpoint information is available.|
|remote_chip|The ASIC location of the remote endpoint. Present when remote endpoint information is available.|
|remote_channel|The Ethernet channel of the remote endpoint. Present when remote endpoint information is available.|
|remote_hall|The datacenter hall of the remote endpoint. Present when remote endpoint information is available.|
|remote_aisle|The datacenter aisle of the remote endpoint. Present when remote endpoint information is available.|
|remote_rack|The rack number of the remote endpoint. Present when remote endpoint information is available.|
|remote_shelf_u|The shelf U position of the remote endpoint. Present when remote endpoint information is available.|