Discussion
Pegasystems Inc.
US
Last activity: 16 Aug 2024 16:01 EDT
Ask the Expert - Email Accounts and Email Listeners with Nagarjuna Vallepu & Sai Teja Sidagam
Join us in this month's Ask the Expert as @NAGARJUNA VALLEPU, Principal Technical Support Engineer, Platform Service Engineering and @Sai Teja Sidagam , Senior Technical Support Engineer - Platform Service Engineering share their knowledge on Email Accounts and Email Listeners.
If you have questions about Email Accounts and Email Listeners, both Sai Teja and Nagarjuna are happy to answer them!
Make sure to Favorite and Follow for updates via the Notification bell and/or weekly digest!
Session dates: 12 August - 16 August
Session opens to questions on 12 August!
Meet Your Experts:
Nagarjuna Vallepu, who joined in 2019, initially focused on Platform Service Engineering (PSE) before transitioning to the Platform Integration backlog. He has expertise in managing inbound, outbound email and Email Listener issues.
Sai Teja Sidagam specializes in Email Account and Email Listener features. With three years at Pega and eight years of experience in development and support operations, Sai Teja brings valuable expertise to his role. His deep understanding and proficiency in these areas make him an invaluable asset to the team, ensuring seamless and efficient email-related functionalities.
Message from Your Experts:
We specialize in integrating email accounts and listeners within the Pega platform. With extensive expertise in this area, We look forward to assisting you with your email account and listener-specific inquiries.
Ask the Expert Rules
- Follow the Pega Support Center's Rules of Engagement
- This is not a Live Chat - Nagarjuna and Sai Teja will reply to your questions over the course of the session
- Questions should be clearly and succinctly expressed
- Questions should be of interest to many others in the audience
- Have fun!
-
Likes (3)
Nagarjuna Vallepu Sai Teja Sidagam Bhargavi Siripurapu -
Share this page Facebook Twitter LinkedIn Email Copying... Copied!
Pegasystems Inc.
US
Thank you to @NAGARJUNA VALLEPU and @Sai Teja Sidagam for being our experts in this session on Email Accounts and Email Listeners!
Ask your questions now! This special session is only open until Friday 16 August 2024!
-
Bhargavi Siripurapu
Cognizant
IN
Hi @NAGARJUNA VALLEPU / @Sai Teja Sidagam ,
Recently we have upgraded our pega version from 8.6 to 23.1.2, and we could see one of our email listeners is going to the error queue we were not able to find what exactly the error is and the main use of the email listener is to resolve the case which is executed fine even though the listerner is in error state.
Could you help us in the following issue.
Pegasystems Inc.
IN
To debug this issue:
- Hover over the error to verify the details displayed.
- Review the Log-Service-Email instances and filter entries by listener name to find XML that may indicate the failure reason. The table provides the reason for the error in the Error Reason column.
- Enable the "pxIntegration.EmailListener" log category from admin studio and set the level to DEBUG to capture detailed logs on the failures.
Thanks,
Sai Teja S.
-
Abhinav Gupta Nagarjuna Vallepu
Deloitte TTL
IN
Hi Team,
What do "Run On All Nodes" startup option exactly does in Email Listener? Also could you please provide your insights on the below scenarios?
Consider, User is receiving an single email into "INBOX" folder. Now providing Startup Option as "Run On All Nodes", how many instances will be created and does this single email will be processed in multiple threads (nodes) ?
Thanks,
Vignesh.
Pegasystems Inc.
US
@Vigneshk2107 Hi Vignesh
When you select Run on all nodes for the email listener Startup option, the listener will run on all nodes — all servers in the cluster. Therefore, each node has its own instance running and polling toward the configured email box (ex: inbox); if any one listener identifies(randomly) and locks the item in the email inbox, the other threads wait to process.
Thanks
Nagarjuna
-
VIGNESH K Abhinav Gupta
Pegasystems Inc.
IN
@Vigneshk2107 Hey Hi Vignesh,
Selecting the "Run On All Nodes" option creates and starts an instance of the Email Listener on each node in the Pega cluster that's configured to run it. For example, with 3 nodes in the cluster, there will be 3 separate instances of the Email Listener running, one on each node.
Will the single email be processed in multiple threads (nodes)?
No, the single email will not be processed by multiple nodes simultaneously. When the Email Listener retrieves an email from the "INBOX" folder, one listener instance locks the email for processing, preventing other listeners from picking it up. This guarantees that the email is handled by only one listener instance on one node, even if the listener is running on all nodes. This will efficiently balance the load while preventing duplicate email processing.
Thank you,
Sai Teja S.
-
VIGNESH K Abhinav Gupta
Deloitte TTL
IN
Hi Team,
While doing a POC on Email-Listener, I came across the below 2 issues. Could you please provide your insights on the same?
1. Email listener is going to sleep mode always. When we restarted it just pick one mail and processed, followed by Sleep mode again. So for each email to be picked up, it's expecting to restart the listener every time. What could be the possible RCA here? FYI, latency period is kept as 300, Max msgs = 100, Max processing time = 500, concurrent threads = 1.
2. Whenever email listener processes a email, its sending an empty email to the sender address.
Thanks,
Vignesh.
-
VIGNESH K
Updated: 12 Aug 2024 17:55 EDT
Pegasystems Inc.
US
Hi Vignesh ,
Issue 1: There may be a problem with the email inbox having too many emails or the thread being blocked at the time of the processing, To debug the issue check the entries log-service-email instances and filter the entries with listener name the XML may have a reason for the failure reason to process
Enable the log category pxIntegration.EmailListener and set the level to debug, the logs may produce the reason for the failures.
Issue 2: Was the email received without a subject and body? What email activity is involved in sending the email, are these auto-reply emails from the listener?
If the behavior is persistent a trace of the activities involved in submitting an email might help identify the problem
-
VIGNESH K
Deloitte TTL
IN
Thanks @NAGARJUNA VALLEPU and @Sai Teja Sidagam for the clear explanation!
-
Sai Teja Sidagam Bhargavi Siripurapu Nagarjuna Vallepu Abhinav Gupta
Updated: 13 Aug 2024 7:26 EDT
Tata Consultancy Services
IN
Hi @NAGARJUNA VALLEPU , @Sai Teja Sidagam and Team,
Do we have any updates on this?
https://support.pega.com/discussion/enhancement-request-authentication-profile-rule
I have a question -->
I have account in Brazil, Email Account Settings in Brazil Language, We are configured Folder Name : CAIXA DE ENTRADA in Email Listeners, (INBOX = CAIXA DE ENTRADA -- Portuguese (Brazil)).
Now the user Browser Settings in English language. But why Browser settings always precedence over the email account settings.
The email listeners are not able to read the mails, and throwing the error like root folder not found.
Thanks,
Ashok
Pegasystems Inc.
IN
Hello @Bhumireddy,
To track the status of the feedback request, please contact the account executive for an update.
Please note that the Pega engineering team will address this based on the urgency and severity of the issue.
Thank you.
Tata Consultancy Services
IN
Thank you for the response.
That is not a issue, My general Question.
Thanks, Ashok
Pegasystems Inc.
US
Hi Bhumireddy
Thank you for sharing your request for an enhancement to product functionality. We deeply value our community’s experiences as we continuously improve our products and services. FDBK-99209 has been forwarded to the team for review and triage. You may receive details shortly.
Regarding the issue related to the root folder not being found, Does the default setting picked from the browser converting the name of the folder within the rule form or at runtime?
To cross-check the actual Folder Name mapping at runtime, you can trace the listener, or you may reference the folder name using Application Settings to see if there is a difference.
https://support.pega.com/question/dynamic-resolve-folder-name-email-listener-application-settings
Accenture
AU
We have several business teams using email listeners, with the multiple listeners configured for different email accounts. Some business teams want to be notified when an autoreply message is received (specially for Out of Office) while others do not. Whet is the best way to configure this.
We are aware of Autoreply message filtering | Pega but this seems to be at a platform level is there a way to manage this at a listener level?
Also, for the Autoreply message filtering what was not clear is that if we want to listen to some autoreply types like "Out of Office" but not to "delivery failure notifications" is there a way to configure this?
Pegasystems Inc.
US
Hello Kaustav Dutta,
Please check if the following approach matches your requirements.
Process delivery status notifications (DSNs) can be configured for individual Email listeners to process the notifications, DSN setting will take precedence over Email/AutoReplySubject DSS.
AutoReplySubject default looks for the Auto-Submitted header in the subject of incoming email messages and then looks for the additional patterns, if the Auto-Submitted header is not found it validates the additional patterns, and a feedback request is created for the customization requirement for the product.
Updated: 16 Aug 2024 15:21 EDT
Pegasystems Inc.
US
Here are troubleshooting guides and setup guides for different types of email accounts and email listeners
Creating an email account in Dev Studio :
https://docs-previous.pega.com/data-management-and-integration/86/creating-email-account-dev-studio
Configuring OAuth 2.0 authentication for sending and receiving emails by using Microsoft Graph
Ensuring messages are processed before switching your email protocol to Microsoft Graph
Configuring proxy settings for Microsoft Graph email accounts
https://docs.pega.com/bundle/platform/page/platform/data-integration/configuring-proxy-msgraph.html
Sending email by using Gmail with SMTP and OAuth 2.0
List of Dynamic system settings for email integrations:
Here are troubleshooting guides and setup guides for different types of email accounts and email listeners
Creating an email account in Dev Studio :
https://docs-previous.pega.com/data-management-and-integration/86/creating-email-account-dev-studio
Configuring OAuth 2.0 authentication for sending and receiving emails by using Microsoft Graph
Ensuring messages are processed before switching your email protocol to Microsoft Graph
Configuring proxy settings for Microsoft Graph email accounts
https://docs.pega.com/bundle/platform/page/platform/data-integration/configuring-proxy-msgraph.html
Sending email by using Gmail with SMTP and OAuth 2.0
List of Dynamic system settings for email integrations:
Autoreply message filtering :
https://docs-previous.pega.com/data-management-and-integration/87/autoreply-message-filtering
Process delivery status notifications (DSNs) :
Configuring email listener processing:
https://docs.pega.com/bundle/platform/page/platform/data-integration/email-listener-processing.html
Best practices for optimizing email listener performance:
https://docs-previous.pega.com/data-management-and-integration/87/browsing-email-listener-logs
Updated: 16 Aug 2024 16:01 EDT
Pegasystems Inc.
IN
Please go through the following steps on Understanding and Troubleshooting Common Email Integration Issues. Before diving into troubleshooting, use the following Pega Platform features to identify potential email listener issues:
- Check Alerts: Look for any alerts indicating that the listener is disabled.
- PDC Warnings: Ensure no warnings are displayed on the Dynamic System Settings landing page in Pega Diagnostic Center (PDC).
- Log-Service-Email Table: Review this instances and filter entries by listener name to find XML that may indicate the failure reason. The table provides the reason for the error in the Error Reason column.
These are the quick steps to debug Email Listener issues:
1. Email Listeners Stuck:
- Check Status: Verify the status of the Email Listener in Admin Studio.
- Stop & Restart: If the Listener is stuck, attempt to stop it. If unsuccessful, restart the affected node to terminate the running thread. Then, manually restart the Listener if its status shows as Stopped.
2. Email Listeners Throwing Errors/Exceptions:
Please go through the following steps on Understanding and Troubleshooting Common Email Integration Issues. Before diving into troubleshooting, use the following Pega Platform features to identify potential email listener issues:
- Check Alerts: Look for any alerts indicating that the listener is disabled.
- PDC Warnings: Ensure no warnings are displayed on the Dynamic System Settings landing page in Pega Diagnostic Center (PDC).
- Log-Service-Email Table: Review this instances and filter entries by listener name to find XML that may indicate the failure reason. The table provides the reason for the error in the Error Reason column.
These are the quick steps to debug Email Listener issues:
1. Email Listeners Stuck:
- Check Status: Verify the status of the Email Listener in Admin Studio.
- Stop & Restart: If the Listener is stuck, attempt to stop it. If unsuccessful, restart the affected node to terminate the running thread. Then, manually restart the Listener if its status shows as Stopped.
2. Email Listeners Throwing Errors/Exceptions:
- Log Review: Check PDC or PegaRULES logs for the following errors:
- Socket Timeout/Connection Drop: Indicates connectivity issues with IMAP servers. Consult the Email server admin for resolution.
- Log-Service-Email Table: Review this table to understand specific errors and reason codes.
- Protocol Upgrade: Consider switching to MSGraph instead of traditional IMAP/POP3 as a long-term solution.
3. Performance Degradation:
- Email Content Review: Check for large attachments, which may cause the following alerts:
- PEGA0014: Inbound mapping time exceeds limit.
- OPS0035: Number of failed messages exceeds threshold.
- OPS0038: Average message processing time exceeds threshold.
- PEGA0119: Email listener activity time exceeds limit.
- Workaround: Reduce the size of the attachment or avoid long running processes by moving the Emails to another folder. Make sure that Optional property fetch size on Email account rule form is set to 1 MB mail.imap.fetchsize as 1024000 and mail.imap.partialfetch as True (Versions later than Pega 8.6 has this as default).
4. Unable to Start Email Listener:
- Startup Option: Verify the Startup option on the Email Listener rule form is selected.
- Node Configuration: Ensure the Listener is configured to start on the correct node.
- Blocked Option: Check that the 'Blocked' option is not selected on the rule form, as this disables the Listener.
5. MSGraph Configuration Issues:
- Access Denied: Check the Pega-RULES log for access denied messages related to MSGraph.
- Azure Permissions:Ensure required permissions (`Mail.Send`, `Mail.ReadWrite`, and `User.Read`) are enabled in Azure.
Common issues that can arise in email integration and learn effective troubleshooting techniques: Troubleshooting an email integration.
-
Matheswaran Ravichandran