Tenstorrent DOCUMENTATION
  • Get Started
    Overview Installing Tenstorrent Software Manual Installation Deploy LLMs Learn by Building
  • Software
    TT-Forge TT-NN TT-Lang TT-MLIR TT-Metalium Cloud-Native Support
  • Hardware
    Blackhole Blackhole™ PCIe Cards TT-QuietBox TT-QuietBox 2 Wormhole Wormhole™ PCIe Cards TT-QuietBox TT-LoudBox™
  • Tools
    TT-Inference-Server TT-Studio TT-SMI TT-Toplike TT-NN Visualizer TT-Topology TT-VSCode-Toolkit TT-Blacksmith
  • Resources
    Request Support Developer Hub Join our Discord FAQ
Explore Github
Logo Cloud-Native Support
  • TT-Operator
  • Node Feature Discovery
  • Driver Manager
  • Telemetry
    • Metrics
    • Configuration
  • Fabric Manager
  • Device Allocation
  • Multi-Node Scheduling
Telemetry
  • Metrics
  • tt_ethernet_link_up
  • View page source

tt_ethernet_link_up

<< Home | << Metrics

Name

Prometheus Metric Name

tt_ethernet_link_up

Metric Path (tt-telemetry)

Schema:

{hostname}/tray{tray}/chip{chip}/channel{channel}/tt_ethernet_link_up

Example path:

bh-glx-c09u02/tray1/chip2/channel0/tt_ethernet_link_up

Description

Whether the Ethernet link is up on a specific channel. This metric reads the link status directly from device memory. The link status is periodically force-refreshed to ensure accuracy. When topology information is available (via Factory System Descriptor), additional labels provide details about the physical port and remote endpoint.

Values

Type: Boolean

Units: None

Allowable values:

  • True (1): The Ethernet link is up and operational.

  • False (0): The Ethernet link is down.

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.

Previous Next

© Copyright 2026, Tenstorrent AI ULC. Last updated on Jul 01, 2026.

Built with Sphinx using a theme provided by Read the Docs.
Version: latest
Versions
latest
v0.1.2
v0.1.1