diff options
Diffstat (limited to 'integrations/cloud-notifications/metadata.yaml')
-rw-r--r-- | integrations/cloud-notifications/metadata.yaml | 125 |
1 files changed, 123 insertions, 2 deletions
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: |