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)
contentInitGitDurationThe duration of the git initializer step in seconds. This is set whenever a git clone is issued (mostly on first workspace start).
contentInitGitSizeThe size of the git initializer step result in bytes. This is set whenever a git clone is issued (mostly on first workspace start).
contentInitPrebuildDurationThe duration of the prebuild initializer step in seconds. This is set if the workspace is based on a prebuild.
contentInitPrebuildSizeThe size of the prebuild initializer step result in bytes. This is set if the workspace is based on a prebuild.
contentInitBackupDurationThe duration of the backup initializer step in seconds. This is set on subsequent workspace starts, when the file system is restored from backup.
contentInitBackupSizeThe size of the backup initializer step result in bytes. This is set on subsequent workspace starts, when the file system is restored from backup.
contentInitSnapshotDurationThe duration of the snapshot initializer step in seconds. This used for workspaces started from snapshots.
contentInitSnapshotSizeThe size of the snapshot initializer step result in bytes. This used for workspaces started from snapshots.
contentInitFileDownloadDurationThe duration of the file download initializer step in seconds. This is set for injecting additionalFiles into the workspace.
contentInitFileDownloadSizeThe size of the file download initializer step result in bytes. This is set for injecting additionalFiles into the workspace.
contentInitCompositeDurationThe duration of the composite initializer step in seconds. This reports the total if multiple steps are run to initialize the workspace content.
contentInitCompositeSizeThe size of the composite initializer step result in bytes. This reports the total if multiple steps are run to initialize the workspace content.
For even more information about the underlying workspace session data, please refer to our ListWorkspaceSessions API.