Jira integration events and troubleshooting
- Public preview
Open Events to see what the integration has done recently.
The Events view stores the most recent 100 event records per installation. It is for troubleshooting, not long-term audit history.
Event meanings
The Events view shows normal progress, safely ignored events, and events that need attention. Green events either completed successfully or were safely ignored. Red events need attention.
Each record shows the Jira issue and XBOW finding it relates to, its own event ID, the number of attempts, a short reason in “Details”, and a recommended next step in “Action”. Records that need attention carry a “Needs attention” label, alongside a second label for the event type, such as “Finding update”.
Normal events
| Event | Meaning |
|---|---|
| Received | The app accepted the event. |
| Queued | The app queued background work. |
| Jira work item created | The app created and linked a Jira work item. |
| Jira status received | Jira reported a linked status change. |
| XBOW updated | The app wrote Jira metadata back to XBOW. |
| Duplicate ignored | The app already handled this event. |
| App-generated update ignored | The app ignored its own update to avoid a loop. |
| Writeback disabled | The install is in unidirectional mode. |
Events that need attention
| Event | Meaning | Action |
|---|---|---|
| Mapping failed | Setup is incomplete, the mapping still has unresolved required Jira fields, or Jira changed field metadata after you saved the mapping. | Open Mapping, click Check Fields, and save again after all required fields are covered. If it still fails, open Events, click Show Debug Info, and send it to support@xbow.com. |
| Jira action failed | Jira rejected the create, comment, property, or metadata action. | Check app permissions, project access, issue type, and required fields. |
| XBOW update failed | Jira work exists, but XBOW writeback failed. | Check token, region, organization ID, and bidirectional mode. |
Retry
Retry appears only when the app has enough context to try safely.
For finding events, retry fetches the current XBOW finding and reuses an existing Jira issue key when one is known.
For Jira status events, retry writes the workflow state back to XBOW. It does not create a Jira work item.
Authentication and mapping failures usually need a setup change before retry.
Troubleshooting integration problems
These are symptoms you may notice while setting up or running the integration.
| Problem | Check |
|---|---|
| No webhook signal | Open Configuration and click Connect Webhook. If it still fails, open Events and send debug information to support@xbow.com. |
| Webhook rejected | Open Configuration and click Connect Webhook to refresh signing keys and request a new signed ping. |
| Jira work item not created | Open Mapping, click Check Fields, resolve required fields, and confirm app permissions. |
| Jira comments fail | Check whether the finding content is too large or uses unsupported formatting. |
| XBOW writeback fails | Check token, region, organization ID, and integration mode. |
| Jira status does not update XBOW | Confirm bidirectional mode and status mapping. |
| The Events view looks stale | Click Reload. The app may have removed older event records. |
Contact support for the Jira app
XBOW supports the app directly, rather than through Atlassian. To reach the team:
- Email support@xbow.com for problems with the integration itself, including anything you see in Events.
- Submit a support request if you would rather not use email.
- Check the Support tab of the Marketplace listing for current support hours and the XBOW support phone number.
What to send XBOW Support
When you contact support, open Events, click Show Debug Info, then click Copy in the “Support debug info” panel and send the copied information.
The debug panel excludes sensitive data. See Security and data handling for the excluded data list.
If XBOW Support asks for more information, send the Jira issue key and XBOW finding ID shown in the event record.
Do not paste API tokens, passwords, raw webhook payloads, exploit evidence, or sensitive finding data into support tickets unless XBOW Support gives you a secure upload path.