diff --git a/docs/configuration/exporting/send-events-api.rst b/docs/configuration/exporting/send-events-api.rst index d605cf8d4..06ea255dc 100644 --- a/docs/configuration/exporting/send-events-api.rst +++ b/docs/configuration/exporting/send-events-api.rst @@ -16,6 +16,7 @@ This is the recommended ingestion path for new integrations. The legacy :doc:`Se send-events/dynatrace send-events/gcp-monitoring send-events/grafana + send-events/jsm send-events/nagios send-events/newrelic send-events/opsgenie @@ -177,6 +178,11 @@ Incident Management :link: send-events/opsgenie :link-type: doc + .. grid-item-card:: :octicon:`pulse;1em;` Jira Service Management + :class-card: sd-bg-light sd-bg-text-light + :link: send-events/jsm + :link-type: doc + .. grid-item-card:: :octicon:`pulse;1em;` Rootly :class-card: sd-bg-light sd-bg-text-light :link: send-events/rootly diff --git a/docs/configuration/exporting/send-events/jsm.rst b/docs/configuration/exporting/send-events/jsm.rst new file mode 100644 index 000000000..288153380 --- /dev/null +++ b/docs/configuration/exporting/send-events/jsm.rst @@ -0,0 +1,38 @@ +Jira Service Management +======================== + +Forward Jira Service Management (JSM) alerts to Robusta via the JSM outgoing webhook integration. + +Prerequisites +------------- + +* A Robusta account with API access. +* Your Robusta ``account_id``, found in ``generated_values.yaml``. +* A Robusta API key with ``Read/Write`` access to alerts, generated under **Settings → API Keys → New API Key**. +* Admin access to Operations in Jira Service Management. + +Webhook URL +----------- + +.. robusta-code:: + + https://api.robusta.dev/webhooks?type=alert&origin=jsm&account_id= + +Configure Jira Service Management +--------------------------------- + +1. In Jira Service Management, go to **Operations → Integrations → Add integration**. +2. Search for **Webhook** and select the outgoing webhook integration. +3. Set the **Webhook URL** to the URL above. +4. Add a custom **Header**: + + .. code-block:: + + Authorization: Bearer + +5. Choose which alert actions (``Create``, ``Acknowledge``, ``Close``, …) trigger the webhook and turn the integration on. + +Verify +------ + +Create a test alert in Jira Service Management. The event should appear in **Settings → Delivery Log** and on the Robusta timeline.