Skip to content

chore(docs): add info on new build timings in docs #15310

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 9 commits into from
Nov 1, 2024
Merged

chore(docs): add info on new build timings in docs #15310

Show file tree
Hide file tree
Changes from 1 commit
Commits
Show all changes
9 commits
Select commit Hold shift + click to select a range
a343419
added workspace startup times
stirby Oct 31, 2024
59e08e2
added to workspace lifecycle docs
stirby Oct 31, 2024
4aafa86
fix troubleshooting link
stirby Oct 31, 2024
a721357
added future link for build timings guide
stirby Oct 31, 2024
f39e3f8
Merge branch 'main' into ws-build-time-docs
stirby Nov 1, 2024
cbc5a86
reorged troubleshooting section
stirby Nov 1, 2024
5ee74d1
docs fixup on workspace lifecycle section
stirby Nov 1, 2024
122035d
version mention
stirby Nov 1, 2024
a7f22be
fmt
stirby Nov 1, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Prev Previous commit
fmt
  • Loading branch information
@stirby
stirby committed Nov 1, 2024
commit a7f22be95b6f0afe7e9b2673831fefd7b11e11dd
5 changes: 2 additions & 3 deletions docs/admin/templates/troubleshooting.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -159,13 +159,12 @@ the top of the script to exit on error.

If your workspaces are taking longer to start than expected, or longer than
desired, you can diagnose which steps have the highest impact in the workspace
build timings UI (available in v2.17 and beyond). Admins can can programmatically pull startup times for individual workspace builds using our
build timings UI (available in v2.17 and beyond). Admins can can
programmatically pull startup times for individual workspace builds using our
[build timings API endpoint](../../reference/api/builds.md#get-workspace-build-timings-by-id).


See our
[guide on optimizing workspace build times](../../tutorials/best-practices/speed-up-templates.md)
to optimize your templates based on this data.

![Workspace build timings UI](../../images/admin/templates/troubleshooting/workspace-build-timings-ui.png)

7 changes: 4 additions & 3 deletions docs/user-guides/workspace-lifecycle.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -111,9 +111,10 @@ workspace startup scripts.

## Workspace build times

After a successful build, you can see a timing breakdown
of the workspace startup process from the dashboard (starting in v2.17). We capture and display both time taken to
provision the workspace's compute and agent startup steps. These include any
After a successful build, you can see a timing breakdown of the workspace
startup process from the dashboard (starting in v2.17). We capture and display
both time taken to provision the workspace's compute and agent startup steps.
These include any
[`coder_script`](https://registry.terraform.io/providers/coder/coder/latest/docs/resources/script)s
such as [dotfiles](./workspace-dotfiles.md) or
[`coder_app`](https://registry.terraform.io/providers/coder/coder/latest/docs/resources/app)
Expand Down