Skip to main content

Jira

Causely can send root cause alerts directly to Jira channels, helping engineering and IT teams stay informed and aligned during incidents. Alerts include high-context diagnostics, like impacted services, severity, and a clear summary, so you can take action quickly without switching tools.

Configuration

To integrate Jira with Causely, you must install the Causelybot and configure it as your Jira webhook endpoint. The bot listens for alerts from the Causely platform and posts them to your desired Jira channels.

  1. Follow the installation instructions for the Causelybot in the official GitHub repository: Causelybot

  2. Once deployed, update your causely-values.yaml file to include the executor and the bot's URL endpoint.

For example, if you deploy the Causelybot in the foo namespace of your cluster, you can configure the webhook endpoint in your causely-values.yaml file like this:

executor:
enabled: true

notifications:
webhook:
url: "http://<CAUSELYBOT_FQDN/IP>:5000/webhook"
token: "<YOUR_CAUSELYBOT_TOKEN>"
enabled: true
note

Make sure the Causelybot is accessible from your Causely deployment and properly configured to post to your Jira workspace and channel. Ensure the Jira channel webhook is set up to accept incoming messages and that the Causelybot has access permissions.

To install the Causely agent with the Jira integration enabled, run:

causely agent install --cluster-name <cluster-name> --values ./causely-values.yaml

Notification Payload Format

Causely sends structured alert payloads to Jira, including root cause summaries and service impact context.
For an example payload and explanation of each field, refer to the Notification Payload Format page.