Add labels
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
insloctl
).-
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 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:
Labels | Examples |
---|---|
Geo labels | geo: apac geo: amer geo: eu |
Team labels | team: green team: sales |
Alert policy Labels | alert: low alert: medium alert: high |
SLO labels | slo: ratio slo: calendar |
Environment labels | env: test env: prod env: staging |
For more tips on using labels efficiently, refer to Labelling conventions and best practices.