Saved Views
Save the filter, the columns, the sort and the time range of the trace list under a name. Apply a view, share it with the project, pin it and delete it.
Saved views are for the dashboard. An API key cannot reach them in this release.
What runs today: a signed-in person saves, applies, pins and deletes views in the Views menu of the Traces page.
What is not available: an API key cannot create or read a saved view in this release. The REST API reference lists the routes that a key can reach.
A saved view is a named copy of the state of the trace list. You apply it with one click instead of setting up the list again. The Views menu is next to the filter bar on the Traces page.
What a view stores
| Part | What the view keeps |
|---|---|
| Filter | The filter that is applied to the list, the one in the page address. Text that you typed and did not apply with Enter is not saved. A view may have an empty filter. See Filter Language |
| Columns | The columns that the list shows |
| Sort | The sort column and the sort direction |
| Time range | The time range of the list, for example Last 7 days |
A view does not store the open trace or the page of the list. It does not store an exact start and end, such as the window of a chart bucket. A view saved from such a window opens with the default range, Last 24 hours.
Save a view
Set up the list
Set the filter and press Enter to apply it. Then set the columns, the sort and the time range.
Open the form
Click Views, then Save view....
Name the view
Enter a View name of up to 120 characters.
Choose who sees it
Turn on Share with the project if every member of the project should see the view. The switch is off at first, so a view is personal.
Save
Click Save. The Views button now shows the name of the view.
The form says "Saves the filter, the columns, the sort and the window of the list as it is now." If a save fails, the form shows the reason:
- No name. "Enter a name for the view."
- Same name or too many views. "You already have a view with this name, or the most views you can have (200). Choose another name or delete a view."
- A filter that is not valid. The form shows the message of the filter. Risicare saves nothing.
- The filter cannot be checked. "The filter cannot be checked now, so the view was not saved. Try again in a few minutes."
Apply a view
Click Views, then the name of a view. The list takes the filter, the columns, the sort and the time range of the view, and nothing else. The Views button then shows the name of the view. The name stays for the current browser tab, also after a reload.
The Modified badge
After you apply a view, a change to the filter, the columns, the sort or the time range adds a Modified badge to the button. The view itself does not change. To keep the new state, save it as a new view.
Personal and shared views
| Personal view | Shared view | |
|---|---|---|
| Who sees it | You | Every member of the project |
| How the menu marks it | No mark | "shared" for the author, "shared with you" for others |
| Who can apply it | You | Every member |
| Who can pin or delete it | You | The author only |
The menu has no control to rename a view, to change who sees it, or to replace what it stores. To change a view, delete it and save it again.
Pin a view
Click the pin button next to a view that you saved. A pinned view has a pin icon and moves to the top of the menu. Click the button again to unpin it. Other members cannot pin or unpin your view.
Delete a view
Click the trash button next to a view that you saved. A dialog asks you to confirm. Click Delete view. The dialog says what happens:
- A personal view: "The view goes. The list keeps its current filter."
- A shared view: "The view goes for everyone in the project."
A deletion cannot be undone. Only the author can delete a view.
Limits
- A view name has at most 120 characters.
- You can have 200 views in one project. After that, a save fails with the message above. Delete views that you no longer use.
- The menu lists the 100 views that changed last, yours and the shared ones. When there are more, the menu says "Showing the 100 views changed last." A view that is not in the list cannot be applied from the menu.
- The menu reads the views when you open it.