path: root/integrations/cloud-notifications/metadata.yaml

# 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'
    link: 'https://discord.com/'
    categories:
      - notify.cloud
    icon_filename: 'discord.png'
  keywords:
    - discord
    - community
  overview:
    notification_description: "From the Netdata Cloud UI, you can manage your space's notification settings and enable the configuration to deliver notifications on Discord."
    notification_limitations: ''
  setup:
    description: |
      ### Prerequisites
      - A Netdata Cloud account
      - Access to the Netdata Space as an **administrator**
      - You need to have a Discord server able to receive webhooks integrations.

      ### Discord Server Configuration
      Steps to configure your Discord server to receive [webhook notifications](https://support.discord.com/hc/en-us/articles/228383668) from Netdata:
      1. Go to `Server Settings` --> `Integrations`
      2. **Create Webhook** or **View Webhooks** if you already have some defined
      3. Specify the **Name** and **Channel** on your new webhook
      4. Use Webhook URL to add your notification configuration on Netdata UI

      ### Netdata Configuration 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 **Discord** 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 Discord:
          - Define the type channel you want to send notifications to: **Text channel** or **Forum channel**
          - Webhook URL - URL provided on Discord for the channel you want to receive your notifications.
          - Thread name - if the Discord channel is a **Forum channel** you will need to provide the thread name as well

- id: 'notify-cloud-pagerduty'
  meta:
    name: 'PagerDuty'
    link: 'https://www.pagerduty.com/'
    categories:
      - notify.cloud
    icon_filename: 'pagerduty.png'
  keywords:
    - pagerduty
  overview:
    notification_description: "From the Netdata Cloud UI, you can manage your space's notification settings and enable the configuration to deliver notifications on PagerDuty."
    notification_limitations: ''
  setup:
    description: |
      ### Prerequisites
      - A Netdata Cloud account
      - Access to the Netdata Space as an **administrator**
      - The Netdata Space needs to be on **Business** plan or higher
      - You need to have a PagerDuty service to receive events using webhooks.


      ### PagerDuty Server Configuration
      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.

      ### Netdata Configuration 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 **PagerDuty** 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 PagerDuty:
          - Integration Key - is a 32 character key provided by PagerDuty to receive events on your service.

- id: 'notify-cloud-slack'
  meta:
    name: 'Slack'
    link: 'https://slack.com/'
    categories:
      - notify.cloud
    icon_filename: 'slack.png'
  keywords:
    - slack
  overview:
    notification_description: "From the Netdata Cloud UI, you can manage your space's notification settings and enable the configuration to deliver notifications on Slack."
    notification_limitations: ''
  setup:
    description: |
      ### Prerequisites

      - A Netdata Cloud account
      - Access to the Netdata Space as an **administrator**
      - The Netdata Space needs to be on **Business** plan or higher
      - You need to have a Slack app on your workspace to receive the Webhooks.

      ### Slack Server Configuration

      Steps to configure your Slack to receive notifications from Netdata:

      1. Create an app to receive webhook integrations. Check [Create an app](https://api.slack.com/apps?new_app=1) from Slack documentation for further details
      2. Install the app on your workspace
      3. Configure Webhook URLs for your workspace
        - On your app go to **Incoming Webhooks** and click on **activate incoming webhooks**
        - At the bottom of **Webhook URLs for Your Workspace** section you have **Add New Webhook to Workspace**
        - After pressing that specify the channel where you want your notifications to be delivered
        - Once completed copy the Webhook URL that you will need to add to your notification configuration on Netdata UI

      For more details please check Slacks's article [Incoming webhooks for Slack](https://slack.com/help/articles/115005265063-Incoming-webhooks-for-Slack).

      ### Netdata Configuration 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 **Slack** 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 Slack:
          - Webhook URL - URL provided on Slack for the channel you want to receive your notifications.

- id: 'notify-cloud-opsgenie'
  meta:
    name: 'Opsgenie'
    link: 'https://www.atlassian.com/software/opsgenie'
    categories:
      - notify.cloud
    icon_filename: 'opsgenie.png'
  keywords:
    - opsgenie
    - atlassian
  overview:
    notification_description: "From the Netdata Cloud UI, you can manage your space's notification settings and enable the configuration to deliver notifications on Opsgenie."
    notification_limitations: ''
  setup:
    description: |
      ### Prerequisites

      - A Netdata Cloud account
      - Access to the Netdata Space as an **administrator**
      - The Netdata Space needs to be on **Business** plan or higher
      - You need to have permissions on Opsgenie to add new integrations.

      ### Opsgenie Server Configuration