Google is committed to advancing racial equity for Black communities. See how.

Launch Fuchsia DevTools

With Fuchsia DevTools, you can:

  • View CPU and memory usage on your device.
  • Focus on relevant log messages with keyword filtering and scoping logs by process, severity, or time frame
  • Observe package updates on your device as you rebuild and restart components
  • Monitor a component by watching for changes in its Inspect tree

Follow these instructions to install and start Fuchsia DevTools.

Before you start Fuchsia DevTools

Fuchsia DevTools is a Flutter Desktop application that runs on macOS and Linux.

Make sure you have a package server running by following the instructions to set up Fuchsia for in-tree development.

Start Fuchsia DevTools

In a new terminal, start Fuchsia DevTools from your fuchsia directory:

  fx fdt

If this is your first time running Fuchsia DevTools, you will be prompted to run the following command in a terminal window before proceeding:

jiri init -fetch-optional=fuchsia_devtools && jiri fetch-packages --local-manifest=true

After running the command, start Fuchsia DevTools again:

  fx fdt

If you don't want to update your Fuchsia directory with jiri update, or if you want to run the very latest version of Fuchsia DevTools, use the following command in a terminal window:

  fx fdt latest

Targeting a specific Fuchsia instance

If you have one device or emulator running, it's generally not necessary to specify the name or address of the Fuchsia device or the emulator you want to run Fuchsia DevTools against. However, if Fuchsia DevTools can't find your target, you can set the $FDT_DEVICE environment variable to your desired device name or address.

Example of an IPV4 address:

FDT_DEVICE="" fx fdt

Example of an IPV6 address with an SSH port:

FDT_DEVICE="[2001:db8::10]:8022" fx fdt

Example of a device name:

FDT_DEVICE="step-atom-yard-juicy" fx fdt

Use Fuchsia DevTools

You can use Fuchsia DevTools to do the following:

Examine CPU Usage

Examine memory usage

Search and filter log messages from a device

Inspect component properties for debugging

Check if an updated package exists on your device