# Velocity.log is vital to your success {% hint style="info" %} **Velocity.log knows all and sees all.** The most important component in the entire Velocity MTA ecosystem is velocity-install/logs/velocity.log. {% endhint %} * Want to know if your configuration change went through? Check velocity.log. * Want to know why your message didn't get delivered? Check velocity.log * Want to know how an unsubscribe happened you swear you didn't do? Check velocity.log * Want to know why opens or clicks aren't showing up? Check velocity.log * Want a real-time look into the email delivery "black hole"? Check velocity.log * Want to open a ticket? Please check velocity.log All outgoing email, incoming email, opens, clicks, and unsubscribes for mail sent through Velocity MTA are stored for eternity in the same file, to see the most recent 100 log entries do: ``` tail -100 /root/velocity-install/logs/velocity.log ``` Upon startup, you should see output similar to the following ``` cdd9bc69586595e21c3404faf9814e2d534705de022132bfcf27ac33a427d114 License is activated! :TRACE:::Starting ``` When changes to policies, server settings, or ip warmups have been pushed from the platform installation backend MTA UI you can verify they were received if you see output similar to the following ``` :API:::172.50.100.1:33552 POST /settings :API:::Finished writing settings ``` When sending a test message through the email marketing broadcast test widget, you should see output similar to the following for troubleshooting purposes {% code overflow="wrap" %} ``` :API:::172.50.100.1:37458 POST /send-addr :TRACE:::looking up MX for gmail.com :TRACE:::gmail.com has 5 MX servers :TRACE:::looking up A for gmail-smtp-in.l.google.com. :TRACE:::IPs for gmail-smtp-in.l.google.com.: []string{"74.125.200.26", "2404:6800:4003:c00::1a"} test:TRACE:secretseedemail@gmail.com:192.168.100.1:mail.vitaminpowerhouse.com:Connecting to gmail.com -> gmail-smtp-in.l.google.com. (74.125.200.26) test:SEND:secretseedemail@gmail.com:192.168.100.1:mail.vitaminpowerhouse.com:Message delivered in 6.374919129s ``` {% endcode %} {% hint style="warning" %} **Test messages receive special handling** Messages using the test widget in broadcasts don't appear in the [ip delivery reports](https://docs.emaildelivery.com/docs/velocity-mta-continuing-education/ip-delivery-reports) or [mail queue management](https://docs.emaildelivery.com/docs/velocity-mta-continuing-education/mail-queue-management), they receive the highest priority and bypass all other outstanding mail. This also applies to funnels. {% endhint %} When sending bulk production mail you should see output similar to the following {% code overflow="wrap" %} ``` POST /send-lists YRi9Ah7sfE5ALgRH9UbY3s:TRACE:::Reading http://emailplatformdomain.com/transfer/lists/YRi9Ah7sfE5ALgRH9UbY3s-TyRbwf359f4MXW6mDxEnKv/0-eggplantmail.com-KBRBk9yKdsdJdFpmLG4LVt-MXyBAcQLuAs34F6r8Q9B6z-16-00000000.blk YRi9Ah7sfE5ALgRH9UbY3s:TRACE:::Reading http://emailplatformdomain.com/transfer/lists/YRi9Ah7sfE5ALgRH9UbY3s-TyRbwf359f4MXW6mDxEnKv/0-parmesanmail.com-KBRBk9yKdsdJdFpmLG4LVt-MXyBAcQLuAs34F6r8Q9B6z-16-00000000.blk Reading /conf/send-YRi9Ah7sfE5ALgRH9UbY3s-MXyBAcQLuAs34F6r8Q9B6z-eggplantmail.com-0/list-00000000.blk YRi9Ah7sfE5ALgRH9UbY3s:TRACE:::Uploaded send log file /logs/send-YRi9Ah7sfE5ALgRH9UbY3s.log-1681444242-sending ``` {% endcode %} {% hint style="info" %} **SEND, DEFER, SOFT, HARD** There are four types of potential delivery outcomes recorded in the velocity.log file {% endhint %} **SEND** means successful message delivery {% code overflow="wrap" %} ``` SEND:disposabletemporary+hello@gmail.com:192.168.100.1:mail.vitaminpowerhouse.com:Message delivered in 2.140289308s ``` {% endcode %} **DEFER** means a sending pause has been triggered and shows you the complete error code and deferral message returned by the mailbox provider {% code overflow="wrap" %} ``` DEFER:misunderestimated@yahoo.com:192.168.100.1:mail.vitaminpowerhouse.com:421 4.7.0 [TSS04] Messages from 192.168.100.1 temporarily deferred ``` {% endcode %} **SOFT** shows you the complete error code and temporary bounce message returned by the mailbox provider {% code overflow="wrap" %} ``` SOFT:misunderestimated12345@gmail.com:192.168.100.1:mail.vitaminpowerhouse.com:452 4.2.2 The email account that you tried to reach is over quota. Please direct 4.2.2 the recipient to 4.2.2 https://support.google.com/mail/?p=OverQuotaTemp h3-20020a05600c350300b003f31a440e2fsi1991773wmq.13 - gsmtp (Rcpt) in 1.480220065s ``` {% endcode %} **HARD** shows you the complete error code and permanent bounce reason returned by the mailbox provider {% code overflow="wrap" %} ``` HARD:bademailonpurpose123000@gmail.com:192.168.100.1:mail.vitaminpowerhouse.com:550 5.1.1 The email account that you tried to reach does not exist. Please try 5.1.1 double-checking the recipient's email address for typos or 5.1.1 unnecessary spaces. Learn more at 5.1.1 https://support.google.com/mail/?p=NoSuchUser f7-20020a7bcd07000000b003f0ae6369e2si4683916wmj.234 - gsmtp (Rcpt) in 1.431423553s ``` {% endcode %} Web activity for opens, clicks, and unsubscribes will be logged as HTTP GET requests, you should see output similar to the following 
GET /l?t=adviser&r=4KQbmSaDsWWWm8gvs-11DRR&c=nHet3QX8kNc8BdjtbTmo5x&u=45CCjYmMhYqNhpCX0tfF&l=J8VrP7iaiVoL2PeNthk8UG Mozilla/5.0 (iPhone; CPU iPhone OS 16_4_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/16.4 Mobile/15E148 Safari/604.1

GET /l?t=adviser&r=4KQbmSaDsWWWm8gvs-11DHW&c=avDvnrUNfeHQSu8ZXppZYW&u=xaukrq6spKeymw&l=LCHLfWNEKcRy78ihbc74up Mozilla/5.0 (Linux; Android 12; SAMSUNG SM-S124DL) AppleWebKit/537.36 (KHTML, like Gecko) SamsungBrowser/20.0 Chrome/106.0.5249.126 Mobile Safari/537.36

GET /l?t=bend&r=4KQbmSaDsWWWm8gvs-11DR8&c=nHet3QX8kNc8BdjtbTmo5x&u=n_z3_u3y_ubx-sD1uQ YahooMailProxy; https://help.yahoo.com/kb/yahoo-mail-proxy-SLN28749.html

GET /l?t=bend&r=4KQbmSaDsWWWm8gvs-11DDK&c=T6yLhvtUJy5NzEARwRj3hq&u=h-7m6ejp9Oz-9-K22Q Mozilla/5.0 (Windows NT 5.1; rv:11.0) Gecko Firefox/11.0 (via ggpht.com GoogleImageProxy)
Complaints are processed by the [incoming email MX server](https://docs.emaildelivery.com/docs/velocity-mta-continuing-education/incoming-email-mx-server)