From 0073b8a045f978cdbcb950ecdf87c08f19acf185 Mon Sep 17 00:00:00 2001
From: Tal Borenstein <tal@keephq.dev>
Date: Sun, 1 Dec 2024 15:56:25 +0200
Subject: [PATCH 1/6] feat: vector dev

---
 .../app/(keep)/providers/provider-tile.tsx    |  10 ++-
 .../app/(keep)/providers/providers-tiles.tsx  |  16 +++--
 keep-ui/public/icons/vectordev-icon.png       | Bin 0 -> 22654 bytes
 keep/api/tasks/process_event_task.py          |   1 +
 keep/providers/base/base_provider.py          |   4 +-
 keep/providers/vectordev_provider/__init__.py |   0
 .../vectordev_provider/vectordev_provider.py  |  64 ++++++++++++++++++
 7 files changed, 83 insertions(+), 12 deletions(-)
 create mode 100644 keep-ui/public/icons/vectordev-icon.png
 create mode 100644 keep/providers/vectordev_provider/__init__.py
 create mode 100644 keep/providers/vectordev_provider/vectordev_provider.py

diff --git a/keep-ui/app/(keep)/providers/provider-tile.tsx b/keep-ui/app/(keep)/providers/provider-tile.tsx
index 2e4ef9c95..209b1a2ba 100644
--- a/keep-ui/app/(keep)/providers/provider-tile.tsx
+++ b/keep-ui/app/(keep)/providers/provider-tile.tsx
@@ -165,8 +165,12 @@ export default function ProviderTile({ provider, onClick }: Props) {
         "min-h-36 tile-basis text-left min-w-0 py-4 px-4 relative group flex justify-around items-center bg-white rounded-lg shadow hover:grayscale-0 gap-3" +
         // Add fixed height only if provider card doesn't have much content
         (!provider.installed && !provider.linked ? " h-32" : "") +
-        (!provider.linked ? "cursor-pointer hover:shadow-lg" : "") +
-        (provider.coming_soon ? " opacity-50 cursor-not-allowed" : "")
+        (!provider.linked
+          ? " cursor-pointer hover:shadow-lg"
+          : " cursor-auto") +
+        (provider.coming_soon && !provider.linked
+          ? " opacity-50 cursor-not-allowed"
+          : "")
       }
       onClick={provider.coming_soon ? undefined : onClick}
       disabled={provider.coming_soon}
@@ -219,7 +223,7 @@ export default function ProviderTile({ provider, onClick }: Props) {
           <div>
             <Title className="capitalize" title={provider.details?.name}>
               {provider.display_name}{" "}
-              {provider.coming_soon && (
+              {provider.coming_soon && !provider.linked && (
                 <span className="text-sm">(Coming Soon)</span>
               )}
             </Title>
diff --git a/keep-ui/app/(keep)/providers/providers-tiles.tsx b/keep-ui/app/(keep)/providers/providers-tiles.tsx
index 9e74bc65b..29030fb9f 100644
--- a/keep-ui/app/(keep)/providers/providers-tiles.tsx
+++ b/keep-ui/app/(keep)/providers/providers-tiles.tsx
@@ -1,5 +1,5 @@
 "use client";
-import { Icon, Title } from "@tremor/react";
+import { Title } from "@tremor/react";
 import { Providers, Provider } from "./providers";
 import { useEffect, useState } from "react";
 // TODO: replace with custom component, package is not updated for last 4 years
@@ -9,6 +9,7 @@ import ProviderTile from "./provider-tile";
 import "react-sliding-side-panel/lib/index.css";
 import { useSearchParams } from "next/navigation";
 import { QuestionMarkCircleIcon } from "@heroicons/react/24/outline";
+import { Tooltip } from "@/shared/ui";
 
 const ProvidersTiles = ({
   providers,
@@ -95,12 +96,13 @@ const ProvidersTiles = ({
         <Title>{getSectionTitle()}</Title>
         {linkedProvidersMode && (
           <div className="relative">
-            <Icon
-              icon={QuestionMarkCircleIcon} // Use the appropriate icon for your use case
-              className="text-gray-400 hover:text-gray-600"
-              size="sm"
-              tooltip="Providers that send alerts to Keep and are not installed."
-            />
+            <Tooltip
+              content={
+                <>Providers that send alerts to Keep and are not installed.</>
+              }
+            >
+              <QuestionMarkCircleIcon className="w-4 h-4" />
+            </Tooltip>
           </div>
         )}
       </div>
diff --git a/keep-ui/public/icons/vectordev-icon.png b/keep-ui/public/icons/vectordev-icon.png
new file mode 100644
index 0000000000000000000000000000000000000000..47e7d084e82f359ba6bf94b1a566387d3ef6ddee
GIT binary patch
literal 22654
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
ZSt+&7zxlHtO5h3;>1r8iqSPJX{{#MQ`H}zt

literal 0
HcmV?d00001

diff --git a/keep/api/tasks/process_event_task.py b/keep/api/tasks/process_event_task.py
index 28ed135fa..ec2cf276a 100644
--- a/keep/api/tasks/process_event_task.py
+++ b/keep/api/tasks/process_event_task.py
@@ -554,6 +554,7 @@ def process_event(
             provider_type is not None
             and isinstance(event, dict)
             or isinstance(event, FormData)
+            or isinstance(event, list)
         ):
             try:
                 provider_class = ProvidersFactory.get_provider_class(provider_type)
diff --git a/keep/providers/base/base_provider.py b/keep/providers/base/base_provider.py
index 2a1934026..f8e430c74 100644
--- a/keep/providers/base/base_provider.py
+++ b/keep/providers/base/base_provider.py
@@ -316,7 +316,7 @@ def query(self, **kwargs: dict):
 
     @staticmethod
     def _format_alert(
-        event: dict, provider_instance: "BaseProvider" = None
+        event: dict | list[dict], provider_instance: "BaseProvider" = None
     ) -> AlertDto | list[AlertDto]:
         """
         Format an incoming alert.
@@ -335,7 +335,7 @@ def _format_alert(
     @classmethod
     def format_alert(
         cls,
-        event: dict,
+        event: dict | list[dict],
         tenant_id: str | None,
         provider_type: str | None,
         provider_id: str | None,
diff --git a/keep/providers/vectordev_provider/__init__.py b/keep/providers/vectordev_provider/__init__.py
new file mode 100644
index 000000000..e69de29bb
diff --git a/keep/providers/vectordev_provider/vectordev_provider.py b/keep/providers/vectordev_provider/vectordev_provider.py
new file mode 100644
index 000000000..2b03ff72d
--- /dev/null
+++ b/keep/providers/vectordev_provider/vectordev_provider.py
@@ -0,0 +1,64 @@
+import dataclasses
+import json
+
+import pydantic
+
+from keep.api.models.alert import AlertDto
+from keep.contextmanager.contextmanager import ContextManager
+from keep.providers.base.base_provider import BaseProvider
+from keep.providers.models.provider_config import ProviderConfig
+
+
+@pydantic.dataclasses.dataclass
+class VectordevProviderAuthConfig:
+    api_key: str = dataclasses.field(
+        metadata={"required": True, "description": "Zendesk API key", "sensitive": True}
+    )
+
+
+class VectordevProvider(BaseProvider):
+    PROVIDER_DISPLAY_NAME = "Vector"
+    PROVIDER_CATEGORY = ["Monitoring", "Developer Tools"]
+    PROVIDER_COMING_SOON = True
+
+    def __init__(
+        self, context_manager: ContextManager, provider_id: str, config: ProviderConfig
+    ):
+        super().__init__(context_manager, provider_id, config)
+
+    def validate_config(self):
+        self.authentication_config = VectordevProviderAuthConfig(
+            **self.config.authentication
+        )
+
+    def _format_alert(
+        event: list[dict], provider_instance: "BaseProvider" = None
+    ) -> AlertDto | list[AlertDto]:
+        events = []
+        # event is a list of events
+        for e in event:
+            event_json = None
+            try:
+                event_json = json.loads(e.get("message"))
+            except json.JSONDecodeError:
+                pass
+
+            events.append(
+                AlertDto(
+                    name="",
+                    host=e.get("host"),
+                    message=e.get("message"),
+                    description=e.get("message"),
+                    lastReceived=e.get("timestamp"),
+                    source_type=e.get("source_type"),
+                    source=["vectordev"],
+                    original_event=event_json,
+                )
+            )
+        return events
+
+    def dispose(self):
+        """
+        No need to dispose of anything, so just do nothing.
+        """
+        pass

From f6f5de6998cdbcd11aa8eecdb6465a5e9ca922ef Mon Sep 17 00:00:00 2001
From: Tal Borenstein <tal@keephq.dev>
Date: Sun, 1 Dec 2024 16:31:59 +0200
Subject: [PATCH 2/6] fix: not zendesk :)

---
 keep/providers/vectordev_provider/vectordev_provider.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/keep/providers/vectordev_provider/vectordev_provider.py b/keep/providers/vectordev_provider/vectordev_provider.py
index 2b03ff72d..c3d6f8a9d 100644
--- a/keep/providers/vectordev_provider/vectordev_provider.py
+++ b/keep/providers/vectordev_provider/vectordev_provider.py
@@ -12,7 +12,7 @@
 @pydantic.dataclasses.dataclass
 class VectordevProviderAuthConfig:
     api_key: str = dataclasses.field(
-        metadata={"required": True, "description": "Zendesk API key", "sensitive": True}
+        metadata={"required": True, "description": "API key", "sensitive": True}
     )
 
 

From 1f10aeb46f81e18348b539550a7e5ef8f4945ce2 Mon Sep 17 00:00:00 2001
From: Tal Borenstein <tal@keephq.dev>
Date: Mon, 2 Dec 2024 14:56:39 +0200
Subject: [PATCH 3/6] fix: fix

---
 keep/api/api.py                                   | 13 -------------
 keep/api/config.py                                | 15 +++++++++++++++
 .../versions/2024-12-01-16-40_3ad5308e7200.py     |  5 ++++-
 3 files changed, 19 insertions(+), 14 deletions(-)

diff --git a/keep/api/api.py b/keep/api/api.py
index e0f9cf0fd..69a5141a6 100644
--- a/keep/api/api.py
+++ b/keep/api/api.py
@@ -52,7 +52,6 @@
 )
 from keep.api.routes.auth import groups as auth_groups
 from keep.api.routes.auth import permissions, roles, users
-from keep.api.routes.dashboard import provision_dashboards
 from keep.event_subscriber.event_subscriber import EventSubscriber
 from keep.identitymanager.identitymanagerfactory import (
     IdentityManagerFactory,
@@ -61,9 +60,7 @@
 
 # load all providers into cache
 from keep.providers.providers_factory import ProvidersFactory
-from keep.providers.providers_service import ProvidersService
 from keep.workflowmanager.workflowmanager import WorkflowManager
-from keep.workflowmanager.workflowstore import WorkflowStore
 
 load_dotenv(find_dotenv())
 keep.api.logging.setup_logging()
@@ -75,7 +72,6 @@
 CONSUMER = os.environ.get("CONSUMER", "true") == "true"
 
 AUTH_TYPE = os.environ.get("AUTH_TYPE", IdentityManagerTypes.NOAUTH.value).lower()
-PROVISION_RESOURCES = os.environ.get("PROVISION_RESOURCES", "true") == "true"
 try:
     KEEP_VERSION = metadata.version("keep")
 except Exception:
@@ -185,15 +181,6 @@ async def root():
     async def on_startup():
         logger.info("Loading providers into cache")
         ProvidersFactory.get_all_providers()
-        if PROVISION_RESOURCES:
-            # provision providers from env. relevant only on single tenant.
-            logger.info("Provisioning providers and workflows")
-            ProvidersService.provision_providers_from_env(SINGLE_TENANT_UUID)
-            logger.info("Providers loaded successfully")
-            WorkflowStore.provision_workflows_from_directory(SINGLE_TENANT_UUID)
-            logger.info("Workflows provisioned successfully")
-            provision_dashboards(SINGLE_TENANT_UUID)
-            logger.info("Dashboards provisioned successfully")
         # Start the services
         logger.info("Starting the services")
         # Start the scheduler
diff --git a/keep/api/config.py b/keep/api/config.py
index a27c4b66d..dfea1b0b1 100644
--- a/keep/api/config.py
+++ b/keep/api/config.py
@@ -5,10 +5,14 @@
 from keep.api.api import AUTH_TYPE
 from keep.api.core.db_on_start import migrate_db, try_create_single_tenant
 from keep.api.core.dependencies import SINGLE_TENANT_UUID
+from keep.api.routes.dashboard import provision_dashboards
 from keep.identitymanager.identitymanagerfactory import IdentityManagerTypes
 from keep.providers.providers_factory import ProvidersFactory
+from keep.providers.providers_service import ProvidersService
+from keep.workflowmanager.workflowstore import WorkflowStore
 
 PORT = int(os.environ.get("PORT", 8080))
+PROVISION_RESOURCES = os.environ.get("PROVISION_RESOURCES", "true") == "true"
 
 keep.api.logging.setup_logging()
 logger = logging.getLogger(__name__)
@@ -19,6 +23,17 @@ def on_starting(server=None):
     logger.info("Keep server starting")
 
     migrate_db()
+
+    if PROVISION_RESOURCES:
+        # provision providers from env. relevant only on single tenant.
+        logger.info("Provisioning providers and workflows")
+        ProvidersService.provision_providers_from_env(SINGLE_TENANT_UUID)
+        logger.info("Providers loaded successfully")
+        WorkflowStore.provision_workflows_from_directory(SINGLE_TENANT_UUID)
+        logger.info("Workflows provisioned successfully")
+        provision_dashboards(SINGLE_TENANT_UUID)
+        logger.info("Dashboards provisioned successfully")
+
     # Load this early and use preloading
     # https://www.joelsleppy.com/blog/gunicorn-application-preloading/
     # @tb: 👏 @Matvey-Kuk
diff --git a/keep/api/models/db/migrations/versions/2024-12-01-16-40_3ad5308e7200.py b/keep/api/models/db/migrations/versions/2024-12-01-16-40_3ad5308e7200.py
index e6c2140e3..f47399b6e 100644
--- a/keep/api/models/db/migrations/versions/2024-12-01-16-40_3ad5308e7200.py
+++ b/keep/api/models/db/migrations/versions/2024-12-01-16-40_3ad5308e7200.py
@@ -58,7 +58,10 @@ def downgrade() -> None:
             existing_nullable=True,
         )
         batch_op.alter_column(
-            "settings", existing_type=sa.JSON(), type_=sa.VARCHAR(length=255), nullable=False
+            "settings",
+            existing_type=sa.JSON(),
+            type_=sa.VARCHAR(length=255),
+            nullable=False,
         )
 
     # ### end Alembic commands ###

From 96e0cf3959666355ad163cf2680a83c4c23390b5 Mon Sep 17 00:00:00 2001
From: Tal Borenstein <tal@keephq.dev>
Date: Wed, 4 Dec 2024 13:50:15 +0200
Subject: [PATCH 4/6] fix: try fix tests

---
 tests/fixtures/client.py | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/tests/fixtures/client.py b/tests/fixtures/client.py
index e71a3a2c1..a2d76ca69 100644
--- a/tests/fixtures/client.py
+++ b/tests/fixtures/client.py
@@ -38,9 +38,14 @@ def test_app(monkeypatch, request):
     if "keep.api.api" in sys.modules:
         importlib.reload(sys.modules["keep.api.api"])
 
+    if "keep.api.config" in sys.modules:
+        importlib.reload(sys.modules["keep.api.config"])
+
     # Import and return the app instance
     from keep.api.api import get_app
+    from keep.api.config import on_starting
 
+    on_starting()
     app = get_app()
 
     # Manually trigger the startup event

From 37c7984c925d23a236e8661eb77957a8f4d4a17c Mon Sep 17 00:00:00 2001
From: Tal Borenstein <tal@keephq.dev>
Date: Wed, 4 Dec 2024 14:29:37 +0200
Subject: [PATCH 5/6] fix: tests

---
 keep/api/config.py       | 17 +++++++++++------
 tests/fixtures/client.py |  4 ++--
 2 files changed, 13 insertions(+), 8 deletions(-)

diff --git a/keep/api/config.py b/keep/api/config.py
index dfea1b0b1..38f19b696 100644
--- a/keep/api/config.py
+++ b/keep/api/config.py
@@ -18,12 +18,7 @@
 logger = logging.getLogger(__name__)
 
 
-def on_starting(server=None):
-    """This function is called by the gunicorn server when it starts"""
-    logger.info("Keep server starting")
-
-    migrate_db()
-
+def provision_resources():
     if PROVISION_RESOURCES:
         # provision providers from env. relevant only on single tenant.
         logger.info("Provisioning providers and workflows")
@@ -33,6 +28,16 @@ def on_starting(server=None):
         logger.info("Workflows provisioned successfully")
         provision_dashboards(SINGLE_TENANT_UUID)
         logger.info("Dashboards provisioned successfully")
+    else:
+        logger.info("Provisioning resources is disabled")
+
+
+def on_starting(server=None):
+    """This function is called by the gunicorn server when it starts"""
+    logger.info("Keep server starting")
+
+    migrate_db()
+    provision_resources()
 
     # Load this early and use preloading
     # https://www.joelsleppy.com/blog/gunicorn-application-preloading/
diff --git a/tests/fixtures/client.py b/tests/fixtures/client.py
index a2d76ca69..b1787a292 100644
--- a/tests/fixtures/client.py
+++ b/tests/fixtures/client.py
@@ -43,9 +43,9 @@ def test_app(monkeypatch, request):
 
     # Import and return the app instance
     from keep.api.api import get_app
-    from keep.api.config import on_starting
+    from keep.api.config import provision_resources
 
-    on_starting()
+    provision_resources()
     app = get_app()
 
     # Manually trigger the startup event

From 2fd84f487d25dc976587270fcda634f5560a7083 Mon Sep 17 00:00:00 2001
From: Tal Borenstein <tal@keephq.dev>
Date: Wed, 4 Dec 2024 18:05:10 +0200
Subject: [PATCH 6/6] fix: tests

---
 tests/test_provisioning.py | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/tests/test_provisioning.py b/tests/test_provisioning.py
index 6603f6bf8..679c9b75d 100644
--- a/tests/test_provisioning.py
+++ b/tests/test_provisioning.py
@@ -141,6 +141,11 @@ def test_reprovision_workflow(monkeypatch, db_session, client, test_app):
     for event_handler in app.router.on_startup:
         asyncio.run(event_handler())
 
+    # manually trigger the provision resources
+    from keep.api.config import provision_resources
+
+    provision_resources()
+
     client = TestClient(get_app())
 
     response = client.get("/workflows", headers={"x-api-key": "someapikey"})
@@ -210,6 +215,11 @@ def test_reprovision_provider(monkeypatch, db_session, client, test_app):
     for event_handler in app.router.on_startup:
         asyncio.run(event_handler())
 
+    # manually trigger the provision resources
+    from keep.api.config import provision_resources
+
+    provision_resources()
+
     client = TestClient(app)
 
     # Step 3: Verify if the new provider is provisioned after reloading
@@ -293,6 +303,11 @@ def test_reprovision_dashboard(monkeypatch, db_session, client, test_app):
     for event_handler in app.router.on_startup:
         asyncio.run(event_handler())
 
+    # manually trigger the provision resources
+    from keep.api.config import provision_resources
+
+    provision_resources()
+
     client = TestClient(app)
 
     # Step 3: Verify if the new dashboard is provisioned after reloading