Email This Issue
📈 Marketplace❓ Support❤️ Feedback🏠 META-INF Apps
Email This Issue - for Jira Cloud
Email This Issue - for Jira Cloud
  • ⬇️Overview
  • Email This Issue - for Jira Cloud
  • Features
  • How Email This Issue Works
  • Secure the email channel with Email This Issue
  • Comparing Email This Issue and Jira Cloud
  • 📤Outgoing Emails
    • Outgoing emails overview
    • Manual emails
      • Configuring manual emails
      • Sending manual emails
    • Email notification schemes and email notifications
    • Workflow post functions
    • Advanced email configuration
    • Customizing email templates
    • Canned Responses (default messages)
    • Scope evaluation
  • 📥Incoming Emails (Mail Handlers)
    • Incoming emails overview
  • Mail handlers - adding / editing
    • General handler settings
    • Filtering
    • Finding issues
    • Setting up rules and actions in the actions editor
      • Adding/editing actions
      • Adding recipients to Request Participants
      • Creating an issue
      • Updating an issue
      • Setting field values
      • Adding comments
      • Sending auto-reply emails
      • Executing workflow transitions
      • Creating a customer
      • Using split regexp
      • Conditions
      • Approve request
      • Decline request
    • Maintaining email chains
    • Mail Handler New UI
  • Global Sender Address Filters
  • Attachment Filters
    • Regular Attachment Handling Deprecation
  • 🤓Administration
    • Outgoing Mail Connections
    • Alerting via Webhooks
      • Webhooks
        • Configuring Slack to receive alerts via webhooks
        • Configuring OpsGenie to Receive alerts via webhooks
        • Configuring Microsoft Teams to receive alerts via webhooks
      • Webhook execution logs
    • Mail Queue
    • Email Audit Log
    • Permissions
    • Recipient Restrictions
    • Incoming Mail Connections
    • Email Security
    • Incoming Mail Queue
    • Incoming Mail Log
    • OAuth2 Credentials
      • Enabling OAuth2 Authorization in your Google Account
      • Enabling OAuth2 Authorization in your Microsoft 365 Account
      • Troubleshooting guides for Microsoft OAuth2 Connections
        • How to fix "BAD User is authenticated but not connected" error​
        • How to fix "401 Unauthorized" error
        • How to fix "key expires_in " error
        • How to fix "Need admin approval" error
  • ☁️Server to Cloud Migration
    • 🛫Server to Cloud - Automatic Migration tool
      • Preparing for the migration
      • Doing the migration
      • Finalizing the migration in Cloud
      • Migration with unsupported Jira versions causes errors
    • Server to Cloud - Manual migration guide for Email This Issue
  • ❓FAQ
    • No recipients error in outgoing emails
    • How-to add custom macro to email Template?
    • Why cannot I select custom event types in notification?
    • How to configure the Email This Issue addon user in Jira Cloud?
    • I get an error: Could not create request on behalf of the sender
    • Why is the Incoming Mail Queue size limited?
    • Outgoing mail not sent - Read timeout error
    • Access restriction icon is not appearing when adding internal attachments via Email this Issue
  • 🌪️General
    • Release Notes
    • API
      • API for Velocity Context Objects - 1.7
      • API for Velocity Context Objects
    • Addon Pages
      • Integrity Check
      • Feedback and Support
    • Security Advisories
      • Email This Issue Security Advisory September 28, 2020
    • Appendix
      • Supported Time Zones
    • Integration of Glass Documentation
Powered by GitBook
On this page

Was this helpful?

  1. Administration
  2. Alerting via Webhooks

Webhook execution logs

PreviousConfiguring Microsoft Teams to receive alerts via webhooksNextMail Queue

Last updated 3 years ago

Was this helpful?

Webhook execution logs make Email This Issue for Jira administrators able to monitor which webhooks have been called upon which incidents, and whether the associated HTTPs requests have been dispatched successfully.

To see Webhook execution logs, go to the Administration tab, and choose Webhook Execution Logs under WEBHOOKS.

If webhooks are called successfully the admins or all other addressed parties are informed about the source incidents through the preferred channel for which the webhook was configured.

If the webhook itself does not work properly, the incidents won't reach the receiving system, and won't be reported there either. To learn about such an issue, check the logs of webhook executions. Issues with webhook call dispatching cannot be reported in the style of push notifications, they must be actively checked (polled) periodically.

On the listing page of webhook execution logs items are ordered by their time of execution, in a descending order starting with the latest items. There are 100 items per page. Assuming that only the most recent logs may refer to relevant, current issues, execution logs can neither be filtered, nor deleted. They are automatically purged after 90 days.

Each log entry contains the most essential details about the incident that triggered the webhook call, and some additional information about the execution. especially in the event of failure in order to make troubleshooting possible. As some fields may contain lengthy text (for example, error messages extended with stacktrace), these parts are displayed as collapsed by default, but they can be expanded individually if needed.

Note: When webhooks are called, all placeholders (velocity variables) are replaced by their current value. The substituted parameters applied in the request are shown in the execution log. Validate if templates are correct by sending a test notification and checking the log.

The following attributes are revealed in a log entry:

Attribute

Description

Separate column in the log

Name

The entity that represents the execution of this webhook.

Yes

Event

The incident type (triggering event) for which the webhook was configured.

Yes

Entity name

The name of the entity (Incoming Connection, Outgoing Connection or Mail Handler) for which the incident occurred.

Yes

Error Message

The message value that was rendered in the request body. In most cases, this is the same message that can be found in the Error Queue of the failing component.

Yes

Time of Execution

The timestamp indicating when this execution entity was created (with Queued status).

Note: Webhooks are executed in an asynchronous manner, typically within a few moments after their creation. If it takes more time, the webhook execution remains in a Queued status until the actual dispatch.

Yes

Status

Has one of the following values:

  • Queued: Created, but not yet executed.

  • Successful: Executed successfully.

  • Failed: Executed, but failed.

Yes

Service URL called

The final URL that was actually called.

No

Webhook response

The HTTPs status code and message received from the remote endpoint (i.e. the response of the receiving service).

No

Request Headers Executed

The final generated Request Header that was sent with the request.

Note: Due to the peculiarities of the library used for dispatching the HTTPs request, the Content-Type header is not listed here, but it is always included included in the real request headers with the value of application/json.

No

Failure Reason

In the event of a failure (Failed status) this attribute shows the root cause, potentially an error message, and stacktrace.

Note: If the webhook execution resulted in a Success status (or is still Queued) this field is hidden.

No

🤓