v1.9.29

.github/workflows/on-release-published.yml

@@ -126,14 +126,22 @@ jobs:
       id-token: write
       contents: read
     steps:
-      # This will fetch the secret keys from vault and set them as environment variables for subsequent steps
       - name: Get Vault secrets
         uses: grafana/shared-workflows/actions/get-vault-secrets@main
         with:
           repo_secrets: |
-            GITHUB_API_KEY=github_actions:github-api-key
+            GH_APP_ID=github-app:app-id
+            GH_APP_PRIVATE_KEY=github-app:private-key
+
+      - name: Generate Github App token
+        id: generate-token
+        uses: actions/create-github-app-token@v1
+        with:
+          app-id: ${{ env.GH_APP_ID }}
+          private-key: ${{ env.GH_APP_PRIVATE_KEY }}
+
       - name: Merge pull Request
         uses: juliangruber/merge-pull-request-action@v1
         with:
-          github-token: ${{ env.GITHUB_API_KEY }}
+          github-token: ${{ steps.generate-token.outputs.token }}
           number: ${{ needs.create-helm-release-pr.outputs.helm_release_pr_number }}

docs/sources/oncall-api-reference/schedules.md

@@ -150,6 +150,7 @@ The above command returns JSON structured in the following way:
 The following available filter parameter should be provided as a `GET` argument:
 
 - `name` (Exact match)
+- `team_id` (Exact match, team ID)
 
 **HTTP request**
 

docs/sources/oncall-api-reference/teams.md

@@ -28,6 +28,7 @@ The above command returns JSON structured in the following way:
 ```json
 {
   "id": "TI73TDU19W48J",
+  "grafana_id": 123,
   "name": "my test team",
   "email": "",
   "avatar_url": "/avatar/3f49c15916554246daa714b9bd0ee398"
@@ -38,12 +39,13 @@ The above command returns JSON structured in the following way:
 
 `GET {{API_URL}}/api/v1/teams/<TEAM_ID>/`
 
-| Parameter  | Unique  | Description                                                        |
-| ---------- | :-----: | :----------------------------------------------------------------- |
-| `id`       | Yes/org | Team ID                                                            |
-| `name`    | Yes/org | Team name                                                        |
-| `email`    | Yes/org | Team e-mail                                                        |
-| `avatar_url`    | Yes | Avatar URL of the Grafana team  |
+| Parameter         | Unique  | Description                    |
+| ----------------- | :-----: | :----------------------------- |
+| `id`              | Yes/org | OnCall team ID                 |
+| `grafana_id`      | Yes/org | Grafana team ID                |
+| `name`            | Yes/org | Team name                      |
+| `email`           | Yes/org | Team e-mail                    |
+| `avatar_url`      | Yes     | Avatar URL of the Grafana team |
 
 ## List Teams
 
@@ -64,6 +66,7 @@ The above command returns JSON structured in the following way:
   "results": [
     {
       "id": "TI73TDU19W48J",
+      "grafana_id": 123,
       "name": "my test team",
       "email": "",
       "avatar_url": "/avatar/3f49c15916554246daa714b9bd0ee398"

docs/sources/oncall-api-reference/users.md

@@ -28,6 +28,7 @@ The above command returns JSON structured in the following way:
 ```json
 {
   "id": "U4DNY931HHJS5",
+  "grafana_id": 456,
   "email": "public-api-demo-user-1@grafana.com",
   "slack": [
     {
@@ -48,15 +49,16 @@ The above command returns JSON structured in the following way:
 
 Use `{{API_URL}}/api/v1/users/current` to retrieve the current user.
 
-| Parameter  | Unique  | Description                                                        |
-| ---------- | :-----: | :----------------------------------------------------------------- |
-| `id`       | Yes/org | User ID                                                            |
-| `email`    | Yes/org | User e-mail                                                        |
-| `slack`    | Yes/org | List of user IDs from connected Slack. User linking key is e-mail. |
-| `username` | Yes/org | User username                                                      |
-| `role`     |   No    | One of: `user`, `observer`, `admin`.                               |
-| `timezone` |   No    | timezone of the user one of [time zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones).                               |
-| `teams`    |   No    | List of team IDs the user belongs to                               |
+| Parameter         | Unique  | Description                                                        |
+| ----------------- | :-----: | :----------------------------------------------------------------- |
+| `id`              | Yes/org | OnCall user ID                                                     |
+| `grafana_id`      | Yes/org | Grafana user ID                                                    |
+| `email`           | Yes/org | User e-mail                                                        |
+| `slack`           | Yes/org | List of user IDs from connected Slack. User linking key is e-mail. |
+| `username`        | Yes/org | User username                                                      |
+| `role`            |   No    | One of: `user`, `observer`, `admin`.                               |
+| `timezone`        |   No    | timezone of the user one of [time zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones).                               |
+| `teams`           |   No    | List of team IDs the user belongs to                               |
 
 ## List Users
 
@@ -77,6 +79,7 @@ The above command returns JSON structured in the following way:
   "results": [
     {
       "id": "U4DNY931HHJS5",
+      "grafana_id": 456,
       "email": "public-api-demo-user-1@grafana.com",
       "slack": [
         {

engine/apps/public_api/serializers/teams.py

@@ -5,7 +5,14 @@
 
 class TeamSerializer(serializers.ModelSerializer):
     id = serializers.CharField(read_only=True, source="public_primary_key")
+    grafana_id = serializers.IntegerField(read_only=True, source="team_id")
 
     class Meta:
         model = Team
-        fields = ("id", "name", "email", "avatar_url")
+        fields = [
+            "id",
+            "grafana_id",
+            "name",
+            "email",
+            "avatar_url",
+        ]

engine/apps/public_api/serializers/users.py

@@ -20,13 +20,21 @@ class Meta:
 
 class FastUserSerializer(serializers.ModelSerializer):
     id: str = serializers.ReadOnlyField(read_only=True, source="public_primary_key")
+    grafana_id: int = serializers.IntegerField(read_only=True, source="user_id")
     email: str = serializers.EmailField(read_only=True)
     role: str = serializers.SerializerMethodField()  # LEGACY, should be removed eventually
     is_phone_number_verified: bool = serializers.SerializerMethodField()
 
     class Meta:
         model = User
-        fields = ["id", "email", "username", "role", "is_phone_number_verified"]
+        fields = [
+            "id",
+            "grafana_id",
+            "email",
+            "username",
+            "role",
+            "is_phone_number_verified",
+        ]
 
     @staticmethod
     def get_role(obj: User) -> str:
@@ -41,6 +49,7 @@ def get_is_phone_number_verified(self, obj: User) -> bool:
 
 class UserSerializer(serializers.ModelSerializer, EagerLoadingMixin):
     id: str = serializers.ReadOnlyField(read_only=True, source="public_primary_key")
+    grafana_id: int = serializers.IntegerField(read_only=True, source="user_id")
     email: str = serializers.EmailField(read_only=True)
     slack: SlackUserIdentity = SlackUserIdentitySerializer(read_only=True, source="slack_user_identity")
     role: str = serializers.SerializerMethodField()  # LEGACY, should be removed eventually
@@ -55,7 +64,17 @@ class UserSerializer(serializers.ModelSerializer, EagerLoadingMixin):
 
     class Meta:
         model = User
-        fields = ["id", "email", "slack", "username", "role", "is_phone_number_verified", "timezone", "teams"]
+        fields = [
+            "id",
+            "grafana_id",
+            "email",
+            "slack",
+            "username",
+            "role",
+            "is_phone_number_verified",
+            "timezone",
+            "teams",
+        ]
         read_only_fields = ["timezone"]
 
     @staticmethod

engine/apps/public_api/tests/test_teams.py

@@ -33,6 +33,7 @@ def test_get_teams_list(team_public_api_setup):
         "results": [
             {
                 "id": team.public_primary_key,
+                "grafana_id": team.team_id,
                 "name": team.name,
                 "email": team.email,
                 "avatar_url": team.avatar_url,
@@ -59,6 +60,7 @@ def test_get_team(team_public_api_setup):
 
     expected_payload = {
         "id": team.public_primary_key,
+        "grafana_id": team.team_id,
         "name": team.name,
         "email": team.email,
         "avatar_url": team.avatar_url,

engine/apps/public_api/tests/test_users.py

@@ -29,6 +29,7 @@ def test_get_user(
 
     expected_response = {
         "id": user.public_primary_key,
+        "grafana_id": user.user_id,
         "email": user.email,
         "slack": {"user_id": slack_user_identity.slack_id, "team_id": slack_team_identity.slack_id},
         "username": user.username,
@@ -72,6 +73,7 @@ def test_get_users_list(
         "results": [
             {
                 "id": user_1.public_primary_key,
+                "grafana_id": user_1.user_id,
                 "email": user_1.email,
                 "slack": {"user_id": slack_user_identity.slack_id, "team_id": slack_team_identity.slack_id},
                 "username": user_1.username,
@@ -82,6 +84,7 @@ def test_get_users_list(
             },
             {
                 "id": user_2.public_primary_key,
+                "grafana_id": user_2.user_id,
                 "email": user_2.email,
                 "slack": None,
                 "username": user_2.username,
@@ -120,13 +123,15 @@ def test_get_users_list_short(
         "results": [
             {
                 "id": user_1.public_primary_key,
+                "grafana_id": user_1.user_id,
                 "email": user_1.email,
                 "username": user_1.username,
                 "role": "admin",
                 "is_phone_number_verified": False,
             },
             {
                 "id": user_2.public_primary_key,
+                "grafana_id": user_2.user_id,
                 "email": user_2.email,
                 "username": user_2.username,
                 "role": "admin",
@@ -178,6 +183,7 @@ def test_get_users_list_all_role_users(user_public_api_setup, make_user_for_orga
         "results": [
             {
                 "id": user.public_primary_key,
+                "grafana_id": user.user_id,
                 "email": user.email,
                 "username": user.username,
                 "role": role,