Function captureMcpShutdownSummary

src/utils/sentry.ts:399–447

(summary: McpShutdownSummaryEvent)

}

export function captureMcpShutdownSummary(summary: McpShutdownSummaryEvent): void {
  if (!initialized || isSentryDisabled() || isTestEnv() || isSentryCaptureSealed()) {
    return;
  }

  try {
    const snapshotAnomalies = (summary.snapshot as { anomalies?: unknown }).anomalies;
    const PEER_ANOMALIES: ReadonlySet<string> = new Set(['peer-count-high', 'peer-age-high']);
    const localAnomalyCount = Array.isArray(snapshotAnomalies)
      ? snapshotAnomalies.filter((a) => typeof a === 'string' && !PEER_ANOMALIES.has(a)).length
      : 0;

    const isCrashReason =
      summary.reason === 'startup-failure' ||
      summary.reason === 'uncaught-exception' ||
      summary.reason === 'unhandled-rejection';

    let level: 'error' | 'warning' | 'info';
    if (isCrashReason) {
      level = 'error';
    } else if (summary.shutdownStepFailureCount > 0 || localAnomalyCount > 0) {
      level = 'warning';
    } else {
      level = 'info';
    }

    Sentry.captureEvent({
      level,
      message: 'mcp.shutdown.summary',
      tags: {
        runtime: 'mcp',
        reason: sanitizeTagValue(summary.reason),
        phase: sanitizeTagValue(summary.phase),
      },
      extra: {
        exitCode: summary.exitCode,
        transportDisconnected: summary.transportDisconnected,
        triggerError: summary.triggerError,
        shutdownStepFailureCount: summary.shutdownStepFailureCount,
        cleanupDiagnosticCount: summary.cleanupDiagnosticCount,
        shutdownDurationMs: summary.shutdownDurationMs,
        snapshot: summary.snapshot,
        steps: summary.steps,
      },
    });
  } catch {
    // Shutdown summary is best effort.
  }
}

interface ToolInvocationMetric {
  toolName: string;