sentry_capture_session
Capture session data for application monitoring by recording session identifiers, user activity, duration, and error counts to track performance and health.
Instructions
Manually capture a session for server-mode/request-mode
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sessionId | Yes | Unique session identifier | |
| distinctId | No | User identifier | |
| status | No | Session status | ok |
| duration | No | Session duration in seconds | |
| errors | No | Number of errors in session |
Implementation Reference
- src/index.ts:966-999 (handler)The handler function for the 'sentry_capture_session' tool. It extracts parameters, constructs session data, adds a breadcrumb to Sentry for monitoring, and returns a confirmation message.case "sentry_capture_session": { const { sessionId, distinctId, status = "ok", duration, errors = 0 } = args as any; // Capture session data manually (useful for server-mode) const sessionData = { sid: sessionId, did: distinctId, status, duration, errors, timestamp: Date.now() / 1000, attrs: { release: config.release, environment: config.environment || "production", }, }; // Log session for monitoring Sentry.addBreadcrumb({ category: "session", message: `Session ${sessionId} captured`, level: "info", data: sessionData, }); return { content: [ { type: "text", text: `Session captured: ${sessionId} (status: ${status}, duration: ${duration}s, errors: ${errors})`, }, ], }; }
- src/index.ts:355-387 (schema)The input schema definition for the 'sentry_capture_session' tool, defining parameters like sessionId, distinctId, status, duration, and errors.{ name: "sentry_capture_session", description: "Manually capture a session for server-mode/request-mode", inputSchema: { type: "object", properties: { sessionId: { type: "string", description: "Unique session identifier", }, distinctId: { type: "string", description: "User identifier", }, status: { type: "string", enum: ["ok", "exited", "crashed", "abnormal", "errored"], description: "Session status", default: "ok", }, duration: { type: "number", description: "Session duration in seconds", }, errors: { type: "number", description: "Number of errors in session", default: 0, }, }, required: ["sessionId"], }, },
- src/index.ts:355-387 (registration)Registration of the 'sentry_capture_session' tool in the ListTools response, including name, description, and schema.{ name: "sentry_capture_session", description: "Manually capture a session for server-mode/request-mode", inputSchema: { type: "object", properties: { sessionId: { type: "string", description: "Unique session identifier", }, distinctId: { type: "string", description: "User identifier", }, status: { type: "string", enum: ["ok", "exited", "crashed", "abnormal", "errored"], description: "Session status", default: "ok", }, duration: { type: "number", description: "Session duration in seconds", }, errors: { type: "number", description: "Number of errors in session", default: 0, }, }, required: ["sessionId"], }, },