feat: Add Grafana integration by mfuzailzubari · Pull Request #3040 · superplanehq/superplane

mfuzailzubari · 2026-02-11T14:04:56Z

Implements #1945

This PR implements the Grafana integration with:

Query Data Source action (Grafana Query API via POST /api/ds/query)

Authorization:

Grafana API key/service account token for API calls
Optional Shared Secret for the alert webhook via Authorization: Bearer

Implementation notes:

Query Data Source now sends datasource as { uid: "" } to match Grafana’s Query API.
Grafana alert trigger now creates a unique webhook per trigger node (not a shared integration webhook).
Added unit tests for Query Data Source and On Alert Firing auth handling.

Demo video: https://drive.google.com/file/d/117GAjLWyp2pic79nzOqDvvDm64-qA094/view?usp=sharing

pkg/integrations/grafana/on_alert_firing.go

pkg/integrations/grafana/client.go

AleksandarCole · 2026-02-12T06:37:25Z

@mfuzailzubari thank you for submitting this one!
Can you please resolve the branch conflicts. I will move on to the functional testing in the meantime, one thing I can see from the video is that integration and components do not use Grafana icon, please address that one when you get the chance and I will share more details after functional review.

pkg/core/trigger.go

pkg/integrations/grafana/example_data_on_alert_firing.json

mfuzailzubari · 2026-02-13T06:05:59Z

@mfuzailzubari thank you for submitting this one! Can you please resolve the branch conflicts. I will move on to the functional testing in the meantime, one thing I can see from the video is that integration and components do not use Grafana icon, please address that one when you get the chance and I will share more details after functional review.

Conflits are resolved, moving on to other findings.

pkg/integrations/grafana/example_data_on_alert_firing.json

…zubari/superplane into feat/grafana-integration

pkg/core/trigger.go

…rplanehq#1945)

pkg/integrations/grafana/client.go

…ilures (superplanehq#1945)

pkg/integrations/grafana/example_output_query_data_source.json

…ope (superplanehq#1945)

mfuzailzubari · 2026-02-13T16:16:59Z

Fixed all the issues raised in the thread.

AleksandarCole · 2026-02-16T11:11:24Z

@mfuzailzubari I have not managed to set this up fully - I tested the query component and it worked, but the trigger one is not good. We need to avoid user having to configure these webhooks manually if there are API endpoints through which we can do this.

mfuzailzubari · 2026-02-17T10:23:31Z

@mfuzailzubari I have not managed to set this up fully - I tested the query component and it worked, but the trigger one is not good. We need to avoid user having to configure these webhooks manually if there are API endpoints through which we can do this.

fixed it. please check.

AleksandarCole · 2026-02-17T12:09:48Z

@mfuzailzubari managed to get it to work.
Before I request any UI, assigning to engineering to evaluate the approach and do a code review.
@forestileao can you take this one?

web_src/src/ui/componentSidebar/index.tsx

web_src/src/pages/workflowv2/mappers/grafana/on_alert_firing.tsx

forestileao · 2026-02-17T13:59:33Z

Also, the CI tests should pass

…renderer (superplanehq#1945)

…anehq#1945)

pkg/integrations/grafana/grafana.go

…ls consistency (superplanehq#1945)

pkg/integrations/grafana/on_alert_firing.go

…shared secret input (superplanehq#1945)

pkg/integrations/grafana/on_alert_firing.go

pkg/server/server.go

…on merge, and fix mapper tsx build (superplanehq#1945)

pkg/integrations/grafana/webhook_handler.go

pkg/integrations/grafana/client.go

…ent docs (superplanehq#1945)

… UI-editable (superplanehq#1945)

cursor

Cursor Bugbot has reviewed your changes and found 2 potential issues.

^{Bugbot Autofix is OFF. To automatically fix reported issues with Cloud Agents, enable Autofix in the Cursor dashboard.}

web_src/src/pages/workflowv2/mappers/grafana/on_alert_firing.tsx

…uperplanehq#1945)

mfuzailzubari · 2026-02-18T12:38:15Z

Also, the CI tests should pass

all passed.

forestileao · 2026-02-18T19:51:01Z

@mfuzailzubari
We still need to resolve this:

Ensure you have a local copy of your branch by checking out the pull request locally via command line.
In your local branch, run: git rebase HEAD~28 --signoff
Force push your changes to overwrite the branch: git push --force-with-lease origin feat/grafana-integration

Meanwhile I am testing your implementation

forestileao · 2026-02-18T22:29:13Z

pkg/integrations/grafana/query_data_source.go

+		{
+			Name:        "dataSourceUid",
+			Label:       "Data Source UID",
+			Type:        configuration.FieldTypeString,


we should use FieldTypeIntegrationResource. And we should be able to get the avaiable resources. Check dash0 or Discord integration

forestileao · 2026-02-18T22:31:36Z

web_src/src/pages/workflowv2/mappers/grafana/on_alert_firing.tsx

+    return (
+      <div className="border-t-1 border-gray-200 pt-4">
+        <div className="space-y-3">
+          <div>
+            <span className="text-sm font-medium text-gray-700 dark:text-gray-300">Grafana Contact Point Setup</span>
+            <div className="text-xs text-gray-800 dark:text-gray-100 mt-2 border-1 border-gray-300 dark:border-gray-600 px-2.5 py-2 bg-gray-50 dark:bg-gray-800 rounded-md">
+              <ol className="list-decimal ml-4 space-y-1">
+                <li>Save the canvas to generate the webhook URL.</li>
+                <li>SuperPlane will try to auto-provision a Grafana webhook contact point.</li>
+                <li>If auto-provisioning fails, create/update the contact point manually using the URL below.</li>
+              </ol>
+              <div className="mt-3">
+                <span className="text-xs font-medium text-gray-700 dark:text-gray-200">Webhook URL</span>
+                <pre className="mt-1 text-xs text-gray-800 dark:text-gray-100 border-1 border-gray-300 dark:border-gray-600 px-2.5 py-2 bg-white dark:bg-gray-900 rounded-md font-mono whitespace-pre-wrap break-all">
+                  {webhookUrl}
+                </pre>
+              </div>
+            </div>
+          </div>
+        </div>
+      </div>
+    );


I was not able to make it automatically create a contact point. Do you know why exactly?

It should be able to create automatically, since the Sync confirmed we are connected, if it is not provisioning, then there is an error in the webhook handler. So we can remove this fallback message too, no?

Ah, I undertood why I was not able to automatic provision

app-1 | 2026/02/18 22:09:27 [WebhookProvisioner] Webhook 0e3e8e5e-c025-4a4d-b89c-6a8f74b17c50 provisioning failed (attempt 1/3): grafana webhook setup: contact point provisioning will be retried: error listing contact points: error executing request: Get "http://host.docker.internal:3000/api/v1/provisioning/contact-points": dial tcp 192.168.65.254:3000: connection blocked: access to private IP address 192.168.65.254 is not allowed

@mfuzailzubari
Lets lets do this: lets enhance this message box, and also add a copy text button in this container, since I need to select it currently. Check webhook.tsx

forestileao · 2026-02-18T22:40:40Z

pkg/integrations/grafana/grafana.go

+To connect Grafana:
+1. Create a Service Account token or API key in Grafana (Configuration > API Keys or Service Accounts).
+2. Set the Base URL to your Grafana instance (e.g. https://grafana.example.com).
+3. Paste the API token into SuperPlane and save.
+
+For the alert trigger:
+1. SuperPlane will attempt to automatically create/update a Grafana Webhook contact point.
+2. Route your alert rule to the contact point created by SuperPlane.
+3. If auto-provisioning is not available (permissions/API limitations), create a Webhook contact point manually using the webhook URL from SuperPlane.
+`


I think this docs is currently incorrect, since grafana now has service accounts,
so the docs should be like:

Steps to Create Service Accounts and Tokens (UI)

Navigate: Go to Administration > Users and access > Service accounts.

Create Account: Click Add Service Account, enter a name, and assign a role (e.g., Viewer, Editor, Admin).

Generate Token: Click the new service account, select Add service account token, name it, and optionally set an expiration date.

Secure Token: Click Generate token and copy the token immediately; it will not be displayed again.

mfuzailzubari added 4 commits February 7, 2026 00:38

grafana integration base code

c0685f5

fix for grafana visibility in integrations list.

bc38d48

fixes for the trigger webhook url + for datashource uid

030e33b

fix for shared secret + new webhook entry (superplanehq#1945)

3f38d38

AleksandarCole added pr:stage-1/3 Needs to pass basic review. wfh labels Feb 11, 2026

cursor bot reviewed Feb 11, 2026

View reviewed changes

pkg/integrations/grafana/on_alert_firing.go Outdated Show resolved Hide resolved

pkg/integrations/grafana/client.go Show resolved Hide resolved

AleksandarCole added pr:stage-2/3 Needs to pass functional review and removed pr:stage-1/3 Needs to pass basic review. labels Feb 12, 2026

forestileao reviewed Feb 12, 2026

View reviewed changes

pkg/core/trigger.go Outdated Show resolved Hide resolved

forestileao reviewed Feb 12, 2026

View reviewed changes

pkg/integrations/grafana/example_data_on_alert_firing.json Show resolved Hide resolved

Merge branch 'main' into feat/grafana-integration

ff634be

cursor bot reviewed Feb 13, 2026

View reviewed changes

pkg/integrations/grafana/example_data_on_alert_firing.json Show resolved Hide resolved

mfuzailzubari added 2 commits February 13, 2026 11:09

fix for Non-constant-time comparison for bearer token authentication

e424921

Merge branch 'feat/grafana-integration' of https://github.com/mfuzail…

7321e1a

…zubari/superplane into feat/grafana-integration

cursor bot reviewed Feb 13, 2026

View reviewed changes

pkg/core/trigger.go Outdated Show resolved Hide resolved

mfuzailzubari added 3 commits February 13, 2026 11:19

GetURl unused method removed (superplanehq#1945)

623a9fa

jfix(grafana): wrap On Alert Firing example payload (superplanehq#1945)

f4bffe0

fix(grafana): restore integration icons and unblock dev startup (supe…

214db53

…rplanehq#1945)

cursor bot reviewed Feb 13, 2026

View reviewed changes

pkg/integrations/grafana/client.go Show resolved Hide resolved

fix(grafana): allow responses up to max size

c537535

cursor bot reviewed Feb 13, 2026

View reviewed changes

pkg/integrations/grafana/client.go Show resolved Hide resolved

fix(grafana): enforce absolute baseURL and prevent runtime request fa…

11d75be

…ilures (superplanehq#1945)

cursor bot reviewed Feb 13, 2026

View reviewed changes

pkg/integrations/grafana/example_output_query_data_source.json Show resolved Hide resolved

fix(grafana): align Query Data Source example output with event envel…

b42c9e5

…ope (superplanehq#1945)

Merge branch 'main' into feat/grafana-integration

e757f7b

AleksandarCole assigned forestileao Feb 17, 2026

AleksandarCole added pr:stage-3/3 Ready for full, in-depth, review and removed pr:stage-2/3 Needs to pass functional review labels Feb 17, 2026

forestileao reviewed Feb 17, 2026

View reviewed changes

web_src/src/ui/componentSidebar/index.tsx Outdated Show resolved Hide resolved

forestileao reviewed Feb 17, 2026

View reviewed changes

web_src/src/pages/workflowv2/mappers/grafana/on_alert_firing.tsx Show resolved Hide resolved

mfuzailzubari added 2 commits February 18, 2026 11:22

fix(grafana): move webhook URL display to onAlertFiring custom field …

96896b9

…renderer (superplanehq#1945)

fix(grafana): include Triggered At in onAlertFiring details (superpl…

e5a91a6

…anehq#1945)