loggerStart

Start a real-time logger session for a domain. Connects to the Cloudflare Worker tail WebSocket and begins buffering log messages. Use loggerMessages to read the buffered messages and loggerStop to end the session.

The session automatically closes after 5 minutes. Call loggerStart again to reconnect.

Parameters

Parameter	Type	Required	Description
domainId	string (UUID)	Yes	The domain ID (tagId). Get this from the domains tool.
teamId	string (UUID)	Yes	The team ID the domain belongs to.
status	enum	No	Filter by status: ok for successful events, exception for errors. Omit for all.
events	array of strings	No	Filter by event names. Common values: PageView, ViewContent, AddToCart, RemoveFromCart, InitiateCheckout, AddShippingInfo, AddPaymentInfo, Purchase, Subscribe, Search, Lead.
path	enum	No	Filter by API endpoint: init, tag, data, user, audience, consent, load, providers/webhook.
method	enum	No	Filter by HTTP method: POST or GET.

Output

Confirms the logger session has started. Use loggerMessages to read the actual log entries.

Example

"Start streaming live logs for my store, only Purchase events"

The AI assistant will call loggerStart with events: ["Purchase"] and then poll loggerMessages to show real-time purchase events.