Alert Logs

These are the logs that get generated for every request that is received for the alert. Alert Logs offer the following functionalities:

  • Availability: Logs become available as soon as the system processes a request.
  • Sorting: They are sorted by the time the request was received.
  • Real-time updates: You can update the logs in real-time by clicking the Refresh button in the top-right corner of the section.

The image below shows the alert logs for an alert.

logsss.png

Search Your Alert Logs

Alert Logs are a means to analyze the Alert performance based on request status, channel level filters, and unique identifiers such as the request ID, transaction ID, and recipient ID. You can search the logs using the following criteria:

Search by Request ID or Transaction ID

The request ID is a unique identifier given to a request received by MoEngage. The transaction ID is a unique identifier that identifies the transaction for which the Alert is being sent to the user. The transaction ID is generated and maintained by you and passed to MoEngage along with the request.
The search by request ID or transaction ID option helps you search the logs for a specific request or transaction in the Alert logs and see its status on the Dashboard.

Duplicate Requests

You can search for Duplicate requests by searching using the transaction ID. A request is considered a duplicate if it contains the same transaction ID as that of a previously successful or in-progress request within a 5-minute interval.
Note: The request ID and transaction ID need to be exact matches for a request to be called a duplicate; partial matches wouldn’t work.

Search by Channel

This option helps you filter the requests based on the selected channels (SMS and(or) email) and analyze the requests using the request or delivery status.

Search by Request Status

This option helps you filter the requests based on their status. The available filter options for status are:

Request Status Description
Request Failed

This option shows all the requests that have failed for the Alert due to any of the following:

    • Incorrect alert ID
    • Incorrect payload information
    • Invalid transaction ID
    • Mandatory fields are missing in the payload
    • Rate limit has exceeded the set RPM
    • Alert ID of an inactive (paused or dropped) Alert
Request Dropped

This option shows all the requests that were dropped for the Alert. Requests are dropped when the Alert is paused, when a transaction is in progress, when a duplicate request is received, or if the MoEngage Inform processing time is greater than one hour.

Request Processing

This option shows all the requests that are being processed currently for the Alert. Any request that is being attempted to be sent to the vendor would be a request that is currently in progress.

Delivery Successful

This option shows all the requests that have been delivered successfully.

Delivery Pending

This option shows all the requests that have not been delivered yet. These would be messages that have been processed by MoEngage and sent to the vendor for further processing.

Delivery Failed

This option shows all the requests that have not been delivered yet. These would be messages that have been processed by MoEngage and sent to the vendor for further processing.

Delivery Info NA

This option shows all the requests that do not have delivery information available.

Search Within a Specified Date Range

This option helps you filter requests within the specified dates.

Search with Recipient ID

This option helps you filter requests based on the recipient ID(Push Token for push notifications, Email ID for emails, and Mobile number for SMS).

Search with Time to Send

This option helps you filter the requests based on the time taken for MoEngage to send the message. You can specify the minimum and maximum delivery time in seconds in this filter.

Request Details

Every row in the logs section contains information about a request received for the Alert. The following information is available for every request in the logs:

Request Details Description
Received Time When MoEngage received the request via your API call.
Request ID The MoEngage-generated unique identifier for this API call. For every API call received, MoEngage provides the Request ID as a unique identifier.
Channel

The channel for which the request was processed. For example, SMS or Email. The sender icon beside the channel indicates which sender was automatically chosen to send the alert, as determined by the dynamic sender routing logic.

Status

States the status of the request. For more information about the possible statuses for a request, refer to Request Status.

Failure Reason States the reason for failure in case MoEngage is not able to process the request, or if there are any failures from the vendors.
Recipient ID The destination identifier for the channel where the message should be delivered. For example, Push Token for Push Notifications, Email ID for Emails, and Mobile number for SMS.
Transaction ID The identifier that needs to be passed by you for each transaction. The fallback icon Screenshot 2025-08-06 at 5.12.06 PM.png beside the Transaction ID indicates that an alert was attempted using a fallback channel after the primary channel failed to send or deliver it.
Delivery Time

This time is calculated as the sum of the request processing time, the time taken for your email or SMS provider to send the request to the user, and the time for the provider to report delivery information back to the system.

You can click on the row to get more information about the request, as shown below.

Screenshot 2025-08-13 at 12.28.00 PM.png


The following information is available for every request:

  • Delivery info: The Delivery Info section contains the details about when the request was received when the message was sent to the vendor for the specified channel and the delivery time. In the case where the Alert is configured to be sent across multiple channels in a sequential manner, the following information is available:
    • Attempted via First Backup - <channelname>
    • Request received from Primary Channel - <channel name>
    • Attempted via Second Backup - <channelname>
    •  Request received from First Backup - <channel name>
      For example, if the primary or default channel is Push, the first fallback is SMS, and the second fallback is Email, and the request fails for both Push and SMS and gets sent using the Email channel, the Delivery Info for these requests would appear as shown in the image below.test alert logs -old.png
  • Request: The Request tab contains the request payload for the specific channel for which the log is being displayed.
  • Response: The Response tab contains the response to the request generated by MoEngage.

Was this article helpful?
0 out of 1 found this helpful

How can we improve this article?