KristiDodaj commented on code in PR #45508:
URL: https://github.com/apache/superset/pull/45508#discussion_r4380656061
##########
docs/admin_docs/configuration/alerts-reports.mdx:
##########
@@ -892,6 +892,206 @@ This information can then be retrieved from the endpoint
`/api/v1/saved_query/`
schedule the queries that have `schedule_info` in their JSON metadata. For
schedulers other than
Airflow, additional fields can be easily added to the configuration file above.
+## Microsoft Teams configuration
+
+Teams is an optional, disabled-by-default notification destination for
+attachment-free alerts in standard channels. Each deployment supports one
+Microsoft tenant and bot identity. Scheduled reports, private/shared channels,
+direct messages, and file attachments are not supported.
+
+### Install and configure
+
+Install the extra in both the web-server and Celery worker images using the
same
+Superset release as the deployment:
+
+```bash
+pip install 'apache-superset[teams]==<your-superset-version>'
+superset db upgrade
+```
+
+Configure both processes with the same server-side settings. Load the secret
+value from a deployment secret store, rather than checking it into source
control:
+
+```python
+import os
+
+FEATURE_FLAGS = {
+ "ALERT_REPORTS": True,
+ "ALERT_REPORT_TEAMS": True,
+}
+ALERT_REPORTS_TEAMS = {
+ "tenant_id": os.environ["TEAMS_TENANT_ID"],
+ "application_id": os.environ["TEAMS_APPLICATION_ID"],
+ "credential": os.environ["TEAMS_CLIENT_SECRET"],
+ "destinations": [
+ {
+ "key": "ops",
+ "label": "Operations alerts",
+ "team_id": os.environ["TEAMS_OPS_TEAM_ID"],
+ "channel_id": os.environ["TEAMS_OPS_CHANNEL_ID"],
+ },
+ ],
+}
+```
+
+Destination keys must be unique, stable identifiers of 1–128 letters, digits,
+underscores or hyphens, starting with a letter or digit. Keep keys stable when
+changing routing. Each destination requires a label, team ID, and channel ID.
Review Comment:
Clarified the required `team_id` format with an example and steps to extract
it from the team link
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: [email protected]
For queries about this service, please contact Infrastructure at:
[email protected]
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
