OBSERVABILITY PLATFORM
Collections

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:

  1. Click the search bar to focus on it, or use the keyboard shortcut Control+K (Command+K on macOS).
    1. Begin typing any part of the collection’s name.
    2. Optional: Click the filters for all other listed resource types at the top of the search results to remove them and display only collection.
    3. Click the desired search result, or use the arrow keys to select it and press Enter (Return on macOS), to select that collection.

To browse collections by their respective teams, in the navigation menu click Collections. Collections associated with teams that you belong to appear first, followed by lists of All Teams & Collections and Unowned Collections. To expand the latter lists, click the list’s expand icon.

If you have administative privileges, you can view a filterable list.

  1. In the navigation menu, click Admin and then select Platform > Collections. Clicking on a collection or team in this table takes you to their respective homepages.

    • To filter this table by keyword, click Search collections and begin typing. The table automatically updates to display only the matching collections.
    • To filter this list by teams, select them in the Select a Team dropdown.
    • To display only collections that lack an owner, enable the Unowned Collections Only toggle.

You can optionally select collections by checking the checkbox on each collection’s row, which reveals an Edit Team Association button. Clicking this button allows you to select a parent team for all selected collections. If you select a team, click Save to save the edited association. For more Collection editing features, see Edit a Collection.

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.

  1. In the navigation menu, click Go to Admin and then click Platform > Collections.
  2. Click Create collection.
  3. 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.
  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. Observability Platform displays this description when you view this collection’s homepage.
  6. 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.

  1. In the navigation menu, click Go to Admin and then select Platform > Collections.
  2. Click the name of the collection you want to modify.
  3. In the Collection information section, click Edit.
  4. In the dialog that appears, edit the collection based on your needs.
  5. Click Save.

You can optionally select collections by checking the checkbox on each collection’s row, which reveals an Edit Team Association button. Clicking this button allows you to select a parent team for all selected collections. If you select a team, click Save to save the edited association. For more Collection editing features, see Edit a Collection.

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.

  1. In the navigation menu, click Go to Admin and then select Platform > Collections.
  2. Click the name of the collection you want to delete.
  3. In the Collection information section, click Edit.
  4. In the dialog that appears, click Delete collection.