# tt_ethernet_error_status

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

## Name

### Prometheus Metric Name

```
tt_ethernet_error_status
```

### Metric Path (tt-telemetry)

Schema:

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

Example path:

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

## Description

The raw value of the `ETH_CTRL` `ERR_STAT` register for a specific Ethernet channel. This register is
part of the Ethernet MAC/PCS control block and reports link error status. This metric is only available
on Blackhole devices.

Unlike the codeword and CRC metrics (which read L1 addresses resolved through the HAL), `ERR_STAT` is a
hardware MMIO register (`ETH_CTRL` block base `0xFFB98000`, offset `0xD8`, i.e. `0xFFB980D8`). It is read
directly using the Strict-ordered register read path so that the access uses proper volatile register
semantics rather than the relaxed block-read path used for L1 memory.

The value is exposed as the unmodified 32-bit register contents; interpretation of individual bits
requires the Blackhole `ETH_CTRL` register specification.

## Values

**Type:** Unsigned Integer

**Units:** None

**Allowable values:**
A 32-bit unsigned integer holding the raw `ERR_STAT` register contents.

## 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.|