All Products
Search
Document Center

Platform For AI:TensorBoard visualization

Last Updated:Jun 17, 2026

TensorBoard lets you visualize training metrics, model weights, and sample outputs from Deep Learning Containers (DLC) jobs. You can create TensorBoard instances to interactively explore and compare training results.

Prerequisites

Before you begin, make sure the following requirements are met:

  • A DLC training job with at least one dataset mounted (verify on the Overview tab). Supported storage types: Object Storage Service (OSS) and Apsara File Storage NAS.

  • TensorFlow's SummaryWriter integrated into the training script to write logs to a directory within the mounted dataset.

Write training logs

Add SummaryWriter to your training script to write logs to a path inside the mounted dataset. Close the writer after training to ensure all log data is flushed.

Example:

  • OSS dataset endpoint: oss://your-bucket-name.oss-region-internal.aliyuncs.com/dlc-training-data/

  • Dataset mount path in the container: /mnt/data/

  • Log output directory: /mnt/data/output/runs

import tensorflow as tf

# Initialize SummaryWriter with logging directory
log_dir = "/mnt/data/output/runs"
writer = tf.summary.create_file_writer(log_dir)

# Training loop with metric logging
for epoch in range(num_epochs):
    train_loss = calculate_loss()
    train_accuracy = calculate_accuracy()

    with writer.as_default():
        # Log scalar metrics
        tf.summary.scalar("train_loss", train_loss, step=epoch)
        tf.summary.scalar("train_accuracy", train_accuracy, step=epoch)

        # Log histograms and images every 10 epochs
        if epoch % 10 == 0:
            tf.summary.histogram("model_weights", model.weights, step=epoch)
            tf.summary.image("prediction_samples", sample_predictions, step=epoch)

# Close writer to ensure all logs are saved
writer.close()
print(f'Training completed successfully. Logs saved to: {log_dir}')

The SummaryWriter path (/mnt/data/output/runs) is the Summary Path specified when creating the TensorBoard instance.

Create a TensorBoard instance

  1. Log on to the PAI console. Select the region in the top navigation bar and select a workspace. Click Enter Deep Learning Containers (DLC).

  2. In the Actions column of the target job, click TensorBoard. In the panel, click Create TensorBoard.

  3. On the Create TensorBoard page, configure the parameters, then click OK.

Basic information

Parameter Description
Name Name of the TensorBoard instance.
Datasets Select a Configuration Type and specify the Summary Path (the directory containing TensorBoard summary logs defined in SummaryWriter of the training code).

The following table describes Configuration Type options.

Option Description
Mount Dataset Select a dataset and enter the relative path of the summary directory in the dataset.
Mount OSS Select an OSS storage path and enter the relative path of the summary directory in OSS.
By Task Select a DLC job and enter the complete path of log files in the container.

Resource configuration

Resource type Description
Free Quota Free resources provided by the system. Each instance can use up to 2 vCPUs and 4 GiB of memory. To free up quota, disable instances running on free resources, then use the released quota for a new instance.
General Computing Choose Public Resources or Resource Quota. See the following table for details.

The following table describes General Computing options.

Option Description
Public Resources Pay-as-you-go billing. Only general computing uses public resources. Select an instance type based on workload requirements.
Resource Quota Subscription billing. Before selecting this option, purchase computing resources and create quotas. This option is available only to whitelist users. Contact the account manager to enable it.

When using Resource Quota, configure these parameters:

Parameter Description
Priority TensorBoard instance priority. Valid values: 1 to 9. The value 1 indicates the lowest priority.
Job Resource Resources allocated to the TensorBoard instance: vCPUs and Memory (GiB).

VPC configuration

VPC parameters apply only when you use Public Resources. Without a VPC, the system connects over the Internet, which may cause slower TensorBoard startup or report loading due to limited bandwidth.

Important

If the TensorBoard instance uses a dataset that requires a VPC, such as Cloud Parallel File Storage (CPFS) or NAS with a VPC mount target, configure a VPC.

Select a VPC, vSwitch, and security group in the current region. After configuration, the cluster running the TensorBoard instance can access services in the selected VPC and uses the specified security group for access control.

View TensorBoard reports

  1. In the left-side navigation pane of the workspace page, choose AI Computing Asset Management > Job.

  2. On the TensorBoard tab, check the Status column. When the status is Running, click View TensorBoard in the Actions column.

The TensorBoard page displays your training metrics and logged data, such as scalar trends, histograms, and images.

Manage TensorBoard instances

  1. Log on to the PAI console. Select the region in the top navigation bar and select a workspace. Click Enter Jobs.

  2. On the TensorBoard tab, perform any of the following operations:

Operation Steps
Start an instance Click Start in the Actions column to restart a stopped instance
View instance details Click the instance name to open the details page showing Basic Information and Configuration Information
View associated DLC jobs In the Associated Task column, hover over the icon to view the job ID. Click the ID to open the job details page
View associated datasets In the Associated Dataset column, hover over the icon to view the dataset ID. Click the ID to open the dataset details page
View running duration The Running Duration column shows how long the instance has been running since the last start. Duration resets when the instance is stopped
Stop an instance Click Stop in the Actions column. To schedule automatic stop time, click Auto-stop Settings in the Actions column

Troubleshooting

Issue Solution
TensorBoard fails to start Verify dataset mounting on the Overview tab. Confirm the log path exists within mounted storage. Check Resource Access Management (RAM) permissions for dataset access
Reports load slowly Reduce log frequency for high-volume experiments. Consider using incremental log processing or organizing logs into smaller subdirectories
Access denied or connectivity errors Validate network connectivity and RAM permissions. Check security group configurations. If using a VPC-dependent dataset, ensure the TensorBoard instance is configured with the same VPC
High CPU or memory usage Monitor resource utilization. If using Free Quota, consider switching to General Computing with more resources

Best practices

  • Start with 2 to 4 vCPUs and 4 to 8 GiB of memory for typical workloads.

  • Organize logs by experiment type and timestamp (for example, /mnt/data/output/runs/experiment_type/date_time/).

  • Clean up obsolete training logs regularly to reduce storage costs and improve performance.

  • Use RAM role assignments to restrict TensorBoard instance access to authorized team members.

References