We're excited to announce upcoming changes to how GitLab handles webhooks, aimed at improving reliability and reducing manual intervention. These changes will affect GitLab.com users in the coming weeks. For GitLab Self-managed users, the current auto-disabling webhook behavior is behind an existing ops flag auto_disabling_webhooks. The changes described here will be introduced behind the same feature flag.

This improvement is the result of a valuable community contribution by Phawin Khongkhasawan, exemplifying the power of our open source community in driving GitLab forward.

What's changing?

• All webhooks will self-heal: Currently, webhooks that result in 4xx errors become permanently disabled after multiple failures. With this update, all webhooks, regardless of the error type (4xx or 5xx), will have the ability to self-heal.
• Temporary disabling instead of permanent disabling: Instead of being permanently disabled, failing webhooks will be temporarily disabled with an increasing backoff period, up to a maximum of 1 day.
• Consistent treatment of errors: All types of errors (4xx, 5xx, network errors, etc.) will be treated the same way, allowing for more predictable behavior and easier troubleshooting.

Why this change matters

Reduced manual intervention: You'll no longer need to manually re-enable webhooks that have been disabled due to temporary issues.

• Improved reliability: Webhooks will automatically attempt to recover from transient errors, ensuring your integrations remain functional.
• Better handling of temporary issues: This change accounts for scenarios like temporary outages, deployments, or configuration changes that might cause temporary webhook failures.

What you need to do

1. Review your webhooks: Take this opportunity to review your existing webhooks. If you have any that you no longer need, consider deleting them.
2. Prepare for reactivation: If you have webhooks that are currently permanently disabled, be aware that they will be migrated to a temporarily disabled state and may become active again.
3. Ensure your systems are prepared to handle webhook events from previously disabled webhooks.
4. Update your monitoring: If you rely on webhook status for monitoring, update your processes to account for the new behavior where webhooks may self-heal.
5. Test your integrations: Once the change is rolled out, test your integrations to ensure they behave as expected with the new webhook handling.

Timeline and rollout

This feature will be gradually rolled out over a period of about two weeks to ensure a smooth transition.

• For GitLab.com users, the changes will be applied automatically.
• For self-managed and Dedicated users, the changes will only affect instances that have the auto_disabling_webhooks ops flag enabled, from Version 17.7.

Feedback and support

We value your feedback! If you encounter any issues or have suggestions regarding this change, please comment on our webhook feedback issue.

For any questions or concerns, please reach out to GitLab Support or consult our webhooks documentation.

Stay tuned for more updates, and thank you for being a part of the GitLab community!