Using Tensorboards in Gradient

How to create a Tensorboard instance in Gradient

Gradient TensorBoards are a Gradient Installer feature. Contact Sales for inquiries!

Gradient Installer customers are able to create TensorBoards, add experiments to them, and remove experiments from them. You can do this via the Web UI or the CLI.

TensorBoards are currently associated with experiments directly, though TensorBoards as a first-class concept in the Gradient UI is coming soon.

From any Experiment Details view, you can add any experiment, across all team projects, to any TensorBoard.

You'll see all of your team's TensorBoards listed under any Experiment Details view, though you can filter TensorBoards down only to show the ones that contain Experiments from within the current Project.

Create a TensorBoard

Web UI
CLI
Web UI

To create a TensorBoard, whether your team already has multiple or has none, 1) navigate to Projects and click into any Experiment to see its Details page; 2) click TensorBoards; and 3) click Create TensorBoard.

Steps to Create a TensorBoard via the Web UI

Clicking Create TensorBoard will launch the following modal, where you can add a Name for your TensorBoard, as well as optional Username and Password for basic authentication. Then click Create TensorBoard.

Create TensorBoard modal

By default, if you have zero TensorBoards, the current experiment will be automatically added to your first TensorBoard.

You can then see a mapping between the current Experiment (the one whose Details page you're working from) and all TensorBoards, with the Experiment Status in relation to each TensorBoard, as well as the name and ID of each of your team's TensorBoards, and that TensorBoard's status.

Experiment being added to a new TensorBoard

Note that although you can technically add an Experiment that has not completed, or that has failed, to a TensorBoard, it will not be complete Adding to a given TensorBoard until that Experiment has completed.

CLI

You can create a TensorBoard with the following command:

gradient tensorboards create

Options:

Usage: gradient tensorboards create [OPTIONS]
Create new tensorboard
Options:
--experiment TEXT IDs of experiments [required]
--image TEXT Image
--username TEXT Username
--password TEXT Password
--apiKey TEXT API key to use this time only
--optionsFile PATH Path to YAML file with predefined options
--createOptionsFile PATH Generate template options file
--help Show this message and exit.

Viewing a TensorBoard

If a TensorBoard has had Experiments added to it, simply click Launch to open the TensorBoard in order to view the resultant TensorBoard and experiment visualizations:

Launch a TensorBoard that's had Experiments added to it

Here's a TensorBoard showing the Experiment that I added above, which is displaying a model from a simple MNIST sample experiment:

Experiment visualized on a TensorBoard in Gradient

Adding and Removing Experiments

Web UI
CLI
Web UI

You can manually Add or Remove an experiment from a TensorBoard by clicking the green toggle under Experiment Status. In other words, if you wish to add an Experiment to a TensorBoard (thus including it on that TensorBoard), click the Experiment Status toggle to be active / green / to the right.To remove an Experiment from a TensorBoard, click the toggle to be inactive / gray / to the left.

Removing an Experiment from a TensorBoard

As noted above, you can re-add an Experiment to a TensorBoard simply by toggling the Experiment Status back to active / green / to the right.

Note that because TensorBoards spin up on dedicated CPU-only machine instances, and Experiments must have completed checkpoints in order to be added to TensorBoards, the Create, Add, and Remove operations can take time.

And that's it! Stay tuned for further iteration as we continue to make TensorBoards an even more powerful feature.

CLI

Adding Experiments to a existing tensorboard

gradient tensorboards add-experiments

Options:

Usage: gradient tensorboards add-experiments [OPTIONS]
Update tensorboard experiments
Options:
--id TEXT Tensorboard ID [required]
--experiment TEXT IDs of experiments [required]
--apiKey TEXT API key to use this time only
--optionsFile PATH Path to YAML file with predefined options
--createOptionsFile PATH Generate template options file
--help Show this message and exit.

Removing Experiments from a tensorboard

gradient tensorboards remove-experiments

Options:

Usage: gradient tensorboards remove-experiments [OPTIONS]
Update tensorboard experiments
Options:
--id TEXT Tensorboard ID [required]
--experiment TEXT IDs of experiments [required]
--apiKey TEXT API key to use this time only
--optionsFile PATH Path to YAML file with predefined options
--createOptionsFile PATH Generate template options file
--help Show this message and exit.

Delete Tensorboard

You can delete a TensorBoard instance via the CLI, as follows.

CLI
CLI

To delete a TensorBoard, run the following command:

gradient tensorboards delete --id <tensorboard-id>

Options:

Usage: gradient tensorboards delete [OPTIONS]
Delete tensorboard
Options:
--id <tensorboard ID> Tensorboard ID [required]
--apiKey TEXT API key to use this time only
--optionsFile PATH Path to YAML file with predefined options
--createOptionsFile PATH Generate template options file
--help Show this message and exit.

Learn More

You can also use TensorBoards via the CLI, as well as by scripting them within a TensorFlow script.