Forms observability | Default Knowledge Base

The Observability feature helps identify and resolve form submission issues proactively. It provides real-time monitoring and alerts to ensure smooth form operations.

Alerts customers immediately when submission errors occur.
Acts as a proactive monitoring system, allowing customers to learn about issues directly from us.
Helps track and explain missing form submissions.

Form Observability provides a comprehensive monitoring and real-time alerts to ensure reliable form processing and uptime. This proactive monitoring system helps maintain consistent lead capture and identifies potential issues before they impact your business.

Configuration

Step 1: Enable Notifications in Settings

Go to Settings > Notifications (or click here)

Ensure Slack is integrated
Verify your Slack user is mapped under Settings > Users > User Mapping (column)

Step 2: Enable Form Error Notifications

Toggle the Enable error notifications slider on.

FAQs

Q: Where do errors come from? Are errors surfaced from client-side or server side?

A: Both types of errors are tracked.

Client-side errors are marked with the prefix [Webform script error] to distinguish them from backend errors.

Q: What happens if Default fails to load on page? Will client-side errors be captured if the script fails to load?

A: No, since the error reporting code is contained within the script itself.

Your developers can add a onerror() handler for the script as below:

  <script>
    (function (w, d) {
      w.__default__ = { team_id: xxx, form_id: xxxxxx };
      var s = d.createElement("script");
      s.async = true;
      s.src = 'https://import-cdn.default.com/v2/index.js';
      s.onerror = function () {
        // log error to analytics or error tracker
      }
      d.head.appendChild(s);
    })(window, document);
  </script>

Q: Can errors be sent from through Default, via the onError() handler?

A: Yes, you can forward any errors to Default to receive notifications for them:

<script>
    (function (w, d) {
      w.__default__ = { team_id: xxx, form_id: xxxxx };

      var s = d.createElement("script");
      s.async = true;
      s.src = 'https://import-cdn.default.com/v2/index.js';
      s.onerror = function () {
				fetch("https://nucleus.default.com", {
				  method: "POST",
				  headers: {
				    "Content-Type": "application/json",
				  },
				  body: JSON.stringify({
				    form_id: "xxx",
				    errorMessage: "script failed to load",
				  }),
				});
      }
      d.head.appendChild(s);
    })(window, document);
</script>

Q: Does this work for all Default form systems?

A: Yes, form observability is available for all form systems - including 3rd party (non-Default form) forms

Q: How does Default alert me? Where can I find these notifications?

For Slack: Located in your Default Slack app DMs. You can find it from:

Slack App > Scroll down to Slack App (usually at the bottom) > Default

For Others:

In app notifications > notification sidebar in app
Email > email

Note: Only users in Default with the admin role are eligible to receive these notifications.