Skip to content

Commit

Permalink
v1.8.10
Browse files Browse the repository at this point in the history
  • Loading branch information
joeyorlando authored Aug 9, 2024
2 parents a7c0862 + 6eac05a commit e72d036
Show file tree
Hide file tree
Showing 36 changed files with 561 additions and 91 deletions.
2 changes: 2 additions & 0 deletions docs/sources/manage/notify/slack/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -122,6 +122,8 @@ This set of permissions is supporting the ability of Grafana OnCall to match use
(deprecated) slack commands.
- **Create and manage user groups** — the permission is used to automatically update user groups linked to on-call
schedules. It will add users once their on-call shift starts and remove them once the on-call shift ends.
- **NOTE**: per [Slack's documentation](https://slack.com/help/articles/212906697-Create-a-user-group), you must have
a paid plan for this feature to work properly
- **Set presence for Grafana OnCall**

## Post-install configuration for Slack integration
Expand Down
8 changes: 8 additions & 0 deletions docs/sources/oncall-api-reference/alertgroups.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,12 @@
canonical: https://grafana.com/docs/oncall/latest/oncall-api-reference/alertgroups/
title: Alert groups HTTP API
weight: 400
refs:
pagination:
- pattern: /docs/oncall/
destination: /docs/oncall/<ONCALL_VERSION>/oncall-api-reference/#pagination
- pattern: /docs/grafana-cloud/
destination: /docs/grafana-cloud/alerting-and-irm/oncall/oncall-api-reference/#pagination
---

# Alert groups HTTP API
Expand Down Expand Up @@ -48,6 +54,8 @@ The above command returns JSON structured in the following way:
}
```

> **Note**: The response is [paginated](ref:pagination). You may need to make multiple requests to get all records.
These available filter parameters should be provided as `GET` arguments:

- `id`
Expand Down
8 changes: 8 additions & 0 deletions docs/sources/oncall-api-reference/alerts.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,12 @@
canonical: https://grafana.com/docs/oncall/latest/oncall-api-reference/alerts/
title: Alerts HTTP API
weight: 100
refs:
pagination:
- pattern: /docs/oncall/
destination: /docs/oncall/<ONCALL_VERSION>/oncall-api-reference/#pagination
- pattern: /docs/grafana-cloud/
destination: /docs/grafana-cloud/alerting-and-irm/oncall/oncall-api-reference/#pagination
---

# Alerts HTTP API
Expand Down Expand Up @@ -105,6 +111,8 @@ The above command returns JSON structured in the following way:
}
```

> **Note**: The response is [paginated](ref:pagination). You may need to make multiple requests to get all records.
The following available filter parameters should be provided as `GET` arguments:

- `id`
Expand Down
8 changes: 8 additions & 0 deletions docs/sources/oncall-api-reference/escalation_chains.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,12 @@
canonical: https://grafana.com/docs/oncall/latest/oncall-api-reference/escalation_chains/
title: Escalation chains HTTP API
weight: 200
refs:
pagination:
- pattern: /docs/oncall/
destination: /docs/oncall/<ONCALL_VERSION>/oncall-api-reference/#pagination
- pattern: /docs/grafana-cloud/
destination: /docs/grafana-cloud/alerting-and-irm/oncall/oncall-api-reference/#pagination
---

# Escalation chains HTTP API
Expand Down Expand Up @@ -89,6 +95,8 @@ The above command returns JSON structured in the following way:
}
```

> **Note**: The response is [paginated](ref:pagination). You may need to make multiple requests to get all records.
**HTTP request**

`GET {{API_URL}}/api/v1/escalation_chains/`
Expand Down
8 changes: 8 additions & 0 deletions docs/sources/oncall-api-reference/escalation_policies.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,12 @@
canonical: https://grafana.com/docs/oncall/latest/oncall-api-reference/escalation_policies/
title: Escalation policies HTTP API
weight: 300
refs:
pagination:
- pattern: /docs/oncall/
destination: /docs/oncall/<ONCALL_VERSION>/oncall-api-reference/#pagination
- pattern: /docs/grafana-cloud/
destination: /docs/grafana-cloud/alerting-and-irm/oncall/oncall-api-reference/#pagination
---

# Escalation policies HTTP API
Expand Down Expand Up @@ -144,6 +150,8 @@ The above command returns JSON structured in the following way:
}
```

> **Note**: The response is [paginated](ref:pagination). You may need to make multiple requests to get all records.
The following available filter parameter should be provided as a `GET` argument:

- `escalation_chain_id`
Expand Down
7 changes: 7 additions & 0 deletions docs/sources/oncall-api-reference/integrations.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,11 @@ refs:
destination: /docs/oncall/<ONCALL_VERSION>/configure/integrations/references/alertmanager/
- pattern: /docs/grafana-cloud/
destination: /docs/grafana-cloud/alerting-and-irm/oncall/configure/integrations/references/alertmanager/
pagination:
- pattern: /docs/oncall/
destination: /docs/oncall/<ONCALL_VERSION>/oncall-api-reference/#pagination
- pattern: /docs/grafana-cloud/
destination: /docs/grafana-cloud/alerting-and-irm/oncall/oncall-api-reference/#pagination
---

# Integrations HTTP API
Expand Down Expand Up @@ -233,6 +238,8 @@ The above command returns JSON structured in the following way:
}
```

> **Note**: The response is [paginated](ref:pagination). You may need to make multiple requests to get all records.
**HTTP request**

`GET {{API_URL}}/api/v1/integrations/`
Expand Down
8 changes: 8 additions & 0 deletions docs/sources/oncall-api-reference/on_call_shifts.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,12 @@
canonical: https://grafana.com/docs/oncall/latest/oncall-api-reference/on_call_shifts/
title: OnCall shifts HTTP API
weight: 600
refs:
pagination:
- pattern: /docs/oncall/
destination: /docs/oncall/<ONCALL_VERSION>/oncall-api-reference/#pagination
- pattern: /docs/grafana-cloud/
destination: /docs/grafana-cloud/alerting-and-irm/oncall/oncall-api-reference/#pagination
---

# OnCall shifts HTTP API
Expand Down Expand Up @@ -150,6 +156,8 @@ The above command returns JSON structured in the following way:
}
```

> **Note**: The response is [paginated](ref:pagination). You may need to make multiple requests to get all records.
The following available filter parameters should be provided as `GET` arguments:

- `name` (Exact match)
Expand Down
9 changes: 9 additions & 0 deletions docs/sources/oncall-api-reference/outgoing_webhooks.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,11 @@ refs:
destination: /docs/oncall/<ONCALL_VERSION>/configure/integrations/outgoing-webhooks/#event-types
- pattern: /docs/grafana-cloud/
destination: /docs/grafana-cloud/alerting-and-irm/oncall/configure/integrations/outgoing-webhooks/#event-types
pagination:
- pattern: /docs/oncall/
destination: /docs/oncall/<ONCALL_VERSION>/oncall-api-reference/#pagination
- pattern: /docs/grafana-cloud/
destination: /docs/grafana-cloud/alerting-and-irm/oncall/oncall-api-reference/#pagination
---

# Outgoing webhooks
Expand Down Expand Up @@ -66,6 +71,8 @@ The above command returns JSON structured in the following way:
}
```

> **Note**: The response is [paginated](ref:pagination). You may need to make multiple requests to get all records.
## Get webhook

```shell
Expand Down Expand Up @@ -244,3 +251,5 @@ The above command returns JSON structured in the following way:
"total_pages": 1
}
```

> **Note**: The response is [paginated](ref:pagination). You may need to make multiple requests to get all records.
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,12 @@
canonical: https://grafana.com/docs/oncall/latest/oncall-api-reference/personal_notification_rules/
title: Personal notification rules HTTP API
weight: 800
refs:
pagination:
- pattern: /docs/oncall/
destination: /docs/oncall/<ONCALL_VERSION>/oncall-api-reference/#pagination
- pattern: /docs/grafana-cloud/
destination: /docs/grafana-cloud/alerting-and-irm/oncall/oncall-api-reference/#pagination
---

# Personal notification rules HTTP API
Expand Down Expand Up @@ -122,6 +128,8 @@ The above command returns JSON structured in the following ways:
}
```

> **Note**: The response is [paginated](ref:pagination). You may need to make multiple requests to get all records.
The following available filter parameters should be provided as `GET` arguments:

- `user_id`
Expand Down
8 changes: 8 additions & 0 deletions docs/sources/oncall-api-reference/resolution_notes.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,12 @@
canonical: https://grafana.com/docs/oncall/latest/oncall-api-reference/resolution_notes/
title: Resolution notes HTTP API
weight: 900
refs:
pagination:
- pattern: /docs/oncall/
destination: /docs/oncall/<ONCALL_VERSION>/oncall-api-reference/#pagination
- pattern: /docs/grafana-cloud/
destination: /docs/grafana-cloud/alerting-and-irm/oncall/oncall-api-reference/#pagination
---

# Resolution notes HTTP API
Expand Down Expand Up @@ -99,6 +105,8 @@ The above command returns JSON structured in the following way:
}
```

> **Note**: The response is [paginated](ref:pagination). You may need to make multiple requests to get all records.
The following available filter parameter should be provided as a `GET` argument:

- `alert_group_id`
Expand Down
8 changes: 8 additions & 0 deletions docs/sources/oncall-api-reference/routes.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,12 @@
canonical: https://grafana.com/docs/oncall/latest/oncall-api-reference/routes/
title: Routes HTTP API
weight: 1100
refs:
pagination:
- pattern: /docs/oncall/
destination: /docs/oncall/<ONCALL_VERSION>/oncall-api-reference/#pagination
- pattern: /docs/grafana-cloud/
destination: /docs/grafana-cloud/alerting-and-irm/oncall/oncall-api-reference/#pagination
---

# Routes HTTP API
Expand Down Expand Up @@ -134,6 +140,8 @@ The above command returns JSON structured in the following way:
}
```

> **Note**: The response is [paginated](ref:pagination). You may need to make multiple requests to get all records.
The following available filter parameters should be provided as `GET` arguments:

- `integration_id`
Expand Down
10 changes: 10 additions & 0 deletions docs/sources/oncall-api-reference/schedules.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,12 @@
canonical: https://grafana.com/docs/oncall/latest/oncall-api-reference/schedules/
title: Schedules HTTP API
weight: 1200
refs:
pagination:
- pattern: /docs/oncall/
destination: /docs/oncall/<ONCALL_VERSION>/oncall-api-reference/#pagination
- pattern: /docs/grafana-cloud/
destination: /docs/grafana-cloud/alerting-and-irm/oncall/oncall-api-reference/#pagination
---

# Schedules HTTP API
Expand Down Expand Up @@ -139,6 +145,8 @@ The above command returns JSON structured in the following way:
}
```

> **Note**: The response is [paginated](ref:pagination). You may need to make multiple requests to get all records.
The following available filter parameter should be provided as a `GET` argument:

- `name` (Exact match)
Expand Down Expand Up @@ -307,6 +315,8 @@ The above command returns JSON structured in the following way:
}
```

> **Note**: The response is [paginated](ref:pagination). You may need to make multiple requests to get all records.
### Caveats

Some notes on the `start_date` and `end_date` query parameters:
Expand Down
8 changes: 8 additions & 0 deletions docs/sources/oncall-api-reference/shift_swaps.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,12 @@
canonical: https://grafana.com/docs/oncall/latest/oncall-api-reference/shift_swaps/
title: Shift swap requests HTTP API
weight: 1200
refs:
pagination:
- pattern: /docs/oncall/
destination: /docs/oncall/<ONCALL_VERSION>/oncall-api-reference/#pagination
- pattern: /docs/grafana-cloud/
destination: /docs/grafana-cloud/alerting-and-irm/oncall/oncall-api-reference/#pagination
---

# Shift swap requests HTTP API
Expand Down Expand Up @@ -185,6 +191,8 @@ The above command returns JSON structured in the following way:
}
```

> **Note**: The response is [paginated](ref:pagination). You may need to make multiple requests to get all records.
The following available filter parameters may be provided as a `GET` arguments:

- `starting_after` (an ISO 8601 timestamp string, filter requests starting after the specified datetime)
Expand Down
8 changes: 8 additions & 0 deletions docs/sources/oncall-api-reference/slack_channels.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,12 @@
canonical: https://grafana.com/docs/oncall/latest/oncall-api-reference/slack_channels/
title: Slack channels HTTP API
weight: 1300
refs:
pagination:
- pattern: /docs/oncall/
destination: /docs/oncall/<ONCALL_VERSION>/oncall-api-reference/#pagination
- pattern: /docs/grafana-cloud/
destination: /docs/grafana-cloud/alerting-and-irm/oncall/oncall-api-reference/#pagination
---

# Slack channels HTTP API
Expand Down Expand Up @@ -34,6 +40,8 @@ The above command returns JSON structured in the following way:
}
```

> **Note**: The response is [paginated](ref:pagination). You may need to make multiple requests to get all records.
The following available filter parameter should be provided as a `GET` argument:

- `channel_name`
Expand Down
8 changes: 8 additions & 0 deletions docs/sources/oncall-api-reference/user_groups.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,12 @@
canonical: https://grafana.com/docs/oncall/latest/oncall-api-reference/user_groups/
title: OnCall user groups HTTP API
weight: 1400
refs:
pagination:
- pattern: /docs/oncall/
destination: /docs/oncall/<ONCALL_VERSION>/oncall-api-reference/#pagination
- pattern: /docs/grafana-cloud/
destination: /docs/grafana-cloud/alerting-and-irm/oncall/oncall-api-reference/#pagination
---

<!--Used in escalation policies with type = `notify_user_group` and in schedules.-->
Expand Down Expand Up @@ -41,6 +47,8 @@ The above command returns JSON structured in the following way:
}
```

> **Note**: The response is [paginated](ref:pagination). You may need to make multiple requests to get all records.
| Parameter | Unique | Description |
| --------- | :----: | :---------------------------------------------------------------------------------------------------- |
| `id` | Yes | User Group ID |
Expand Down
8 changes: 7 additions & 1 deletion docs/sources/oncall-api-reference/users.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,12 @@
canonical: https://grafana.com/docs/oncall/latest/oncall-api-reference/users/
title: Grafana OnCall users HTTP API
weight: 1500
refs:
pagination:
- pattern: /docs/oncall/
destination: /docs/oncall/<ONCALL_VERSION>/oncall-api-reference/#pagination
- pattern: /docs/grafana-cloud/
destination: /docs/grafana-cloud/alerting-and-irm/oncall/oncall-api-reference/#pagination
---

# Grafana OnCall users HTTP API
Expand Down Expand Up @@ -90,7 +96,7 @@ The above command returns JSON structured in the following way:
}
```

This endpoint retrieves all users.
> **Note**: The response is [paginated](ref:pagination). You may need to make multiple requests to get all records.

The following available filter parameter should be provided as a `GET` argument:

Expand Down
4 changes: 4 additions & 0 deletions engine/apps/api/views/features.py
Original file line number Diff line number Diff line change
Expand Up @@ -15,6 +15,7 @@
class Feature(enum.StrEnum):
MSTEAMS = "msteams"
SLACK = "slack"
UNIFIED_SLACK = "unified_slack"
TELEGRAM = "telegram"
LIVE_SETTINGS = "live_settings"
GRAFANA_CLOUD_NOTIFICATIONS = "grafana_cloud_notifications"
Expand Down Expand Up @@ -46,6 +47,9 @@ def _get_enabled_features(self, request):
if settings.FEATURE_SLACK_INTEGRATION_ENABLED:
enabled_features.append(Feature.SLACK)

if settings.UNIFIED_SLACK_APP_ENABLED:
enabled_features.append(Feature.UNIFIED_SLACK)

if settings.FEATURE_TELEGRAM_INTEGRATION_ENABLED:
enabled_features.append(Feature.TELEGRAM)

Expand Down
Loading

0 comments on commit e72d036

Please sign in to comment.