# 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.