Troubleshooting email problems when using the SMTP Authentication Support module

When you are using the SMTP Authentication Support module, email is sent directly from the your Drupal application through the mail server that you specify in the module configuration.

Sometimes it can be a bit difficult to understand why email that you expect to see from your site hasn't been delivered. 

1. First, log into your site, and go to the settings page at http://yoursitename.com/admin/config/system/smtp
   copy

   &nbps;

2. Then, enable Debugging (using the checkbox toward the bottom of the setting pages). This will enable logging with SMTP in the drupal-watchdog.log for every email that is sent from the site. 
3. Use the Send a Test E-Mail feature to send yourself a test email. If you don't get the email, don't worry. We are using this to look through the logs in the next step.
4. Use SSH to connect to your sever, and cd to switch to the directory with your log files, usually this is 
   copy

   /var/log/sites/[site].[env]/logs/[servername]/[logname].log

5. Use grep to look through your drupal-watchdog.log and find SMTP logs with the following search:
   copy

   grep smtp drupal-watchdog.log

   You will likely get a result that looks a lot like:
   copy

   drupal-watchdog.log:Sep 26 17:29:52 172.16.2.133 ohio: https://yoursitename.com|1537982992|smtp|207.173.24.186|https://yoursitename.com/admin/config/system/smtp|https://yoursitename.com/admin/config/system/smtp|1||Sending mail to: [email protected] request_id="v-c6b6b524-c1b1-11e8-b5cc-abe438f9b08b"

6. You may get a large number of results, if you do not to worry, just scroll to the end, and use a grep by the request_id to pull up all of the logs related to a particular SMTP request.
   copy

   grep request_id="v-c6b6b524-c1b1-11e8-b5cc-abe438f9b08b" *.log

   You will get all of the related transactions for that particular request. If you get lucky, the email error will be pretty straightforward like this one:
   copy

   drupal-watchdog.log:Sep 26 17:29:53 172.16.2.133 ohio: https://yoursitename.com|1537982993|smtp|207.173.24.186|https://yoursitename.com/admin/config/system/smtp|https://yoursitename.com/admin/config/system/smtp|1||Error sending e-mail from [email protected] to [email protected]: SMTP Error: Data not accepted.SMTP server error: 5.2.0 STOREDRV.Submission.Exception:InvalidLicenseException; Failed to process message due to a permanent exception with message Mailbox 'df962302-379c-4290-9c1a-df8b74d200fa' doesn't have a valid license. InvalidLicenseException: Mailbox 'df962302-379c-4290-9c1a-df8b74d200fa' doesn't have a valid license. request_id="v-c6b6b524-c1b1-11e8-b5cc-abe438f9b08b"

   This error was resolved by contacting the email provider and renewing the license.