System Tools
============

Neuron system tools provide essential utilities for monitoring, debugging, and managing AWS Neuron devices and workloads. These command-line tools offer real-time insights into device utilization, process management, hardware health, and performance metrics across Neuron instances.

.. toctree:: 
    :maxdepth: 1
    :hidden:

    Neuron-Monitor User Guide </tools/neuron-sys-tools/neuron-monitor-user-guide>
    Neuron-Top User Guide </tools/neuron-sys-tools/neuron-top-user-guide>
    Neuron-LS User Guide </tools/neuron-sys-tools/neuron-ls>
    Neuron-Sysfs User Guide </tools/neuron-sys-tools/neuron-sysfs-user-guide>
    NCCOM-TEST User Guide </tools/neuron-sys-tools/nccom-test>
    TensorBoard </tools/tensorboard/index>

.. grid:: 1 1 2 2
   :gutter: 3

   .. grid-item-card:: Neuron-Monitor User Guide
      :link: /tools/neuron-sys-tools/neuron-monitor-user-guide
      :link-type: doc
      :class-header: sd-bg-primary sd-text-white

      Real-time monitoring tool for tracking NeuronCore utilization, memory usage, and thermal metrics across Neuron devices with customizable output formats.

   .. grid-item-card:: Neuron-Top User Guide
      :link: /tools/neuron-sys-tools/neuron-top-user-guide
      :link-type: doc
      :class-header: sd-bg-primary sd-text-white

      Interactive process viewer similar to htop that displays running processes on Neuron devices with real-time resource consumption metrics.

   .. grid-item-card:: Neuron-LS User Guide
      :link: /tools/neuron-sys-tools/neuron-ls
      :link-type: doc
      :class-header: sd-bg-primary sd-text-white

      Device discovery and listing tool that provides detailed information about available Neuron devices, their capabilities, and current status.

   .. grid-item-card:: Neuron-Sysfs User Guide
      :link: /tools/neuron-sys-tools/neuron-sysfs-user-guide
      :link-type: doc
      :class-header: sd-bg-primary sd-text-white

      Low-level system interface tool for accessing Neuron device information through the Linux sysfs filesystem interface.

   .. grid-item-card:: NCCOM-TEST User Guide
      :link: /tools/neuron-sys-tools/nccom-test
      :link-type: doc
      :class-header: sd-bg-primary sd-text-white

      Collective communication testing and benchmarking tool for validating and measuring performance of multi-device communication patterns.

   .. grid-item-card:: TensorBoard
      :link: /tools/tensorboard/index
      :link-type: doc
      :class-header: sd-bg-primary sd-text-white

      TensorBoard Neuron plugin for Trn1 instances, including installation, configuration, and advanced visualization features.

   .. grid-item-card:: Tutorials
      :link: /tools/tutorials/index
      :link-type: doc
      :class-header: sd-bg-secondary sd-text-white

      Tutorials for how to utilize the Neuron system tools suite.

   .. grid-item-card:: What's New
      :link: /release-notes/prev/2.27.0/index
      :link-type: doc
      :class-header: sd-bg-secondary sd-text-white

      Latest updates, new features, and improvements to the Neuron system tools suite.
