2.2.0 Debug Webhooks

Check on the piplanning server side

1 Check it the PI-Server is seeing any POST requests from JIRA at all

docker ps   # Get ID of the nginx docker container
docker logs -f <container-ID>

Now check if you see a POST request in the nginx container log. Requests from Jira normally have the following structure:

XXX.XXX.XXX.XXX - - [06/May/2020:07:18:46 +0000] "POST /jira-endpoint/XXXXXX?user_id=XXX&user_key=XXX HTTP/1.1" 200 0 "-" "Atlassian Webhook HTTP Client" "-"

Check if the network allows POST requests form the JIRA server to the piplanning server

2 Check if you can issue e curl POST request from the Jira to the PI-Planningserver server

curl -d "test=1" -X POST http://pi-hostnameORip/jira-endpoint

Check the logs of the nginx container if you see a POST request.

3 Cloud: Check if certificate is valid. Do you have specified the full-chain certificate or only the certificate?

Check on the JIRA side

1 Check if webhook is triggered in Jira



  1. In Jira: go to Admin --> System --> Logging and Profiling
  2. Click: Configure logging level for another package
  3. Add com.atlassian.webhooks.plugin.PublishTaskFactoryImpl and set it to debug

This will only log an entry when the webhook has been triggered, so if you don't see any entries, the webhook is not triggering.

You should see some entry like:

<Possible warning / errors from Jira will appear here>

The location of the log depends on your configuration. By default you will find it (Linux) /opt/atlassian/jira/logs/catalina.log

4 Check if webhook add-on (and all modules) is activated in JIRA

  1. Admin->Add-ons->Manage add-ons
  2. Search for Webhook in System
  3. Check if all modules in the listed plugins are enabled 

5 Send us your JIRA logs (maybe we are able to see some misconfiguration in there)

  1. Admin->System→Troubleshooting and support tools→Create support.zip