Need help with profiler?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

233 Stars 38 Forks Apache License 2.0 329 Commits 41 Opened issues


A profiling and performance analysis tool for TensorFlow

Services available


Need anything else?

Contributors list

TensorFlow Profiler

The profiler includes a suite of tools. These tools help you understand, debug and optimize TensorFlow programs to run on CPUs, GPUs and TPUs.


First time user? Come and check out this Colab Demo.


  • TensorFlow >= 2.2.0
  • TensorBoard >= 2.2.0
  • tensorboard-plugin-profile >= 2.2.0

Note: The TensorFlow Profiler requires access to the Internet to load the Google Chart library. Some charts and tables may be missing if you run TensorBoard entirely offline on your local machine, behind a corporate firewall, or in a datacenter.

To profile on a single GPU system, the following NVIDIA software must be installed on your system:

  1. NVIDIA GPU drivers and CUDA Toolkit:
    • CUDA 10.1 requires 418.x and higher.
  2. Ensure that CUPTI 10.1 exists on the path.
   $ /sbin/ldconfig -N -v $(sed 's/:/ /g' <<< $LD_LIBRARY_PATH) | grep libcupti

If you don't see
on the path, prepend its installation directory to the $LDLIBRARYPATH environmental variable:
   $ export LD_LIBRARY_PATH=/usr/local/cuda/extras/CUPTI/lib64:$LD_LIBRARY_PATH

Run the ldconfig command above again to verify that the CUPTI 10.1 library is found.

If this doesn't work, try:

   $ sudo apt-get install libcupti-dev

To profile a system with multiple GPUs, see this guide for details.

To profile multi-worker GPU configurations, profile individual workers independently.

To profile cloud TPUs, you must have access to Google Cloud TPUs.

Quick Start

Install nightly version of profiler by downloading and running the
script from this directory.
$ git clone profiler
$ mkdir profile_env
$ python3 profiler/ --envdir=profile_env --logdir=profiler/demo
Go to
of your browser, you should now see the demo overview page show up. Overview Page Congratulations! You're now ready to capture a profile.

Next Steps

  • GPU Profiling Guide:
  • Cloud TPU Profiling Guide:
  • Colab Tutorial:

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.