This feature is in Early Access (EA), and might not be visible in your app. To learn
more about this program and the features it contains, see the
Early access page.
Update the on-call dashboard and its monitors for the new checkout-v2 service.
When Operator uses a workspace
Operator edits the dashboard or notebook you have open in place, as described in Operator capabilities. It writes to a workspace when it can’t change the page that you’re viewing, such as:- Changes to monitors, SLOs, and notification policies.
- Changes to several resources at once.
- Changes to a dashboard or notebook that isn’t open.
- Requests that you make from a page unrelated to the resource.
Open a workspace
After Operator writes its first file, the workspace appears in the conversation. Where it appears depends on the surface and the width of the window:- On the full page with enough room beside the conversation, a Workspace card lists the files.
- In the side panel or a narrow window, a card at the foot of the conversation
summarizes the changes, such as
2 workspace changes. Click Open workspace to review to move the conversation to the full page with the workspace open.
Review a file
Select a file to open it in the viewer. The viewer offers up to three views:- Preview renders the draft as the resource appears in XCOR. Dashboards, notebooks, monitors, and SLOs have previews.
- Source shows the file contents. The source is read-only. To change the file, ask Operator. Click Copy source to copy it.
- Diff compares the file with the existing resource. The view appears only for a resource that already exists and differs from the file. The header reads Compare with existing followed by the resource type, and badges count the lines added and removed.
Save or create a resource
Apply files one at a time. Workspaces have no action to approve every file at once. XCOR validates each change and applies it with your permissions, the same as when you edit the resource manually. To save a file to an existing resource:- Open the file and review its Preview and Diff views.
- Click Save.
- In the Save changes to dialog, confirm the resource, and then click Save.
- Open the file and review its Preview view.
- Click Create.
- In the Create dialog, enter a name. The name defaults to the filename.
- Select a collection. Notebooks default to your user collection and can’t belong to a service collection. Dashboards, monitors, and SLOs default to your personal collection, and you can select a team or other collection instead.
- Click Create.
No changes to save when the file
matches the resource. If Operator later changes the file, Save becomes available
again.
Resolve out-of-date files
Save is locked when the live resource changed after Operator wrote the file or after you last saved it. The lock prevents a save from overwriting changes made by someone else. A lock icon appears on the button, and the tooltip explains the cause:The dashboard was changed on DATE, after this file was written.The resource changed in XCOR and the file didn’t.This file and the dashboard have both changed since this file was applied.Both the resource and the file changed since you last saved.
Resources managed in code
XCOR blocks Save for dashboards and notebooks that you manage with Terraform, Chronoctl, the Kubernetes operator, or Prometheus sync. The tooltip readsThis dashboard is managed by Terraform. Edit it there to save changes., naming the
resource type and the source.
XCOR doesn’t confirm whether monitors, SLOs, and notification policies are
managed in code. Before you save one, confirm that no code repository manages it.
Otherwise, the next apply from your code overwrites your change.
Terraform files, which have a .tf extension, and other file types are source only.
To use Terraform files that Operator drafts, copy the source and apply it through your
existing Terraform workflow.
Share a workspace
A workspace is shared with its conversation. To share a draft, copy the link to the conversation as described in Share a conversation. Anyone in your tenant who has the link can open the conversation and its workspace. Recipients see the conversation as read-only. They can open, preview, and compare each file, but they can’t ask Operator to change your draft. Recipients with a role that grants edit permissions can also create or save files from your draft. To build on a draft, a recipient starts a new chat.Availability and limitations
- Workspaces are available only in saved conversations. Accounts in temporary mode don’t have a workspace for their own conversations.
- A workspace lives as long as its conversation. You can’t rename or delete either.
- Workspaces can save changes to existing notification policies but can’t create one. A policy’s diff shows the entire policy, because saving a policy changes routing for every monitor that uses it.
- Diff requires that the resource already exists in XCOR.
- Rate any Operator response to report what worked and what didn’t. See Rate a response.