We're experiencing difficulty. Our engineers are on it. Please check status.mailgun.com for real-time updates.

What can I search for in logs and events?

Mailgun customers send millions of emails per month, so finding the status of a specific email can be like finding a needle in a haystack. 

We built the API to be highly performant, even across 10s of millions of log entries. To do this, we built the API on top of ElasticSearch, an open source framework for building real-time search and analytics.

Fields you can search across:

  • From address
  • To address
  • Recipient address
  • Event type
  • List name
  • Tag name
  • Attachment name
  • Message ID
  • Subject

Examples of some search queries you can run:

  • "foo bar" matches field values that contain both term "foo" and term "bar".
  • "foo AND bar" same as above.
  • "foo OR bar" matches field values that contain either term "foo" or term "bar".
  • ""foo bar"" (with quotes) matches field values that literally contain "foo bar".
  • "@example.com" matches all from, to and recipients @example.com

Things to keep in mind:

  • We only store your events data for a certain number of days
    • Free accounts - 2 days
    • Paid accounts (with a credit card on file) - 30 days
  • We store the raw MIME of the message for up to 3 days
Getting Started Sending Mail Receiving Mail Deliverability & Reputation Email Tracking Troubleshooting
Powered by Zendesk