Insights

Gitpod Insights is a feature that allows organization owners to monitor the usage and adoption of Gitpod in their organization.

The Insights page is accessible to organization owners from the Organization Menu in the top-left corner of the Gitpod dashboard and offers the following:

  • A list of all workspaces created in your organization (sorted from most to least recently created) with the following details:
    • Workspace owner (user)
    • Workspace ID
    • Workspace Class and type (meaning workspace or prebuild)
    • Context URL
    • An expandable section with details about all workspace starts
  • A button for exporting the insights data to a CSV file with additional details, including:
    • Detailed timestamps for events such as the workspace creation, deployment, start and stop
    • Workspace metrics such as the size of the workspace image
    • The configured workspace timeout
    • The editor and its version selected when the workspace was created
    • (If applicable) the ID of the prebuild that was used to start the workspace
    • (If applicable) the ID of the imported repository

A detailed list of all properties in the CSV export can be found below:

PropertyDescription
idThe unique identifier for the session
creationTimeThe timestamp when the workspace was created
deployedTimeThe timestamp when the workspace was deployed
startedTimeThe timestamp when the workspace entered the running state
stoppingTimeThe timestamp when the workspace transitioned into the stopping state
stoppedTimeThe timestamp when the workspace transitioned into the stopped state
workspaceIDThe unique identifier for the workspace
configurationIDThe unique identifier for the imported repository
prebuildIDThe unique identifier for the prebuild
userIDThe unique identifier for the user who created the workspace
userNameThe name of the user who created the workspace
contextURLThe full context URL (e.g. https://github.com/gitpod-io/gitpod/pull/316)
contextURL_cloneURLThe clone URL of the context (e.g. https://github.com/gitpod-io/gitpod.git)
contextURLSegment_1The first parsed segment of the context URL (e.g. gitpod-io/subgroup for https://github.com/gitpod-io/subgroup/gitpod)
contextURLSegment_2The second parsed segment of the context URL (e.g. gitpod for https://github.com/gitpod-io/subgroup/gitpod)
workspaceTypeThe type of workspace (can be workspace or prebuild)
workspaceClassThe class of the workspace
workspaceImageSizeThe size of the workspace image
workspaceImageTotalSizeThe total size of the workspace image
timeoutThe configured workspace timeout in seconds
editorThe ID of the editor selected when the workspace was created
editorVersionThe version of the editor selected when the workspace was created (can be stable or latest)

For even more information about the underlying workspace session data, please refer to our ListWorkspaceSessions API.

Was this page helpful?