Ghost/ghost/email-analytics-provider-mailgun/lib/EmailAnalyticsProviderMailgun.js
Steve Larson 8f3985bc66
Reverted email analytics jobs commits (#20835)
ref https://linear.app/tryghost/issue/ENG-1518

After releasing the analytics job improvements, it appears for large
sites we're awfully close to missing some Mailgun events because of an
unexpected behavior of the aggregateStats call for just the opened
events job. This is taking 2-5x(+) the amount of time that the aggregate
queries take for the other jobs, despite not being dependent on the
events.

To err on the side of caution, we're going to roll this back and look to
optimize the aggregation queries before re-implementing. And we may be a
bit more cautious in giving _some_ but not _all_ priority to the
`opened` events.
2024-08-27 16:15:34 -05:00

62 lines
2.3 KiB
JavaScript

const MailgunClient = require('@tryghost/mailgun-client');
const EVENT_FILTER = 'delivered OR opened OR failed OR unsubscribed OR complained';
const PAGE_LIMIT = 300;
const DEFAULT_TAGS = ['bulk-email'];
class EmailAnalyticsProviderMailgun {
mailgunClient;
constructor({config, settings}) {
this.mailgunClient = new MailgunClient({config, settings});
this.tags = [...DEFAULT_TAGS];
if (config.get('bulkEmail:mailgun:tag')) {
this.tags.push(config.get('bulkEmail:mailgun:tag'));
}
}
/**
* Fetch from the last known timestamp-TRUST_THRESHOLD then work forwards
* through pages until we get a blank response. This lets us get events
* quicker than the TRUST_THRESHOLD
*
* @param {Function} batchHandler
* @param {Object} [options]
* @param {Number} [options.maxEvents] Not a strict maximum. We stop fetching after we reached the maximum AND received at least one event after begin (not equal) to prevent deadlocks.
* @param {Date} [options.begin]
* @param {Date} [options.end]
*/
fetchLatest(batchHandler, options) {
const mailgunOptions = {
limit: PAGE_LIMIT,
event: EVENT_FILTER,
tags: this.tags.join(' AND '),
begin: options.begin ? options.begin.getTime() / 1000 : undefined,
end: options.end ? options.end.getTime() / 1000 : undefined,
ascending: 'yes'
};
return this.#fetchAnalytics(mailgunOptions, batchHandler, {
maxEvents: options.maxEvents
});
}
/**
* @param {Object} mailgunOptions
* @param {Number} mailgunOptions.limit
* @param {String} mailgunOptions.event
* @param {String} mailgunOptions.tags
* @param {String} [mailgunOptions.begin]
* @param {String} [mailgunOptions.ascending]
* @param {Function} batchHandler
* @param {Object} [options]
* @param {Number} [options.maxEvents] Not a strict maximum. We stop fetching after we reached the maximum AND received at least one event after begin (not equal) to prevent deadlocks.
*/
async #fetchAnalytics(mailgunOptions, batchHandler, options) {
return await this.mailgunClient.fetchEvents(mailgunOptions, batchHandler, options);
}
}
module.exports = EmailAnalyticsProviderMailgun;