Transaction Logs
    • PDF

    Transaction Logs

    • PDF

    Article summary

    Article Overview

    The following article describes the Transaction Log screen. It details its structure and explains how to use it for platform-wide troubleshooting.

    Why Use The Transaction Logs Screen?

    The Transaction Logs screen is an operational tool that enables platform users to receive a detailed view of the status of their transactions and manage them. Using the Transaction Logs screen, platform users can maintain, investigate, and troubleshoot different issues by performing the following actions:

    • Locating a transaction or a group of transactions, by using flexible filters and new free text search capabilities.
    • Understanding transaction status and delving into multiple services and steps.
    • Monitor any kind of failed service execution - during or at the end of the transaction, read the error message, or download a log file.
    • Check email status directly from the email vendor platform, for example: opened by the end-user or rejected.
    • Download email attachments. 
    • Resume transactions and re-run transactions and services.
    • Monitor webhooks and retries.
    NOTE
    To fully use the Transaction Logs feature and its capabilities you must upgrade your environment servers to version 32.0.0 or above. For additional support please contact our support team. 

    (See Figure 1 and Figure 2)

    To navigate to the Transaction Logs screen, perform the following steps:

    Figure 1: Integrate Tab

    1. Click the Integrate tab (1).

    Result:

    The Integrate tab options appear:

    Figure 2: Transaction Logs Option

    1. Click the Transaction Logs option (2).

    Transaction Logs Screen

    Figure 3 and Table 1 describe the structure of the Transaction Logs screen.

    Figure 3: Transaction Logs Screen

    Table 1: Transaction Logs Screen

    Number

    Name

    Description

    1

    Search and Display Filters

    Enables to display and filter the transactions list by:

    • Search - enables searching transactions according to a transaction ID or customer details

    please get in touch with our support team

    NOTE
    If you cannot search transactions according to customer details, upgrade your environment servers to version 32.0.0 or above. For additional information please contact our support team.
    • Environment - Dev or Prod
    • Process Name
    • Journey Type
      • All
      • Digital Journey (process)
      • E-Signature Processes (EasySign)
    • Transaction Status
    NOTE
    For additional information about the transaction status, see the Transaction Section - General Structure
    • Date Range
    NOTE
    Once you selected all the desired filters, apply them by clicking the Update button 

    2

    Resume

    Enables resuming a single or several transactions, this will result in re-running all the actions and steps of a transaction’s last RID

    NOTE
    • The Resume button will become available after selecting one transaction or more
    • A Resume action may have implications on user data, communications sent, and/or data storage
    • For additional information about the Resume button, see the Using Resume section
    3

    Transactions

    Displays a list of transactions

    Transactions Section

    The following sections describe the transactions section.

    Transaction Section - General Structure

    (See Figure 4)

    The transactions section displays a list of transactions with the following information:

    a unique identifier of an EasySend transaction.

    • MasterRID/Request Identifier:
      • MasterRID - a unique identifier of an EasySend transaction.
      • Request Identifier - a unique identifier of an EasySign transaction.
    • Last RID - an RID is a unique identifier of an EasySend step. the RID is nested under the masterRID. When creating a transaction, it can be divided into steps, for example, when using the Workflow Manager. Each step will receive its own unique RID as part of its URL, for example: player-demo.easysend.app/customer/onboarding/page0/0?lang=en&rid=qDzVpy_U7gY. This column displays the last RID, or the last executed step, of the transaction. 
    • Process Name
    • Process Type:
      • Digital Journey
      • E-Signature Processes 
    • Timestamp of the last status change
    NOTE
    If you cannot view EasySign transactions, upgrade your environment servers to version 32.0.0  or above. For additional information please contact our support team. 
    NOTE
    The Transaction Logs screen displays time according to your local browser settings.
    • Transaction Status:
      • Opened - a transaction's link was clicked and opened. 
      • Link Sent - a transaction's link was sent, for example via the Bulk Sender or the Journey Sender.
      • Pending - this status is temporary and should change to Success or Failed in a few minutes. If a transaction displays a permanent Pending status, please contact our support team.
      • Completed - a transaction was completed successfully.
      • Failed - a transaction failed due to issues with its service/s.
      • Expired - a transaction's link expired. 
      • Cancelled - a transaction's link was canceled using the Journey Tracker.
    NOTE
    • A transaction with failed service/s can still have a Completed status. In this case, the  will appear indicating that the failures did prevent its progress.
    • If the indicator is not available for you, upgrade your environment servers to version 32.0.0 or above. For additional information please contact our support team.
    NOTE
    The pending status is temporary and should change to Success or Failed in a few minutes. If a transaction displays a permanent Pending status, please contact our support team.  
    NOTE
    If your status filter contains a status that is not featured on this list or if you are missing a status, please upgrade your environment servers to version 32.0.0 or above. For additional support please contact our support team.
    • Customer Name
    • Customer Email
    • Customer Phone
    • Customer ID
    • Sender Name - the name of the agent who sent the transaction's link.
    • Additional actions (located under theicon):
      • Re-Run
      • View Logz.io 
    NOTE
    Customer Name, Customer Email, Customer Phone, Customer ID, and Sender Name will contain data only after tagging. For more information, click here.
    NOTE
    • The View Logz.io option is only available for internal EasySend usage.
    • For additional information about Re-Run, see the Using Re-Run - Transaction section.

    Figure 4: Transactions

    Transaction List - Data Presentation and Organization  

    (See Figure 5 to Figure 7)

    The data presented in the transaction list is organized into three different levels:

    • First level - transaction. Each row in the list is a unique transaction of a digital process.

    Figure 5: First Level - Transaction

    NOTE
      • Second level - service. Each row in the list is a technical occurrence (specified in the Type column) that was attempted during a specific transaction. Technical occurrences include:
        • Integrations
        • Initiation integrations:
          • Salesforce
          • Dynamic 365
          • Guidewire  
        • Workflow Communication service email:
          • Start
          • Notification
          • Complete
          • Co-browsing
          • Save & Continue
        • Webhooks:
          • Simple
          • custom
        • In Webflow Integration
        • EasySign Output (EasySend email/SMS) 
        • Workflow outputs (EasySend email/SMS):
          • Start
          • Notification
          • Complete
          • Co-browsing
          • Save & Continue
        • The information displayed at this level is:
          • Service Name
          • Service Type
          • RID
          • Timestamp
          • Webflow Name
          • Service Status:
            • Success
            • Failed 
            • Not Run
          • Error Message
          • Additional actions:
            • Re-run
            • Download Log
            • View Logz.io
    NOTE
    If any of the columns is not available for you or some service types are missing, upgrade your environment servers to version 32.0.0 or above. For additional information please contact our support team
    NOTE
    The Transaction Logs screen displays time according to your local browser settings.
    NOTE
    • The View Logz.io option is only available for internal EasySend usage.
    • The Re-Run button located on this screen will become available after selecting one service or more. For additional information about using the Re-run button/option, see the Using Re-Run - Service section. 
    • For additional information about the Download Log option, see the Investigating Failures using JSON Files section.

    Figure 6: Second Level - Service

    NOTE
    To drill down to the third level, click a service.
    • Third level - step. Each row in the list is a step of a service that was attempted during a specific transaction. The information displayed at this level is:
      • Step Name
      • Step Type
      • Timestamp
      • Status:
        • Success
        • Failed
      • Retry Count
      • Error Message
      • Download Log - downloads a JSON file with information about the step.
    NOTE
    The Transaction Logs screen displays time according to your local browser settings.
    NOTE
    The Retry feature automatically runs a failed step up to 4 times. This feature enables you to monitor how many times a step has run. This feature is activated from the Customer Settings screen. For additional information, please contact our support team.  
    NOTE
    For additional information about the file download icon, see the Investigating Failures using JSON Files section.

    Figure 7: Third Level - Step

    Step Level Email Status 

    (See Figure 8 and Figure 9)

    When a service includes an email communication through one of EasySend's default email providers, the third level step displays different information:

    • Communication Type
    • Recipients
    • Timestamp
    • Status - displays the status of the email directly from the email provider.
    • Attachments - enables you to download the email's attachments.

    Figure 8: Email Communication

    Figure 9: Email Communication

    NOTE
    If the See Details button is not available for you, upgrade your environment servers to version 32.0.0 or above. For additional information please contact our support team. 

    Troubleshooting Scenarios 

    The following sections describe how to use the Transaction Logs screen for different troubleshooting scenarios. 

    Viewing Transactions Status

    (See Figure 10 and Figure 11)

    To display transactions and their status, perform the following steps: 

    Figure 10: Displaying Transactions

    1. Select an Environment (1).
    2. Set a Date Range (2).
    3. Click the Update button (3).

            Result: 

            A list of transactions appears (4).

    NOTE
    • If some or all transactions are not displayed after clicking the Update button, adjust the display filters and click the Update button again. If the Load more button appears, use it to load additional transactions.
    • If you are looking for a specific transaction according to its Master RID or Request ID, search and copy the information using the Journey Tracker. Click here for additional information about the Journey Tracker.

    After displaying transactions, you can view their status:

    Figure 11: Transactions Status

    Investigating Failures Using JSON Files    

    (See Figure 12 to Figure 18)

    A transaction can have a Failed status due to issues with a service or services. To investigate failures using JSON files, perform the following steps:

    Figure 12: List of Transactions

    1. Locate the desired failed transaction from the list and click it.

            Result:

            The service level list appears:

    Figure 13: Error Message

    1. From the list (1), locate the failed service.
    2. Read the Error Message (2).
    NOTE
    If the error message is not available, upgrade your environment servers to version 32.0.0 or above. For additional information, please contact our support team.

    Figure 14: Download Log

    1. Continue the investigation by clicking its three dots (3) and clicking the Download Log option (4).

            Result:

            A JSON file is downloaded.

    1. Open the JSON file using software such as Notepad ++.
    NOTE
    • A JSON is unreadable without using dedicated software such as Notepad ++ or Microsoft WordPad. To continue, make sure you have suitable software.
    • In our examples we will use Notepad ++ with a JSON Viewer plugin and the Format Viewer option. 
    1. To learn about the failure using  the JSON file:
      1. Search for objects with keywords such as "null" or "false".
      2. Navigate to the bottom of the JSON file and search for the "error" field.

    Figure 15: JSON File Information Example

    1. To investigate the step/s of the service, click it (5). 

    Figure 16: Failed Service

                Result:

                The step level list appears:

    Figure 17: List of Steps

    1. From the list (6), locate the failed step and read the Error Message (7).
    NOT
    If the error message is not available, upgrade your environment servers to version 32.0.0 or above. For additional information, please contact our support team.
    1. Click the icon (8) to download the JSON file.

            Result:

            A JSON file is downloaded.

    1. Open the JSON file using software such as Notepad ++.
    NOTE
    • A JSON is unreadable without using dedicated software such as Notepad ++ or Microsoft WordPad. To continue, make sure you have suitable software.
    • In our examples we will use Notepad ++ with a JSON Viewer plugin and the Format Viewer option. 
    1. To learn about the failure using  the JSON file:
      1. Search for objects with keywords such as "null" or "false".
      2. Navigate to the bottom of the JSON file and search for the "error" field.

    Figure 18: JSON File Information Example

    NOTE
    The information learned during the investigation can be used for internal troubleshooting. In case further assistance is required, please contact our support team, and provide your findings.

    Viewing Email Status and Retrieving Attachments  

    (See Figure 19 to Figure 22)

    When a service includes an email communication through one of EasySend's default email providers, it is possible to view the status of the email and retrieve its attachments. To do so, perform the following steps:

    Figure 19: List of Transactions

    1. Locate the desired transaction from the list (1) and click it.

            Result:

            The service level list appears:

    Figure 20: List of Services

    1. From the list (2), locate the desired service with an email service and click it.

            Result:

           The service's step appears:

    Figure 21: Step

    1. Click the See Details button (3).

            Result:

           The Email Details window appears:

    Figure 22: Email Details Window

    NOTE
    If the See Details button is not available for you, upgrade your environment servers to version 32.0.0 or above. For additional information please contact our support team. 
    1. Click the icon (4) to download the email attachment.

    Using Resume

    (See Figure 23 to Figure 25)

    Resuming transactions will result in re-running all the actions and steps of the transaction’s last RID, and may have implications on user data, communications sent, and/or data storage. To use the Resume button, perform the following steps:

    Figure 23: Resume Button

    1. Locate the desired transaction and check its checkbox (1) (Repeat this step for any additional desired transactions).
    NOTE
    You can only resume failed or completed transactions.
    1. Click the Resume button (2).

            Result:

            The Resume Transactions window appears:

    Figure 24: Resume Transactions Window

    1. Click the Run button (3).

    Figure 25: Resumed Transactions

    All actions and steps of the transaction's last RID started a re-run process. When the transactions appear again a resumed transaction will appear at the top of the list and its status will update according to the resume process result. The  icon will appear next to it.

    NOTE
    If the  icon does not appear, upgrade your environment servers to version 32.0.0 or above. For additional information please contact our support team.

    Using Re-Run - Transaction

    (See Figure 26 to Figure 28)

    Re-running a transaction will result in running all subsequent functions, actions, and services that occur at the end of the step as if the end-user clicked submit. The Re-Run option is accessible only for transactions with at least one step (RID) that have been completed or failed. To use the Re-Run button to resubmit a transaction, perform the following steps:

    Figure 26: Re-Run Option

    1. Locate the desired transaction, click the three dots (1), and then the Re-Run option (2).
    NOTE
    If the Re-Run option is not available, upgrade your environment servers to version 32.0.0 or above. For additional information please contact our support team.

            Result:

            The Re-Run Transaction window appears:

    Figure 27: Re-Run Transaction Window

    1. Select RID (3).
    2. Click the Run button (4).

    Figure 28: Re-Run Transactions

    All subsequent functions, actions, and services that occur at the end of the step had run again. When the transactions appear again a re-run transaction will appear at the top of the list and its status will update according to the result. The  icon will appear next to it.

    NOTE
    If the  icon does not appear, upgrade your environment servers to version 32.0.0 or above. For additional information please contact our support team.

    Using Re-Run - Service

    (See Figure 29 to Figure 32)

    The Re-Run button/option enables you to resubmit one service or more. This will result in rerunning all actions/steps and may have implications on user data, communications sent, and data storage. To use the Re-Run button to resubmit a service, perform the following steps:

    Figure 29: List of Services

    1. Locate the desired service from the list and check its checkbox (1) (repeat this step for any additional desired services).
    NOTE
    Please note that you cannot use the Re-Run button or option for In Webflow Integration services and Webhook services.

            Result:

            The Re-Run button (2) is now active:

    Figure 30: Active Re-Run Button

    NOTE
    Please note that you cannot use the Re-Run button or option for In Webflow Integration services and Webhook services.
    1. Click the Re-Run button.

            Result:

            The Re-Run Services window appears:

    Figure 31: Run Button

    1. Click the Run button (3).

    Figure 32: Re-Run Services

    All actions and steps of the service started a re-run process. When the services appear again a new instance of the re-run service will appear at the top of the list and its status will update according to the result. The  icon will appear next to it.

    NOTE
    If the  icon does not appear, upgrade your environment servers to version 32.0.0 or above. For additional information please contact our support team.
    NOTE
    • You can also use the Re-Run option by clicking the three dots and then Re-Run.
    • The Re-Run option will not be available for In Webflow Integration services and Webhook services.

    Escalation to EasySend's Support

    In some cases, after exhausting all self-troubleshoot options, you may be required to escalate the problem to EasySend's support. For example:

    • If any of the features or capabilities are not available in your environment you need to upgrade your servers. For additional information, contact EasySend's support.
    • A transaction is in a Failed status, but all services are in a Success status. In this case, try to resume or re-run the transaction (as described in the Using Resume section and in the Using Re-Run - Transaction section) or re-run its services (as described in the Using Re-Run section). If the problem persists, contact EasySend's support.
    • A transaction is in a Failed status and no services are visible. In this case, try to resume or re-run the transaction (as described in the Using Resume section and in the Using Re-Run - Transaction section). If the problem persists, contact EasySend's support.
    • A transaction is in Pending status. In this case, wait for its status to change but if the problem persists, contact EasySend's support. 

    Tagging

    (See Figure 33 and Figure 34)

    The Customer Name, Customer Email, Customer Phone, Customer ID, and Sender Name will be empty by default unless metadata tagging is performed. To perform the tagging:

    Figure 33: Tagging 1 of 2

    1. Access the Model screen of the digital process.
    2. Click the relevant data item for the name information (1).
    3. Click Metadate (2).
    4. Click the Tagging dropdown (3).
    5. For example, click customerFirstName (4).

    Result:

    The data item is tagged:

    Figure 34: Tagging 2 of 2

    1. Repeat steps 1 to until all the fields are tagged.
    2. Perform a deployment.

    Was this article helpful?

    What's Next