> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vessl.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Explore workspaces

# Launch a JupyterLab session

<div style={{ marginBottom: '100px', position: 'relative', paddingTop: '400px' }}>
  <iframe src="https://demo.arcade.software/miHNOpgs7GapArIDZm5z?embed" frameBorder="0" loading="lazy" webkitAllowFullScreen="" mozAllowFullScreen="" title="Dashboards" style={{ position: 'absolute', top: '0px', left: '0px', width: '100%', height: '500px', colorScheme: 'light' }} />
</div>

Each running workspace has an activated JupyterLab. You can open a new JupyterLab session inside the workspace by clicking the icon below **Quicktool**.

# SSH session

<div style={{ marginBottom: '100px', position: 'relative', paddingTop: '400px' }}>
  <iframe src="https://demo.arcade.software/aqrWzJ5pPGRq3HpIUWjU?embed" frameBorder="0" loading="lazy" webkitAllowFullScreen="" mozAllowFullScreen="" title="Dashboards" style={{ position: 'absolute', top: '0px', left: '0px', width: '100%', height: '500px', colorScheme: 'light' }} />
</div>

You can access an active SSH session using **Quicktool**. The `SSH into workspace` modal allows you to SSH into a specific workspace using VESSL CLI, VSCode, or terminal.

<Card title="Create an SSH connection" icon="link" href="/guides/workspace/ssh">
  Jump into the next session if you're looking forward to how to create an SSH connection.
</Card>

# Metadata

The Metadata section helps you to find the workspace configuration such as resource usage and mounted images.

<img style={{ borderRadius: '0.5rem' }} src="https://mintcdn.com/vesslai/ONhMTXRTdM7mlkKv/images/workspace/explore/workspace_metadata.png?fit=max&auto=format&n=ONhMTXRTdM7mlkKv&q=85&s=8b4e3573ae07a1e6970aafbef904866e" width="2940" height="1548" data-path="images/workspace/explore/workspace_metadata.png" />

# Logs

The Logs section enables monitor the workspace container logs. When you create a workspace, a Docker specific to the workspace is created.

<img style={{ borderRadius: '0.5rem' }} src="https://mintcdn.com/vesslai/ONhMTXRTdM7mlkKv/images/workspace/explore/workspace_logs.png?fit=max&auto=format&n=ONhMTXRTdM7mlkKv&q=85&s=b03fcbb92596dc9cb44b5da7ff78ac93" width="1440" height="968" data-path="images/workspace/explore/workspace_logs.png" />

<Accordion title="Logs breakdown">
  * **Timestamp**\
    Each log entry is prefixed with a timestamp indicating when the event occurred. This helps in tracking the chronological order of events.

  * **Workload Status**\
    Displays the current status of the workload, such as "pending," "initializing," "running," and "stopping." These statuses provide insights into the lifecycle of the workload.

  * **Container Management**

  * **Assignment:** Shows the node or resource to which the workload has been assigned. Example: `afcwn4qtal66/workspace-858ri8oukgmj-0` was assigned to `10.191.91.189`.

  * **Container Operations:** Logs the creation, starting, and stopping of containers. For example:

    * `Created container workspace`
    * `Started container fluentbit`
    * `Stopping container fluentbit`

    These logs help users understand resource allocation and the container lifecycle.

  * **Resource Utilization**

    * **Image Pulling:** Logs the pulling of images, including whether the image was already present on the machine. Example: `Container image "quay.io/vessl-ai/python:3.10-r18" already present on machine`.
    * **Volume Attachment:** Logs successful volume attachments, such as: `AttachVolume.Attach succeeded for volume "csi-52e2cfaf-ddf3-4ec5-aa18-965ece67ee78"`.

  * **Package Installation**

  * **Dependencies:** Records the installation of Python packages and any warnings or errors encountered, useful for debugging dependency issues. Example:
    * `CryptographyDeprecationWarning: TripleDES has been moved to cryptography.hazmat.decrepit.ciphers.algorithms.TripleDES and will be removed from this module in 48.0.0.`

  * **CLI Tools:** Logs the installation and version of command-line tools, like VESSL CLI. Example:
    * `Installing VESSL CLI...`
    * `vessl, version 0.1.173`

  * **Execution and Termination**

    * **Process Execution:** Logs the execution of key processes or commands. Example: `JupyterLab is running`.
    * **Termination Requests:** Indicates when a workload has been requested to terminate and logs the stopping of containers, providing insight into how and when processes are being concluded. Example:
      * `Stop triggered by wayne`
      * `Workload status changed to stopping`
      * `Stopping container fluentbit`
      * `Stopping container workspace`
</Accordion>

# Monitoring

The Monitoring section enables monitor system metrics such as usage and limit for CPU, GPU, memory, and disk.

<img style={{ borderRadius: '0.5rem' }} src="https://mintcdn.com/vesslai/ONhMTXRTdM7mlkKv/images/workspace/explore/workspace_monitoring.png?fit=max&auto=format&n=ONhMTXRTdM7mlkKv&q=85&s=5dd85327beaa0278e2351feaf55f96df" width="1440" height="968" data-path="images/workspace/explore/workspace_monitoring.png" />
