Skip to content

Viewing Detailed Workspace Information

Once you have one or more Workspaces running, you can drill down into each Workspace’s details to monitor resource usage, health, and configuration. This section describes the various tabs and panels that provide insights into your Workspace’s status, including GPU utilization, node allocation, and telemetry data.

Accessing the Workspace Details

  1. Open the Workspaces Dashboard

    • In the left navigation menu, select Workspaces.
    • Find the Workspace you wish to stop in the list.

    Workspace Dashboard

  2. Select a Workspace

    • Locate the card of the Workspace you wish to inspect.
    • Highlight the card by hovering over it with your mouse (you will see a blue outline around it), then click near the Workspace Name to open its detailed view.

Workspace Details Overview

When you click on a specific workspace from the Workspaces overview, you're taken to its detailed view. The Pods tab, shown here, is the default view, providing a snapshot of the underlying components that make your workspace run.

Workspace Details View

This screen gives you a comprehensive look at your workspace's setup, resource usage, and its current activity.

Workspace Summary

At the top, you'll find key information about your workspace:

  • Workspace Name & Status: Clearly identifies your workspace (e.g., Workspace: ws-purple) and its current status (e.g., Ready).

  • UID: An internal identifier for your workspace (e.g., proj-blue/ws-purple).

  • Quick Actions: Buttons for immediate control over your workspace:

  • Stop: To temporarily halt your workspace's operation.

  • Connect: To access and work within your workspace environment (e.g., launch a Jupyter interface).
  • Delete: To permanently remove your workspace. Use with caution, as this action cannot be undone.

Resource and Activity Overview

Below the main header, cards summarize your workspace's allocated resources and its history:

  • Project: The project your workspace belongs to (e.g., proj-blue), potentially with a priority tag (e.g., High).
  • Requested Resources:
  • Requested GPUs: Number of GPUs allocated (e.g., 1).
  • Requested CPU Cores: Number of CPU cores allocated (e.g., 1).
  • Requested Memory: Amount of memory (in GiB) allocated (e.g., 1GiB).
  • Utilization: Real-time display of how much of the allocated GPU and CPU resources are currently being used (e.g., 0.00%).
  • Created At: The exact date and time your workspace was created (e.g., 2025-06-13 15:14:34).
  • Age: How long your workspace has been in existence (e.g., 30m 50s).

Workspace Detail Tabs

These tabs allow you to explore different aspects of your workspace's details:

  • Pods: This tab lists the individual computational units (Kubernetes pods) that make up your workspace.
  • Storages: This tab displays information about any persistent storage volumes attached to your workspace.
  • Metrics: This tab typically provides detailed graphs and performance metrics related to your workspace's resource utilization over time.
  • Conditions: This tab would show any notable events or conditions affecting your workspace's state.

Pods Tab

Under the Pods tab, a table provides specific details for each pod running your workspace:

  • Name: The unique name of the pod (e.g., ws-purple-0).
  • Ready Containers: Indicates how many containers within the pod are currently ready and running versus the total expected (e.g., 1/1 means all containers are ready).
  • Status: The current operational state of the pod (e.g., Running).
  • Restarts: The number of times the pod has restarted since it was created. A low number is ideal.
  • IP: The internal IP address assigned to the pod.
  • Node: The specific compute node where this pod is running (e.g., mvai-nvgpu01).

Storages Tab

This tab shows mapping information for storage volumes associated with your Workspace:

Storages Tab

Metrics Tab

This tab shows live, graphical information about Workspace utilization of GPU, GPU Memory, CPU, and CPU Memory:

Metrics Tab

Conditions Tab

This tab shows information pertaining to the Workspaces associated pods and containers, as well other status related information for the Workspace:

Conditions Tab

Benefits of the Workspace Details View

  • Monitor Workspace Health: Quickly check the status of your workspace and its underlying pods.
  • View Resource Allocation: Confirm the GPUs, CPU cores, and memory allocated to your workspace.
  • Track Utilization: See real-time how much of your allocated resources your workspace is currently using.
  • Connect to Your Workspace: Use the Connect button to access your workspace environment.
  • Control Workspace Lifespan: Use Stop or Delete buttons to manage your workspace as needed.

Best Practices

  • Regular Monitoring: Check GPU, CPU, and memory usage periodically to ensure you’re using the correct resource configurations.
  • Investigate Conditions: Address warnings or errors promptly to maintain a healthy Workspace environment.
  • Manage Storage: Attach or resize volumes as your dataset grows.
  • Optimize Node Selection: If performance is lagging, consider adjusting Node Group assignments or upgrading hardware resources.