Skip to main content

Add labels

Reading time: 0 minute(s) (0 words)
See how to add Labels in Nobl9.
Tired of reading? Check out the video tutorial!

Labels are key-value pairs that can be attached to SLOs, services, projects, and alert policies in the Nobl9 platform.

With labels, you can define attributes of resources and use them to filter and group SLOs across services, projects, and reports. Each label must be unique for a given SLO, but many SLOs can carry the same label.

Requirements

Labels have a specific format and must conform to the following rules:

  • Labels must be in the key: value format (key=value in sloctl).

    • key can contain only lowercase alphanumeric characters, underscores, and dashes; must start with a letter and end with an alphanumeric character; maximum length 63 characters

    • value can contain Unicode characters; maximum length 200 characters

  • Labels can contain international (diacritic) characters.

  • Labels can contain underscores (_) and dashes (-) between the alphanumeric characters.

  • There can be max. 20 labels assigned to a resource.

Labels with duplicate key: value pairs are merged.

Adding labels

Follow these steps to add labels while creating or editing a service, project, alert policy, or an SLO:

In the Labels field:

  • Select a label from the dropdown menu, or

  • Create a new label: enter the required key or value and click plus button or hit ↵ (Enter) on your keyboard.

When your user role allows, you can also manage labels available within your organization.

Use cases

Check out the most common use cases for labels in the Nobl9 platform:

LabelsExamples
Geo labelsgeo: apac
geo: amer
geo: eu
Team labelsteam: green
team: sales
Alert policy Labelsalert: low
alert: medium
alert: high
SLO labelsslo: ratio
slo: calendar
Environment labelsenv: test
env: prod
env: staging

For more tips on using labels efficiently, refer to Labelling conventions and best practices.

Check out the configuration video:

Video 1: Adding labels
Great job! Now, you know how to handle labels!