Add Webb.ai integration tile (#2407)

* Add Webb.ai integration folder * update oauth_clients.json * update readme and oauth_clients.json * update app_id and oauth client_id * add Queried Data Type in classifier_tags * update app_id to conform to guidelines * address review comments * update overview and oauth scopes * add webbai_rca dashboard * update dashboards in manifest * format dashboards/webbai_rca.json * address review comments * update readme * add images; update overview in readme * Update README.md * convert images to 16:9 aspect ratio * Apply suggestions from code review Co-authored-by: Sandra (neko) <165049174+neko-dd@users.noreply.github.com> * Update webb_ai/README.md Co-authored-by: Sandra (neko) <165049174+neko-dd@users.noreply.github.com> * apply neko-dd's suggestion Co-authored-by: Sandra (neko) <165049174+neko-dd@users.noreply.github.com> * apply neko-dd's suggestion Co-authored-by: Sandra (neko) <165049174+neko-dd@users.noreply.github.com> * Apply emarsha94 suggestion Co-authored-by: emarsha94 <52013262+emarsha94@users.noreply.github.com> --------- Co-authored-by: Chi Su <sunstick@gmail.com> Co-authored-by: Sandra (neko) <165049174+neko-dd@users.noreply.github.com> Co-authored-by: emarsha94 <52013262+emarsha94@users.noreply.github.com>
DataDog · Jul 24, 2024 · fea5368 · fea5368
1 parent 8b5c41e
commit fea5368
Show file tree

Hide file tree

Showing 11 changed files with 373 additions and 0 deletions.
diff --git a/.github/CODEOWNERS b/.github/CODEOWNERS
@@ -213,6 +213,7 @@
 /vespa/                                  @gjoranv dd@vespa.ai
 /vns3/                                   @DataDog/agent-integrations
 /wayfinder/                              @jonny-scott80 jonny_scott@outlook.com
+/webb_ai/                                @anirudhwebbai support@webb.ai
 /yugabytedb_managed/                     @DataDog/saas-integrations @DataDog/ecosystems-review daniel@yugabyte.com
 /zabbix/                                 @KosukeKamiya
 /zebrium/                                @rodbagg @DataDog/ecosystems-review

diff --git a/webb_ai/CHANGELOG.md b/webb_ai/CHANGELOG.md
@@ -0,0 +1,7 @@
+# CHANGELOG - Webb.ai
+
+## 1.0.0 / 2024-07-26
+
+***Added***:
+
+* Initial Release
diff --git a/webb_ai/README.md b/webb_ai/README.md
@@ -0,0 +1,54 @@
+# Webb.ai
+
+## Overview
+
+Matt by Webb.ai is the first AI-enabled reliability engineer.
+Matt troubleshoots monitors and alerts from Datadog, Kubernetes, and cloud providers like AWS, Azure, and GCP.
+It identifies the root cause of an alert or incident in less than 5 mins.
+
+With this integration, Matt automatically identifies alerts from Datadog and troubleshoots them, and the mean time to debug those alerts is reduced significantly. 80-90% of troubleshooting is automated, greatly reducing the debugging time for on-call engineers.
+
+This integration queries the following data:
+- Datadog events
+- Datadog metrics and tags
+
+This integration sends events to Datadog, including the root cause analysis performed by Matt and changes in Kubernetes clusters.
+You can view detailed root cause analyses for your alerts, including all hypotheses analyzed and the exact steps Matt took with supporting evidence.
+
+## Setup
+
+1. Visit [Webb.ai][2] and sign up for the free service.
+2. Navigate to Webb.ai tile in the [Datadog integrations page][5] and click **Install Integration**.
+3. Go to the **Configure** tab and click **Connect Accounts**.
+4. Follow the series of OAuth steps to finish setting up the integration.
+
+## Uninstallation
+To remove the Datadog integration from Webb.ai, navigate to the [Webb.ai integrations page][1] and delete the Datadog integration from the list.
+
+Once this integration has been uninstalled, any previous authorizations are revoked.
+
+To ensure that all API keys associated with this integration are disabled, search for the integration name on the [Datadog API Keys][4] page.
+
+## Data Collected
+
+### Metrics
+Webb.ai does not generate any metrics; it relies on Datadog metrics.
+
+### Service Checks
+Webb.ai does not include any service checks.
+
+### Events
+Webb.ai sends the following events to Datadog:
+- Root cause analyses performed by Matt
+- Changes observed in Kubernetes clusters 
+
+## Troubleshooting
+
+Need help? Contact [Webb.ai support][3].
+
+[1]: https://app.webb.ai/integrations
+[2]: https://app.webb.ai/
+[3]: mailto:support@webb.ai
+[4]: https://app.datadoghq.com/organization-settings/api-keys
+[5]: https://app.datadoghq.com/integrations
+
diff --git a/webb_ai/assets/dashboards/webb_ai_overview.json b/webb_ai/assets/dashboards/webb_ai_overview.json
@@ -0,0 +1,219 @@
+{
+  "title": "Webb.ai Overview",
+  "description": "Matt by Webb.ai is the first AI-enabled reliability engineer. Matt troubleshoots alerts from observability tools like Datadog, incidents from infrastructure like Kubernetes, and alerts from  cloud providers like AWS, Azure, and Google Cloud.\n\nThis dashboard provides the list of such RCAs and changes in your Kubernetes cluster.\n\nView RCAs performed by Matt [here](https://app.webb.ai/issues?ts=24h).\n\nView changes in your Kubernetes clusters [here](https://app.webb.ai/issues?ts=24h).",
+  "widgets": [
+    {
+      "id": 325090501093728,
+      "definition": {
+        "title": "About <integration>",
+        "banner_img": "https://d2s77pndg98mr9.cloudfront.net/logos/full_logo_1063x400.svg",
+        "show_title": false,
+        "type": "group",
+        "layout_type": "ordered",
+        "widgets": [
+          {
+            "id": 6544225029855812,
+            "definition": {
+              "type": "note",
+              "content": "This dashboard provides you the list of RCAs performed by Matt for troubleshooting Datadog alerts, and kubernetes issues.\n\n\nIt also shows you the changes happening in your Kubernetes clusters in real time.",
+              "background_color": "white",
+              "font_size": "14",
+              "text_align": "left",
+              "vertical_align": "top",
+              "show_tick": false,
+              "tick_pos": "50%",
+              "tick_edge": "left",
+              "has_padding": true
+            },
+            "layout": {
+              "x": 0,
+              "y": 0,
+              "width": 4,
+              "height": 2
+            }
+          },
+          {
+            "id": 7032118608350450,
+            "definition": {
+              "type": "note",
+              "content": "- Datadog monitors in alert state are continuously pulled by Matt\n- Once webb.ai receives the alert, it automatically troubleshoots it using relevant Datadog metrics and Kubernetes information\n- Once the troubleshooting is done, you can view the analysis and complete steps that Matt has taken\n- An event is sent to Datadog for every RCA done by Matt\n- An event is sent to Datadog for every Kubernetes change observed in your environment",
+              "background_color": "white",
+              "font_size": "14",
+              "text_align": "left",
+              "vertical_align": "top",
+              "show_tick": false,
+              "tick_pos": "50%",
+              "tick_edge": "left",
+              "has_padding": true
+            },
+            "layout": {
+              "x": 4,
+              "y": 0,
+              "width": 4,
+              "height": 2
+            }
+          }
+        ]
+      },
+      "layout": {
+        "x": 0,
+        "y": 0,
+        "width": 8,
+        "height": 5
+      }
+    },
+    {
+      "id": 1741971994096136,
+      "definition": {
+        "title": "Overview",
+        "background_color": "white",
+        "show_title": true,
+        "type": "group",
+        "layout_type": "ordered",
+        "widgets": [
+          {
+            "id": 7493157102499174,
+            "definition": {
+              "type": "note",
+              "content": "Matt by Webb.ai is the first AI-enabled reliability engineer. Matt troubleshoots alerts from observability tools like Datadog, incidents from infrastructure like Kubernetes, and alerts from  cloud providers like AWS, Azure, and Google Cloud.\n\nThis dashboard provides the list of such RCAs and changes in your Kubernetes cluster.\n\nView RCAs performed by Matt [here](https://app.webb.ai).\n\nView changes in your Kubernetes clusters [here](https://app.webb.ai/changes).",
+              "background_color": "white",
+              "font_size": "14",
+              "text_align": "left",
+              "vertical_align": "top",
+              "show_tick": false,
+              "tick_pos": "50%",
+              "tick_edge": "left",
+              "has_padding": true
+            },
+            "layout": {
+              "x": 0,
+              "y": 0,
+              "width": 4,
+              "height": 4
+            }
+          }
+        ]
+      },
+      "layout": {
+        "x": 8,
+        "y": 0,
+        "width": 4,
+        "height": 5
+      }
+    },
+    {
+      "id": 3955370034957714,
+      "definition": {
+        "title": "RCAs by Matt",
+        "background_color": "vivid_green",
+        "show_title": true,
+        "type": "group",
+        "layout_type": "ordered",
+        "widgets": [
+          {
+            "id": 4605236168039992,
+            "definition": {
+              "title": "",
+              "title_size": "16",
+              "title_align": "left",
+              "requests": [
+                {
+                  "response_format": "event_list",
+                  "query": {
+                    "query_string": "tags:webbai_rca ",
+                    "data_source": "event_stream",
+                    "event_size": "l"
+                  },
+                  "columns": []
+                }
+              ],
+              "type": "list_stream"
+            },
+            "layout": {
+              "x": 0,
+              "y": 0,
+              "width": 4,
+              "height": 4
+            }
+          },
+          {
+            "id": 5706397850700140,
+            "definition": {
+              "type": "note",
+              "content": "This is the list of RCAs performed by Matt.\n\nFull list with filters can be accessed [here](https://app.webb.ai/issues).\n",
+              "background_color": "yellow",
+              "font_size": "14",
+              "text_align": "left",
+              "vertical_align": "center",
+              "show_tick": true,
+              "tick_pos": "50%",
+              "tick_edge": "left",
+              "has_padding": true
+            },
+            "layout": {
+              "x": 4,
+              "y": 0,
+              "width": 2,
+              "height": 4
+            }
+          }
+        ]
+      },
+      "layout": {
+        "x": 0,
+        "y": 0,
+        "width": 6,
+        "height": 5,
+        "is_column_break": true
+      }
+    },
+    {
+      "id": 274546046144418,
+      "definition": {
+        "title": "Kubernetes Changes",
+        "background_color": "vivid_orange",
+        "show_title": true,
+        "type": "group",
+        "layout_type": "ordered",
+        "widgets": [
+          {
+            "id": 7082901580363058,
+            "definition": {
+              "title": "",
+              "title_size": "16",
+              "title_align": "left",
+              "requests": [
+                {
+                  "response_format": "event_list",
+                  "query": {
+                    "query_string": "tags:webbai_change ",
+                    "data_source": "event_stream",
+                    "event_size": "s"
+                  },
+                  "columns": []
+                }
+              ],
+              "type": "list_stream"
+            },
+            "layout": {
+              "x": 0,
+              "y": 0,
+              "width": 6,
+              "height": 4
+            }
+          }
+        ]
+      },
+      "layout": {
+        "x": 6,
+        "y": 0,
+        "width": 6,
+        "height": 5
+      }
+    }
+  ],
+  "template_variables": [],
+  "layout_type": "ordered",
+  "notify_list": [],
+  "reflow_type": "fixed"
+}
diff --git a/webb_ai/assets/logos/logo-light.png b/webb_ai/assets/logos/logo-light.png
diff --git a/webb_ai/assets/logos/logo-light.svg b/webb_ai/assets/logos/logo-light.svg
diff --git a/webb_ai/assets/oauth_clients.json b/webb_ai/assets/oauth_clients.json
@@ -0,0 +1,21 @@
+{
+  "integration": {
+    "scopes": [
+      "api_keys_write",
+      "dashboards_read",
+      "events_read",
+      "metrics_read",
+      "monitors_read",
+      "timeseries_query"
+    ],
+    "client_role": "integration",
+    "name": "Webb.ai",
+    "onboarding_url": "https://app.webb.ai/integrations/datadog/authorize",
+    "description": "Webb.ai datadog integration",
+    "redirect_uris": [
+      "https://staging.app.webb.ai/integrations/datadog/redirect",
+      "https://app.webb.ai/integrations/datadog/redirect"
+    ],
+    "id": "b035e7f0-1f1d-11ef-ba0f-da7ad0900002"
+  }
+}
diff --git a/webb_ai/images/webb_ai-datadog-dashboard.jpg b/webb_ai/images/webb_ai-datadog-dashboard.jpg
diff --git a/webb_ai/images/webb_ai-rca-summary.jpg b/webb_ai/images/webb_ai-rca-summary.jpg
diff --git a/webb_ai/images/webb_ai-troubleshooting-steps.jpg b/webb_ai/images/webb_ai-troubleshooting-steps.jpg