Collections
A collection is a group of Chronosphere Observability Platform resources, such as dashboards and monitors, associated with a service or feature you want to monitor.
A team, consisting of user accounts and service accounts that share responsibility for the service or feature, is also responsible for each collection.
Collections help service and feature owners manage their services at scale and streamline incident response by consolidating all relevant information about a service or feature into one place, and sharing access to that information with everyone in its responsible team.
For example, to ensure that your team and on-call engineers all have full context for a service, you can create a collection for it that provides direct access to its monitors, dashboards, and the team members who can respond to incidents. Observability Platform then provides a menu of a team’s collections to its members who can quickly review resources most relevant to their services, and a homepage for the collection that the team can share with on-call engineers or other stakeholders.
View collections
To search for a collection:
-
Click the search bar to focus on it, or use the keyboard shortcut Control+K (Command+K on macOS).
- Begin typing any part of the collection’s name.
- Optional: Click the filters for all other listed resource types at the top of the search results to remove them and display only collection.
- Click the desired search result, or use the arrow keys to select it and press enter, to go to that collection.
To browse collections by their respective teams, in the navigation menu select Collections. Collections associated with teams that you belong to appear first, followed by all teams and their respective collections.
In the navigation menu, click Go to Admin and then select Platform > Collections. Clicking on a collection or team in this list takes you to their respective homepages.
To filter this list by teams, select them in the Select a Team dropdown.
Create a collection
You can use Observability Platform to create Terraform, Chronoctl, or API configurations, which you must then apply using the respective application.
Collections use a slug as an identifier.
Services also use a slug. Collection and service slugs can
have the same value.
To create a collection, you must have administrative privileges.
- In the navigation menu, click Go to Admin and then select Platform > Collections.
- Click Create collection.
- In the dialog that appears, enter a descriptive name in the Collection Name field. Observability Platform displays this name anywhere that it refers to this collection.
- Optional: Click the Parent team dropdown and select a team to which you’re associating this collection. If the dropdown doesn’t contain any teams, you can create one.
- Optional: Enter a description in the Collection Description field. Observability Platform displays this description when you view this collection’s homepage.
- Click Save.
Edit a collection
Users cannot modify Terraform-managed resources in the user interface, with Chronoctl, or by using the API. Learn more.
To edit a collection, you must have administrative privileges.
- In the navigation menu, click Go to Admin and then select Platform > Collections.
- Click the name of the collection you want to modify.
- In the Collection information section, click Edit.
- In the dialog that appears, edit the collection based on your needs.
- Click Save.
Delete a collection
Before you delete a collection, you must first remove all of its monitors and dashboards. You can do this by either deleting them or moving them to other collections.
Users cannot modify Terraform-managed resources in the user interface, with Chronoctl, or by using the API. Learn more.
To delete a collection, you must have administrative privileges.
- In the navigation menu, click Go to Admin and then select Platform > Collections.
- Click the name of the collection you want to delete.
- In the Collection information section, click Edit.
- In the dialog that appears, click Delete collection.