diff options
author | Konstantinos Papazacharopoulos <kpapazach@netdata.cloud> | 2024-01-24 19:07:40 +0200 |
---|---|---|
committer | GitHub <noreply@github.com> | 2024-01-24 19:07:40 +0200 |
commit | 4952aef8ef0c7e1f9d565ed87b569f9547b2f391 (patch) | |
tree | 41abb88e4830a98a838011e4c6af4ce7f6e10aa0 | |
parent | 5b8355117adbf10d9c16e89137e4ac326b512a08 (diff) |
adds docs for cloud MS Teams integration (#16834)
Co-authored-by: Ilya Mashchenko <ilya@netdata.cloud>
-rw-r--r-- | integrations/cloud-notifications/metadata.yaml | 50 |
1 files changed, 50 insertions, 0 deletions
diff --git a/integrations/cloud-notifications/metadata.yaml b/integrations/cloud-notifications/metadata.yaml index 4c5e0c56ac..01810d3016 100644 --- a/integrations/cloud-notifications/metadata.yaml +++ b/integrations/cloud-notifications/metadata.yaml @@ -360,6 +360,56 @@ - Finally, click on **Create topic** on the bottom of the page 3. Now, use the new **Topic ARN** while adding AWS SNS integration on your space. +- id: 'notify-cloud-microsoftteams' + meta: + name: 'Microsoft Teams' + link: 'https://www.microsoft.com/en-us/microsoft-teams' + categories: + - notify.cloud + icon_filename: 'teams.svg' + keywords: + - microsoft + - teams + overview: + notification_description: "From the Netdata Cloud UI, you can manage your space's notification settings and enable the configuration to deliver notifications to a Microsoft Teams channel." + notification_limitations: '' + setup: + description: | + ### Prerequisites + + To add Microsoft Teams notifications integration to your Netdata Cloud space you will need the following: + + - A Netdata Cloud account. + - Access to the Netdata Cloud space as an **administrator**. + - The Space to be on **Business** plan or higher. + - A [Microsoft 365 for Business Account](https://www.microsoft.com/en-us/microsoft-365/business). Note that this is a **paid** account. + + ### Settings on Microsoft Teams + + - The integration gets enabled at a team's channel level. + - Click on the `...` (aka three dots) icon showing up next to the channel name, it should appear when you hover over it. + - Click on `Connectors`. + - Look for the `Incoming Webhook` connector and click configure. + - Provide a name for your Incoming Webhook Connector, for example _Netdata Alerts_. You can also customize it with a proper icon instead of using the default image. + - Click `Create`. + - The _Incoming Webhook URL_ is created. + - That is the URL to be provided to the Netdata Cloud configuration. + + ### Settings on Netdata Cloud + + 1. Click on the **Space settings** cog (located above your profile icon). + 2. Click on the **Notification** tab. + 3. Click on the **+ Add configuration** button (near the top-right corner of your screen). + 4. On the **Microsoft Teams** card click on **+ Add**. + 5. A modal will be presented to you to enter the required details to enable the configuration: + * **Notification settings** are Netdata specific settings: + - Configuration name - you can optionally provide a name for your configuration you can easily refer to it. + - Rooms - by specifying a list of Rooms you are select to which nodes or areas of your infrastructure you want to be notified using this configuration. + - Notification - you specify which notifications you want to be notified using this configuration: All Alerts and unreachable, All Alerts, Critical only. + * **Integration configuration** are the specific notification integration required settings, which vary by notification method. For Microsoft Teams: + - Microsoft Teams Incoming Webhook URL - the _Incoming Webhook URL_ that was generated earlier. + + - id: 'notify-cloud-telegram' meta: name: 'Telegram' |