Share Errors and Cluster State with Snapshots
As this feature is new and being improved the screenshots here may not exactly match what is currently in the UI. Thanks for understanding!
What is a snapshot?
A snapshot is a link that you can send to someone that will allow them to interactively explore your current Tilt state. This is useful for async debugging and adding context to bug reports. They look like pretty much just like Tilt, but frozen in time:
A snapshot is a frozen “moment-in-time” version of the Tilt UI. In a snapshot you can drill in to specific services, see alerts and Kubernetes events. Pretty much anything you can do in normal Tilt, you can do in a snapshot!
If you have upgraded Tilt since Snapshots were released, you’ll have a button in the Tilt web UI:
If you click this button a modal will appear.
If you haven’t already connected Tilt to Tilt Cloud, you’ll need to click a couple buttons to create a Tilt Cloud account:
Once you’ve done that, just click “Get Link” and you should be presented with a URL that looks something like this: https://cloud.tilt.dev/snapshot/AYSV59gLhM3GVMuuR28=.
Click the button that appeared to see the snapshot. Or you can take the generated link, post it in a Slack channel, bug report or on Twitter so anyone will be able to what you were seeing in Tilt when you ran in to an issue.
You can view and delete all of the snapshots associated with your account on Tilt Cloud. Go to https://cloud.tilt.dev/snapshots (this is also linked from the bottom of the “Share Snapshot” window). This will display a list of all of your snapshots, with a button to delete the ones you don’t want anymore.
Q: What data do you store for each snapshot?
For each snapshot we store the entirety of your Tilt’s state, including all logs and build history. In addition we store two pieces of metadata: the time that the snapshot was taken and the user, if any, that created it.
Q: How private are snapshots?
A snapshot is accessible to anyone who has the link, which includes an unguessable ID. We are working on private team snapshots, where only signed in team members have access to these team snapshots.
Q: I’m worried about app devs accidentally posting snapshots with secrets or private data. How can I disable snapshots?
directive to your Tiltfile.
Q: If I delete a snapshot is any data retained?
No. If you delete a snapshot all associated data is removed from the data store. There is no soft delete.
Q: What data do you store when I create a Tilt Cloud account?
Our database table for users looks like this:
id | name | provider | provider_user_id | provider_user_name ----+----------------+----------+------------------+-------------------- 2 | Mary Miranda | github | 1234567 | mmiranda
Q: Sometimes I get a 500 error when creating a snapshot. Is that expected?
There’s a known bug for larger snapshots.