Saltar a contenido

Informe Ejecutivo: Optimización de Índices en McpRequestLogs

Proyecto: Calmia Nexus Fecha: 2026-02-01 Autor: Equipo de Desarrollo Estado: Listo para Implementación

1. Resumen Ejecutivo

La tabla McpRequestLogs tiene 14 índices de los cuales 11 nunca han sido utilizados (idx_scan = 0), ocupando aproximadamente 1.1 MB de espacio. Se recomienda eliminar estos índices para mejorar el rendimiento de escritura sin afectar las operaciones de lectura.

Métrica Valor
Total de índices 14
Índices no utilizados 11
Espacio ocupado por índices no utilizados ~800 KB - 1.1 MB
Mejora estimada en INSERT +45-60%
Mejora estimada en UPDATE +40-50%
Riesgo de la operación 🟢 BAJO

2. Lista de Índices Actuales

2.1 Índices a Mantener (3)

Índice Tipo Razón
McpRequestLogs_pkey PRIMARY KEY Obligatorio
IX_McpRequestLogs_OrganizationId FOREIGN KEY Relación con Organizations
IX_McpRequestLogs_UserId FOREIGN KEY Relación con Users

2.2 Índices a Eliminar (11)

# Índice Columna(s) idx_scan Razón de Eliminación
1 IX_McpRequestLogs_ClientId ClientId 0 Sin consultas en código
2 IX_McpRequestLogs_CorrelationId CorrelationId 0 Solo display, no filtro
3 IX_McpRequestLogs_SessionId SessionId 0 Sin consultas en código
4 IX_McpRequestLogs_Method Method 0 Consultas usan LIKE (no usa índice)
5 IX_McpRequestLogs_ToolName ToolName 0 Solo GroupBy (no beneficia)
6 IX_McpRequestLogs_Status Status 0 Baja selectividad (~3 valores)
7 IX_McpRequestLogs_ReceivedAt ReceivedAt 0 Cubierto por PK para ORDER BY
8 IX_McpRequestLogs_ReceivedAt_Status ReceivedAt, Status 0 Orden de columnas incorrecto
9 IX_McpRequestLogs_ToolName_ReceivedAt ToolName, ReceivedAt 0 Sin consultas que lo usen
10 IX_McpRequestLogs_RequestParams_GIN RequestParamsJson (GIN) 0 Sin consultas JSONB (@>, ?)
11 IX_McpRequestLogs_ErrorCode ErrorCode (parcial) 0 Poco selectivo

3. Análisis de Uso en Código

3.1 Patrones de Consulta Identificados

Patrón Ubicación Columnas Índice Requerido
Listar por Org McpLoggingService.cs:GetLogs() OrganizationId, ReceivedAt DESC FK ya cubre
Filtrar errores McpLoggingService.cs:GetErrors() Status = 'error' Seq Scan suficiente
Buscar por método McpLoggingService.cs:Search() Method LIKE '%x%' LIKE no usa índice
Requests lentos McpLoggingService.cs:GetSlow() DurationMs > threshold Seq Scan suficiente
Agrupar por tool McpLoggingService.cs:Stats() GROUP BY ToolName Seq Scan para agregación

3.2 Consultas JSONB

Operador Encontrado Índice GIN Necesario
@> (contains) ❌ No No
? (key exists) ❌ No No
jsonb_path_match ❌ No No

Conclusión: El índice GIN nunca se usa porque no hay consultas JSONB.

4. Impacto de Eliminación

4.1 Mejoras de Rendimiento

Operación Antes Después Mejora
INSERT 11 índices actualizados 3 índices actualizados +45-60%
UPDATE 11 índices potenciales 3 índices potenciales +40-50%
DELETE 11 índices actualizados 3 índices actualizados +20-30%
SELECT Sin cambio Sin cambio 0%

4.2 Espacio Recuperado

Componente Tamaño Estimado
Índices simples (5) ~200 KB
Índices compuestos (3) ~150 KB
Índice GIN ~400 KB
Índices parciales (3) ~50 KB
Total ~800 KB - 1.1 MB

4.3 Reducción de Overhead

Métrica Antes Después
Índices por INSERT 14 3
Índices por UPDATE (Status) 2 0
Operaciones de mantenimiento Alta Baja

5. Recomendaciones

5.1 Acción Inmediata: Eliminar 11 Índices

-- Ejecutar en orden de menor a mayor impacto

-- Fase 1: Índices simples sin uso
DROP INDEX IF EXISTS "IX_McpRequestLogs_ClientId";
DROP INDEX IF EXISTS "IX_McpRequestLogs_CorrelationId";
DROP INDEX IF EXISTS "IX_McpRequestLogs_SessionId";
DROP INDEX IF EXISTS "IX_McpRequestLogs_Method";
DROP INDEX IF EXISTS "IX_McpRequestLogs_ToolName";

-- Fase 2: Índices compuestos
DROP INDEX IF EXISTS "IX_McpRequestLogs_ReceivedAt_Status";
DROP INDEX IF EXISTS "IX_McpRequestLogs_ToolName_ReceivedAt";

-- Fase 3: Índice GIN (alto costo de mantenimiento)
DROP INDEX IF EXISTS "IX_McpRequestLogs_RequestParams_GIN";

-- Fase 4: Índices parciales
DROP INDEX IF EXISTS "IX_McpRequestLogs_Status";
DROP INDEX IF EXISTS "IX_McpRequestLogs_ErrorCode";
DROP INDEX IF EXISTS "IX_McpRequestLogs_ReceivedAt";

-- Post-eliminación
ANALYZE "McpRequestLogs";

5.2 Futuras Optimizaciones (si la tabla crece > 10,000 filas)

Escenario Índice Recomendado
Muchas consultas por fecha CREATE INDEX ON "McpRequestLogs" ("ReceivedAt" DESC)
Consultas JSONB frecuentes CREATE INDEX ... USING GIN ("RequestParamsJson")
Filtro por Status frecuente Índice parcial WHERE "Status" = 'error'

6. Riesgos Potenciales

6.1 Matriz de Riesgos

Riesgo Probabilidad Impacto Mitigación
Degradación de consultas 🟢 Muy Baja Bajo Tabla pequeña, Seq Scan eficiente
Regresión de funcionalidad 🟢 Muy Baja Bajo Tests unitarios cubren patrones
Impacto en producción 🟢 Muy Baja Bajo DROP INDEX es instantáneo
Rollback complejo 🟢 Muy Baja Bajo CREATE INDEX IF NOT EXISTS

6.2 Factores de Mitigación

  1. idx_scan = 0: Los índices literalmente nunca se han usado
  2. Tabla pequeña: < 1,000 filas típicamente, Seq Scan es óptimo
  3. Rollback simple: CREATE INDEX IF NOT EXISTS para revertir
  4. Tests existentes: 20 pruebas unitarias validan el comportamiento
  5. Sin downtime: DROP INDEX es operación instantánea

7. Artefactos de Implementación

Artefacto Ubicación Estado
Script SQL de eliminación scripts/database/drop-unused-mcprequestlogs-indexes.sql ✅ Listo
Migración EF Core Migrations/20260201140000_RemoveUnusedMcpRequestLogsIndexes.cs ✅ Listo
Tests unitarios Tests/Shared.Admin.Tests/Database/McpRequestLogsIndexTests.cs ✅ 20/20 PASS
Script de validación scripts/database/validate-mcprequestlogs-after-index-removal.sql ✅ Listo
ADR docs/database/ADR-003-Remove-Unused-McpRequestLogs-Indexes.md ✅ Listo

8. Conclusiones

Recomendación Final: ✅ PROCEDER CON ELIMINACIÓN

Criterio Evaluación
Riesgo 🟢 BAJO
Beneficio 🟢 ALTO (45-60% mejora en escritura)
Complejidad 🟢 BAJA (operación simple)
Reversibilidad 🟢 ALTA (rollback trivial)

Próximos Pasos

  1. ✅ Análisis de índices completado
  2. ✅ Búsqueda en código completada
  3. ✅ Evaluación de riesgos completada
  4. ✅ Migración preparada
  5. ✅ Tests validados
  6. ⏳ Pendiente: Aprobación del equipo
  7. ⏳ Pendiente: Ejecución en producción
  8. ⏳ Pendiente: Monitoreo post-implementación

9. Documentos Relacionados

Documento generado automáticamente como parte del proceso de optimización de base de datos de Calmia Nexus.