Register Team¶

This document explains how to add a team to the Service Catalog.

Register a Team¶

To register a team into the Service Catalog, in the teams.yml add the following required information:

1
2
3

teams:
  - name: acme_team
    display_name: ACME Corp Devops Teams

• name: the name used in Cirrus for identifaction and mapping of the team. For example, when associating your team with a Service, the team value is used to map this.
• display_name: the text displayed in any user-facing objects. For example, the Grafana Dashboard tags.

Add MS Teams Channel to Team¶

The notifications block defines where your alerts go. We currently support Microsoft Teams as the primary internal communication channel. There is also an OpsGenie communication channel, but this is managed KNMI wide and not on a per-team basis.

Channel Types¶

We support two specific channel_type values to help separate production alerts from development noise:

To add an MS Teams channel to your configured team, in the teams.yml add the following required information:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

teams:
  - name: acme_team
    display_name: ACME Corp Devops Team
    notifications:
      ms_teams:
        - channel_type: default
          group_name: ACME Corp DevOps
          group_id: <group_id>
          channel_name: SRE Alerts
          channel_id: <channel_id>

• channel_type: See Channel Types.
• group_name: Name of MS Teams team. No other use than to make the group_id human understandable.
• group_id: the Group ID of the MS Teams team. See the following section how to find the Group ID.
• channel_name: Name of MS Teams channel. No other use than to make the channel_id human understandable.
• channel_id: the Channel ID of the MS Teams team. See the following section how to find the Channel ID.

Find an MS Teams group_id And channel_id¶

To find the group_id and channel_id for a Microsoft Teams contact point:

1. Open Microsoft Teams and navigate to the team and channel you want to use.
2. Click on the three dots (...) next to the channel name and select Get link to channel.
3. The URL will look something like this: https://teams.microsoft.com/l/channel/<channel_id>/General?groupId=<group_id>&tenantId=<tenant_id>.
4. Extract the group_id and channel_id from the URL. The channel_id is the part after l/channel/ and before /General, and the group_id is the value after groupId=.
5. Use these values in the ms_teams section of your notifications configuration.