← Cloudflare Email Service / email-service / observability

Metriky a analytika

Email Service poskytuje analytické nástroje, pomocí kterých můžete sledovat výkon odesílání e-mailů a míru doručení napříč všemi doménami.

Metriky zobrazené v Cloudflare dashboard ↗ grafy se získávají z dat Cloudflare GraphQL Analytics API. K metrikám máte přístup přes programově přes GraphQL nebo HTTP klienta.

Email Service aktuálně poskytuje následující metriky:

Metriky lze dotazovat (a jsou uchovávány) po dobu posledních 31 dnů.

Analytika Email Service pro jednotlivé domény je dostupná v Cloudflare dashboardu. Aktuální i historické metriky zobrazíte takto:

1. Přihlaste se do Cloudflare dashboard ↗ a vyberte svůj účet.
2. Přejděte na Compute > Email Service a vyberte Email Sending nebo Email Routing.
3. Vyberte existující doménu, nebo zobrazte metriky za celý účet.
4. Vyberte Analytics kartě.

Volitelně můžete vybrat časové okno pro dotaz. Výchozí hodnota je posledních 24 hodin.

Analytiku pro domény vaší služby Email Service můžete programově dotazovat prostřednictvím GraphQL Analytics API. Toto API dotazuje stejné datové sady jako dashboard Cloudflare a podporuje GraphQL introspekce.

Chcete-li začít používat GraphQL Analytics API, postupujte podle dokumentace a nastavte Autentizace pro GraphQL Analytics API. Váš API token musí obsahovat Analytics Read oprávnění.

Toto jsou na úrovni zóny datasety. Pokud je chcete dotazovat, uveďte ID zóny (nikoli ID účtu) jako zoneTag filtr. GraphQL datasety pro Email Service zahrnují:

• emailSendingAdaptiveGroups : agregované počty odeslaných e-mailů se seskupitelnými dimenzemi
• emailSendingAdaptive : jednotlivé události odesílání e-mailů
• emailRoutingAdaptiveGroups : agregované počty směrování e-mailů se seskupitelnými dimenzemi
• emailRoutingAdaptive : jednotlivé události směrování e-mailů

emailSendingAdaptiveGroups dataset podporuje následující dimenze pro seskupování a filtrování:

emailSendingAdaptive dataset obsahuje vše výše uvedené a navíc pole pro jednotlivé události: from, to, subject, messageId, sessionId, errorDetail.

emailRoutingAdaptiveGroups dataset podporuje následující dimenze pro seskupování a filtrování:

emailRoutingAdaptive dataset obsahuje vše výše uvedené a navíc pole pro jednotlivé události: from, to, subject, messageId, sessionId, errorDetail, ruleMatched.

Následují běžné GraphQL dotazy, které můžete použít k získání informací o analytice Email Service. Tyto dotazy používají proměnnou $zoneTag, které by mělo být nastaveno na vaše Cloudflare Zone ID. Najdete ho na řídicím panelu Cloudflare v části domény Přehled stránce.

{
	"zoneTag": "<YOUR_ZONE_ID>",
	"start": "2024-07-15",
	"end": "2024-07-30"
}

Dotaz na počet e-mailů za dané období, seskupený podle date a status (například delivered, deliveryFailed):

query EmailSendingByStatus($zoneTag: string!, $start: Date!, $end: Date!) {
	viewer {
		zones(filter: { zoneTag: $zoneTag }) {
			emailSendingAdaptiveGroups(
				filter: { date_geq: $start, date_leq: $end }
				limit: 10000
				orderBy: [date_DESC]
			) {
				count
				dimensions {
					date
					status
				}
			}
		}
	}
}

Chcete-li prozkoumat příčiny selhání doručení za konkrétní časové období, seskupené podle errorCause a sendingDomain:

query EmailDeliveryFailures($zoneTag: string!, $start: Date!, $end: Date!) {
	viewer {
		zones(filter: { zoneTag: $zoneTag }) {
			emailSendingAdaptiveGroups(
				filter: { date_geq: $start, date_leq: $end, status: "deliveryFailed" }
				limit: 10000
				orderBy: [date_DESC]
			) {
				count
				dimensions {
					date
					errorCause
					sendingDomain
				}
			}
		}
	}
}

Dotaz na objem odeslaných e-mailů seskupený podle hodiny, užitečný pro identifikaci vzorců provozu:

query EmailSendingHourlyVolume($zoneTag: string!, $start: Time!, $end: Time!) {
	viewer {
		zones(filter: { zoneTag: $zoneTag }) {
			emailSendingAdaptiveGroups(
				filter: { datetimeHour_geq: $start, datetimeHour_leq: $end }
				limit: 10000
				orderBy: [datetimeHour_ASC]
			) {
				count
				dimensions {
					datetimeHour
					status
				}
			}
		}
	}
}

Dotaz na jednotlivé e-mailové události pro řešení konkrétních problémů s doručením. Používá se přitom emailSendingAdaptive dataset a filtruje podle datetime (typ Time):

query RecentEmailEvents($zoneTag: string!, $start: Time!, $end: Time!) {
	viewer {
		zones(filter: { zoneTag: $zoneTag }) {
			emailSendingAdaptive(
				filter: { datetime_geq: $start, datetime_leq: $end }
				limit: 50
				orderBy: [datetime_DESC]
			) {
				datetime
				from
				to
				subject
				status
				eventType
				sendingDomain
				messageId
				errorCause
				errorDetail
				dkim
				dmarc
				spf
				isSpam
			}
		}
	}
}

Dotaz na počet směrovaných e-mailů za dané období, seskupený podle date a status:

query EmailRoutingByStatus($zoneTag: string!, $start: Date!, $end: Date!) {
	viewer {
		zones(filter: { zoneTag: $zoneTag }) {
			emailRoutingAdaptiveGroups(
				filter: { date_geq: $start, date_leq: $end }
				limit: 10000
				orderBy: [date_DESC]
			) {
				count
				dimensions {
					date
					status
				}
			}
		}
	}
}

Chcete-li zjistit, která směrovací pravidla se shodují s e-maily, seskupená podle ruleMatched a action:

query EmailRoutingRuleActivity($zoneTag: string!, $start: Date!, $end: Date!) {
	viewer {
		zones(filter: { zoneTag: $zoneTag }) {
			emailRoutingAdaptiveGroups(
				filter: { date_geq: $start, date_leq: $end }
				limit: 10000
				orderBy: [date_DESC]
			) {
				count
				dimensions {
					date
					ruleMatched
					action
				}
			}
		}
	}
}

Dotaz na jednotlivé směrovací události pro účely řešení problémů:

query RecentRoutingEvents($zoneTag: string!, $start: Time!, $end: Time!) {
	viewer {
		zones(filter: { zoneTag: $zoneTag }) {
			emailRoutingAdaptive(
				filter: { datetime_geq: $start, datetime_leq: $end }
				limit: 50
				orderBy: [datetime_DESC]
			) {
				datetime
				from
				to
				subject
				status
				action
				ruleMatched
				messageId
				errorDetail
				dkim
				dmarc
				spf
				isSpam
			}
		}
	}
}

• E-mailové protokoly : zobrazení jednotlivé e-mailové aktivity v dashboardu.
• Protokoly auditu : sledování změn konfigurace.
• GraphQL Analytics API : úplná reference GraphQL API.