Collections

Collections

A collection is a group of Chronosphere resources, such as dashboards and monitors, associated with a service or feature you want to monitor.

A team, comprised 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. Chronosphere 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:

  1. Click the search bar to focus on it, or use the keyboard shortcut Control+K (Command+K on macOS).
  2. Begin typing any part of the collection's name.
  3. Optional: Click the filters for all other listed resource types at the top of the search results to remove them and display only collection.
  4. 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, go to Teams & Collections. Collections associated with teams that you belong to appear first, followed by all teams and their respective collections.

To view a list of all collections that also provides management tools for administrators, in the navigation menu select Managing > 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 the Chronosphere app 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:

  1. In the navigation menu select Managing > Collections.
  2. Click the + Add button.
  3. In the modal that appears, enter a descriptive name in the Collection Name field. Chronosphere displays this name anywhere that it refers to this collection.
  4. 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.
  5. Optional: Enter a description in the Collection Description field. Chronosphere displays this description when you view this collection's homepage.
  6. Click Save.

To create configuratons for use with Terraform, Chronoctl, or the Chronosphere API:

  1. Complete the previous steps, but do not click Save. Instead, click Code Config.
  2. The default display is a Terraform config for the collection you are creating or editing. For a Chronoctl or API configuration, use the menu to select a different option.
  3. Copy or Download the configuration, and apply it manually.

Edit a collection

Chronosphere prevents users from modifying Terraform-managed resources in the user interface, with Chronoctl, or by using the API. For details, see the Terraform provider documentation.

To edit a collection:

  1. In the navigation menu select Managing > Collections.
  2. Click the name of the collection you want to modify.
  3. Click Edit Collection.
  4. In the dialog that appears, edit the collection based on your needs.
  5. 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.

Chronosphere prevents users from modifying Terraform-managed resources in the user interface, with Chronoctl, or by using the API. For details, see the Terraform provider documentation.

To delete a collection:

  1. In the navigation menu select Managing > Collections.
  2. Click the name of the collection you want to delete.
  3. Click Edit Collection.
  4. In the dialog that appears, click Delete collection.