From b485aab7e71c1625cfc27e0f92c9509f42378458 Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Sun, 5 May 2024 13:19:16 +0200 Subject: Adding upstream version 1.45.3+dfsg. Signed-off-by: Daniel Baumann --- .../cloud-notifications/integrations/amazon_sns.md | 2 +- .../cloud-notifications/integrations/discord.md | 2 +- .../cloud-notifications/integrations/mattermost.md | 2 +- .../integrations/microsoft_teams.md | 57 ++++++++++ .../integrations/netdata_mobile_app.md | 41 +++++++ .../cloud-notifications/integrations/opsgenie.md | 2 +- .../cloud-notifications/integrations/pagerduty.md | 5 +- .../cloud-notifications/integrations/rocketchat.md | 2 +- .../cloud-notifications/integrations/slack.md | 2 +- .../cloud-notifications/integrations/splunk.md | 47 ++++++++ .../cloud-notifications/integrations/telegram.md | 2 +- .../cloud-notifications/integrations/webhook.md | 6 +- integrations/cloud-notifications/metadata.yaml | 125 ++++++++++++++++++++- 13 files changed, 281 insertions(+), 14 deletions(-) create mode 100644 integrations/cloud-notifications/integrations/microsoft_teams.md create mode 100644 integrations/cloud-notifications/integrations/netdata_mobile_app.md create mode 100644 integrations/cloud-notifications/integrations/splunk.md (limited to 'integrations/cloud-notifications') diff --git a/integrations/cloud-notifications/integrations/amazon_sns.md b/integrations/cloud-notifications/integrations/amazon_sns.md index ff16e8d38..b0c849894 100644 --- a/integrations/cloud-notifications/integrations/amazon_sns.md +++ b/integrations/cloud-notifications/integrations/amazon_sns.md @@ -3,7 +3,7 @@ custom_edit_url: "https://github.com/netdata/netdata/edit/master/integrations/cl meta_yaml: "https://github.com/netdata/netdata/edit/master/integrations/cloud-notifications/metadata.yaml" sidebar_label: "Amazon SNS" learn_status: "Published" -learn_rel_path: "Alerting/Notifications/Centralized Cloud Notifications" +learn_rel_path: "Alerts & Notifications/Notifications/Centralized Cloud Notifications" message: "DO NOT EDIT THIS FILE DIRECTLY, IT IS GENERATED BY THE NOTIFICATION'S metadata.yaml FILE" endmeta--> diff --git a/integrations/cloud-notifications/integrations/discord.md b/integrations/cloud-notifications/integrations/discord.md index fc11b7c37..7b9d0ff0e 100644 --- a/integrations/cloud-notifications/integrations/discord.md +++ b/integrations/cloud-notifications/integrations/discord.md @@ -3,7 +3,7 @@ custom_edit_url: "https://github.com/netdata/netdata/edit/master/integrations/cl meta_yaml: "https://github.com/netdata/netdata/edit/master/integrations/cloud-notifications/metadata.yaml" sidebar_label: "Discord" learn_status: "Published" -learn_rel_path: "Alerting/Notifications/Centralized Cloud Notifications" +learn_rel_path: "Alerts & Notifications/Notifications/Centralized Cloud Notifications" message: "DO NOT EDIT THIS FILE DIRECTLY, IT IS GENERATED BY THE NOTIFICATION'S metadata.yaml FILE" endmeta--> diff --git a/integrations/cloud-notifications/integrations/mattermost.md b/integrations/cloud-notifications/integrations/mattermost.md index 39c584f48..cc48921e5 100644 --- a/integrations/cloud-notifications/integrations/mattermost.md +++ b/integrations/cloud-notifications/integrations/mattermost.md @@ -3,7 +3,7 @@ custom_edit_url: "https://github.com/netdata/netdata/edit/master/integrations/cl meta_yaml: "https://github.com/netdata/netdata/edit/master/integrations/cloud-notifications/metadata.yaml" sidebar_label: "Mattermost" learn_status: "Published" -learn_rel_path: "Alerting/Notifications/Centralized Cloud Notifications" +learn_rel_path: "Alerts & Notifications/Notifications/Centralized Cloud Notifications" message: "DO NOT EDIT THIS FILE DIRECTLY, IT IS GENERATED BY THE NOTIFICATION'S metadata.yaml FILE" endmeta--> diff --git a/integrations/cloud-notifications/integrations/microsoft_teams.md b/integrations/cloud-notifications/integrations/microsoft_teams.md new file mode 100644 index 000000000..e015114f5 --- /dev/null +++ b/integrations/cloud-notifications/integrations/microsoft_teams.md @@ -0,0 +1,57 @@ + + +# Microsoft Teams + + + + + +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. + + + + +## Setup + +### 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. + + diff --git a/integrations/cloud-notifications/integrations/netdata_mobile_app.md b/integrations/cloud-notifications/integrations/netdata_mobile_app.md new file mode 100644 index 000000000..71fc92c16 --- /dev/null +++ b/integrations/cloud-notifications/integrations/netdata_mobile_app.md @@ -0,0 +1,41 @@ + + +# Netdata Mobile App + + + + + +From the Netdata Cloud UI, you can manage your user notification settings and enable the configuration to deliver notifications on the Netdata Mobile Application. + + + + +## Setup + +### Prerequisites +- A Netdata Cloud account +- You need to have the Netdata Mobile Application installed on your [Android](https://play.google.com/store/apps/details?id=cloud.netdata.android&pli=1) or [iOS](https://apps.apple.com/in/app/netdata-mobile/id6474659622) phone. + +### Netdata Mobile App Configuration +Steps to login to the Netdata Mobile Application to receive alert and reachability and alert notifications: +1. Download the Netdata Mobile Application from [Google Play Store](https://play.google.com/store/apps/details?id=cloud.netdata.android&pli=1) or the [iOS App Store](https://apps.apple.com/in/app/netdata-mobile/id6474659622) +2. Open the App and Choose the Sign In Option + - Sign In with Email Address: Enter the Email Address of your registered Netdata Cloud Account and Click on the Verification link received by Email on your mobile device. + - Sign In with QR Code: Scan the QR Code from your `Netdata Cloud` UI under **User Settings** --> **Notifications** --> **Mobile App Notifications** --> **Show QR Code** +3. Start receiving alert and reachability notifications for your **Space(s)** on a **Paid Business Subscription** + +### Netdata Configuration Steps +1. Click on the **User settings** on the bottom left of your screen (your profile icon) +2. Click on the **Notifications** tab +3. Enable **Mobile App Notifications** if disabled (Enabled by default) +4. Use the **Show QR Code** Option to login to your mobile device by scanning the **QR Code** + + diff --git a/integrations/cloud-notifications/integrations/opsgenie.md b/integrations/cloud-notifications/integrations/opsgenie.md index 10e906e14..21c916209 100644 --- a/integrations/cloud-notifications/integrations/opsgenie.md +++ b/integrations/cloud-notifications/integrations/opsgenie.md @@ -3,7 +3,7 @@ custom_edit_url: "https://github.com/netdata/netdata/edit/master/integrations/cl meta_yaml: "https://github.com/netdata/netdata/edit/master/integrations/cloud-notifications/metadata.yaml" sidebar_label: "Opsgenie" learn_status: "Published" -learn_rel_path: "Alerting/Notifications/Centralized Cloud Notifications" +learn_rel_path: "Alerts & Notifications/Notifications/Centralized Cloud Notifications" message: "DO NOT EDIT THIS FILE DIRECTLY, IT IS GENERATED BY THE NOTIFICATION'S metadata.yaml FILE" endmeta--> diff --git a/integrations/cloud-notifications/integrations/pagerduty.md b/integrations/cloud-notifications/integrations/pagerduty.md index eafb6ceb3..9d1f81ee1 100644 --- a/integrations/cloud-notifications/integrations/pagerduty.md +++ b/integrations/cloud-notifications/integrations/pagerduty.md @@ -3,7 +3,7 @@ custom_edit_url: "https://github.com/netdata/netdata/edit/master/integrations/cl meta_yaml: "https://github.com/netdata/netdata/edit/master/integrations/cloud-notifications/metadata.yaml" sidebar_label: "PagerDuty" learn_status: "Published" -learn_rel_path: "Alerting/Notifications/Centralized Cloud Notifications" +learn_rel_path: "Alerts & Notifications/Notifications/Centralized Cloud Notifications" message: "DO NOT EDIT THIS FILE DIRECTLY, IT IS GENERATED BY THE NOTIFICATION'S metadata.yaml FILE" endmeta--> @@ -32,7 +32,7 @@ Steps to configure your PagerDuty to receive notifications from Netdata: 1. Create a service to receive events from your services directory page on PagerDuty 2. At step 3, select `Events API V2` Integration or **View Webhooks** if you already have some defined -3. Once the service is created you will be redirected to its configuration page, where you can copy the **integration key**, that you will need need to add to your notification configuration on Netdata UI. +3. Once the service is created, you will be redirected to its configuration page, where you can copy the **Integration Key** and **Integration URL (Alert Events)** fields to add them to your notification configuration in the Netdata UI. ### Netdata Configuration Steps @@ -47,5 +47,6 @@ Steps to configure your PagerDuty to receive notifications from Netdata: - 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 PagerDuty: - Integration Key - is a 32 character key provided by PagerDuty to receive events on your service. + - Integration URL (Alert Events) - is the URL provided by PagerDuty where we will send notifications. diff --git a/integrations/cloud-notifications/integrations/rocketchat.md b/integrations/cloud-notifications/integrations/rocketchat.md index d447c28f9..9f625f3f7 100644 --- a/integrations/cloud-notifications/integrations/rocketchat.md +++ b/integrations/cloud-notifications/integrations/rocketchat.md @@ -3,7 +3,7 @@ custom_edit_url: "https://github.com/netdata/netdata/edit/master/integrations/cl meta_yaml: "https://github.com/netdata/netdata/edit/master/integrations/cloud-notifications/metadata.yaml" sidebar_label: "RocketChat" learn_status: "Published" -learn_rel_path: "Alerting/Notifications/Centralized Cloud Notifications" +learn_rel_path: "Alerts & Notifications/Notifications/Centralized Cloud Notifications" message: "DO NOT EDIT THIS FILE DIRECTLY, IT IS GENERATED BY THE NOTIFICATION'S metadata.yaml FILE" endmeta--> diff --git a/integrations/cloud-notifications/integrations/slack.md b/integrations/cloud-notifications/integrations/slack.md index 162bcbce3..9bb5be2c8 100644 --- a/integrations/cloud-notifications/integrations/slack.md +++ b/integrations/cloud-notifications/integrations/slack.md @@ -3,7 +3,7 @@ custom_edit_url: "https://github.com/netdata/netdata/edit/master/integrations/cl meta_yaml: "https://github.com/netdata/netdata/edit/master/integrations/cloud-notifications/metadata.yaml" sidebar_label: "Slack" learn_status: "Published" -learn_rel_path: "Alerting/Notifications/Centralized Cloud Notifications" +learn_rel_path: "Alerts & Notifications/Notifications/Centralized Cloud Notifications" message: "DO NOT EDIT THIS FILE DIRECTLY, IT IS GENERATED BY THE NOTIFICATION'S metadata.yaml FILE" endmeta--> diff --git a/integrations/cloud-notifications/integrations/splunk.md b/integrations/cloud-notifications/integrations/splunk.md new file mode 100644 index 000000000..6cbf6b042 --- /dev/null +++ b/integrations/cloud-notifications/integrations/splunk.md @@ -0,0 +1,47 @@ + + +# Splunk + + + + + +From the Cloud interface, you can manage your space's notification settings and from these you can add a specific configuration to get notifications delivered on Splunk. + + + + +## Setup + +### Prerequisites + +To add Splunk notification you need: + +- A Netdata Cloud account +- Access to the space as an **administrator** +- Space needs to be on **Business** plan or higher +- URI and token for your Splunk HTTP Event Collector. Refer to the [Splunk documentation](https://docs.splunk.com/Documentation/Splunk/latest/Data/UsetheHTTPEventCollector) for detailed instructions. + +### Steps + +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 **Splunk** 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 - provide a descriptive name for your configuration to easily identify it. + - Rooms - select the nodes or areas of your infrastructure you want to receive notifications about. + - Notification - choose the type of notifications you want to receive: All Alerts and unreachable, All Alerts, Critical only. + - **Integration configuration** are the specific notification integration required settings, which vary by notification method. For Splunk: + - HTTP Event Collector URI - The URI of your HTTP event collector in Splunk + - HTTP Event Collector Token - the token that Splunk provided to you when you created the HTTP Event Collector + + diff --git a/integrations/cloud-notifications/integrations/telegram.md b/integrations/cloud-notifications/integrations/telegram.md index fc3caf457..83d94ecca 100644 --- a/integrations/cloud-notifications/integrations/telegram.md +++ b/integrations/cloud-notifications/integrations/telegram.md @@ -3,7 +3,7 @@ custom_edit_url: "https://github.com/netdata/netdata/edit/master/integrations/cl meta_yaml: "https://github.com/netdata/netdata/edit/master/integrations/cloud-notifications/metadata.yaml" sidebar_label: "Telegram" learn_status: "Published" -learn_rel_path: "Alerting/Notifications/Centralized Cloud Notifications" +learn_rel_path: "Alerts & Notifications/Notifications/Centralized Cloud Notifications" message: "DO NOT EDIT THIS FILE DIRECTLY, IT IS GENERATED BY THE NOTIFICATION'S metadata.yaml FILE" endmeta--> diff --git a/integrations/cloud-notifications/integrations/webhook.md b/integrations/cloud-notifications/integrations/webhook.md index ae89e12f3..7e3aaea25 100644 --- a/integrations/cloud-notifications/integrations/webhook.md +++ b/integrations/cloud-notifications/integrations/webhook.md @@ -3,7 +3,7 @@ custom_edit_url: "https://github.com/netdata/netdata/edit/master/integrations/cl meta_yaml: "https://github.com/netdata/netdata/edit/master/integrations/cloud-notifications/metadata.yaml" sidebar_label: "Webhook" learn_status: "Published" -learn_rel_path: "Alerting/Notifications/Centralized Cloud Notifications" +learn_rel_path: "Alerts & Notifications/Notifications/Centralized Cloud Notifications" message: "DO NOT EDIT THIS FILE DIRECTLY, IT IS GENERATED BY THE NOTIFICATION'S metadata.yaml FILE" endmeta--> @@ -188,9 +188,9 @@ From the Netdata Cloud UI, you can manage your space's notification settings and In bearer token authentication, the client sends a request with an Authorization header that includes a bearer token. The server then uses this token to authenticate the client. Bearer tokens are typically generated by an authentication service, and are passed to the client after a successful authentication. If this method is selected, the user can set the token to be used for connecting to the destination service. - ###### Challenge secret + ##### Challenge secret - To validate that you has ownership of the web application that will receive the webhook events, we are using a challenge response check mechanism. + To validate that you have ownership of the web application that will receive the webhook events, we are using a challenge response check mechanism. This mechanism works as follows: diff --git a/integrations/cloud-notifications/metadata.yaml b/integrations/cloud-notifications/metadata.yaml index c03317242..323fbda6a 100644 --- a/integrations/cloud-notifications/metadata.yaml +++ b/integrations/cloud-notifications/metadata.yaml @@ -1,5 +1,38 @@ # yamllint disable rule:line-length --- +- id: 'notify-cloud-mobile-app' + meta: + name: 'Netdata Mobile App' + link: 'https://netdata.cloud' + categories: + - notify.cloud + icon_filename: 'netdata.png' + keywords: + - mobile-app + - phone + - personal-notifications + overview: + notification_description: "From the Netdata Cloud UI, you can manage your user notification settings and enable the configuration to deliver notifications on the Netdata Mobile Application." + notification_limitations: '' + setup: + description: | + ### Prerequisites + - A Netdata Cloud account + - You need to have the Netdata Mobile Application installed on your [Android](https://play.google.com/store/apps/details?id=cloud.netdata.android&pli=1) or [iOS](https://apps.apple.com/in/app/netdata-mobile/id6474659622) phone. + + ### Netdata Mobile App Configuration + Steps to login to the Netdata Mobile Application to receive alert and reachability and alert notifications: + 1. Download the Netdata Mobile Application from [Google Play Store](https://play.google.com/store/apps/details?id=cloud.netdata.android&pli=1) or the [iOS App Store](https://apps.apple.com/in/app/netdata-mobile/id6474659622) + 2. Open the App and Choose the Sign In Option + - Sign In with Email Address: Enter the Email Address of your registered Netdata Cloud Account and Click on the Verification link received by Email on your mobile device. + - Sign In with QR Code: Scan the QR Code from your `Netdata Cloud` UI under **User Settings** --> **Notifications** --> **Mobile App Notifications** --> **Show QR Code** + 3. Start receiving alert and reachability notifications for your **Space(s)** on a **Paid Business Subscription** + + ### Netdata Configuration Steps + 1. Click on the **User settings** on the bottom left of your screen (your profile icon) + 2. Click on the **Notifications** tab + 3. Enable **Mobile App Notifications** if disabled (Enabled by default) + 4. Use the **Show QR Code** Option to login to your mobile device by scanning the **QR Code** - id: 'notify-cloud-discord' meta: name: 'Discord' @@ -327,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' @@ -372,6 +455,44 @@ - Contact the [@myidbot](https://t.me/myidbot) bot and send the `/getid` command to get your personal chat ID, or invite it into a group and use the `/getgroupid` command to get the group chat ID. - Alternatively, you can get the chat ID directly from the bot API. Send your bot a command in the chat you want to use, then check `https://api.telegram.org/bot{YourBotToken}/getUpdates`, eg. `https://api.telegram.org/bot111122223:7OpFlFFRzRBbrUUmIjj5HF9Ox2pYJZy5/getUpdates` +- id: 'notify-cloud-splunk' + meta: + name: 'Splunk' + link: 'https://splunk.com/' + categories: + - notify.cloud + icon_filename: 'splunk-black.svg' + keywords: + - Splunk + overview: + notification_description: "From the Cloud interface, you can manage your space's notification settings and from these you can add a specific configuration to get notifications delivered on Splunk." + notification_limitations: '' + setup: + description: | + ### Prerequisites + + To add Splunk notification you need: + + - A Netdata Cloud account + - Access to the space as an **administrator** + - Space needs to be on **Business** plan or higher + - URI and token for your Splunk HTTP Event Collector. Refer to the [Splunk documentation](https://docs.splunk.com/Documentation/Splunk/latest/Data/UsetheHTTPEventCollector) for detailed instructions. + + ### Steps + + 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 **Splunk** 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 - provide a descriptive name for your configuration to easily identify it. + - Rooms - select the nodes or areas of your infrastructure you want to receive notifications about. + - Notification - choose the type of notifications you want to receive: All Alerts and unreachable, All Alerts, Critical only. + - **Integration configuration** are the specific notification integration required settings, which vary by notification method. For Splunk: + - HTTP Event Collector URI - The URI of your HTTP event collector in Splunk + - HTTP Event Collector Token - the token that Splunk provided to you when you created the HTTP Event Collector + - id: 'notify-cloud-webhook' meta: name: 'Webhook' @@ -555,9 +676,9 @@ In bearer token authentication, the client sends a request with an Authorization header that includes a bearer token. The server then uses this token to authenticate the client. Bearer tokens are typically generated by an authentication service, and are passed to the client after a successful authentication. If this method is selected, the user can set the token to be used for connecting to the destination service. - ###### Challenge secret + ##### Challenge secret - To validate that you has ownership of the web application that will receive the webhook events, we are using a challenge response check mechanism. + To validate that you have ownership of the web application that will receive the webhook events, we are using a challenge response check mechanism. This mechanism works as follows: -- cgit v1.2.3