Saltar al contenido
Telemetry
Fiabilidad de la base de datos receta SQL

Analizar errores de bases de datos por SQLSTATE y versión

Agrupe las fallas de la base de datos por clase SQLSTATE portátil, operación de la aplicación y versión.

Principiantedatabase_error_eventsRevisado 2026-07-28Probado con Apache DataFusion 45.2.0

Revisado por el equipo de producto Telemetry en . Compatibilidad con SQL, contrato de eventos, resultados sintéticos y advertencias operativas. Revisar los estándares y la propiedad

Pregunta respondida

¿Qué clases de errores de bases de datos aumentaron después del lanzamiento de una aplicación?

Los mensajes de error sin formato son inestables y pueden contener valores confidenciales. SQLSTATE más un nombre de operación controlada admite la comparación de versiones y el enrutamiento al propietario correcto.

Contrato de evento

Campos que espera la consulta

CampoTipoPor que existe
timestamp_utcTimestampTiempo de falla de la base de datos.
database_systemUtf8Sistema de base de datos.
operation_nameUtf8Operación controlada de la aplicación.
sqlstateUtf8Código SQLSTATE portátil cuando esté disponible.
releaseUtf8Lanzamiento de la aplicación.
request_idUtf8Identificador de solicitud de padres seguro.
DataFusionSQL

Copiar la consulta

sql
SELECT
  database_system,
  release,
  operation_name,
  sqlstate,
  COUNT(*) AS failures,
  COUNT(DISTINCT request_id) AS affected_requests
FROM database_error_events
WHERE timestamp_utc >= now() - INTERVAL '7 days'
GROUP BY database_system, release, operation_name, sqlstate
ORDER BY failures DESC, affected_requests DESC;

Esta consulta de solo lectura se planifica y ejecuta en una tabla escrita vacía con Apache DataFusion 45.2.0. El resultado de la muestra determinista es sintético y se revisa por separado; valide tipos de campos, umbrales y definiciones comerciales con sus propios datos. Lea la metodología de prueba.

Resultado de la consulta

Fallos de base de datos por SQLSTATE

Los errores de serialización en el proceso de pago dominan los errores de la base de datos de la versión.

database_systemreleaseoperation_namesqlstatefailuresaffected_requests
postgresqlapi-88checkout40001184176
postgresqlapi-88project-create235056262

Salida de ejemplo sintético. Ejecute la consulta con su propio esquema de eventos y umbrales antes de utilizarla para decisiones operativas.

Database failures by SQLSTATE: gráfico estático de valores sintéticos de failures del resultado del ejemplo Analyze Database Errors by SQLSTATE and Release
SVG indexable de la salida del ejemplo determinista. Descárguelo para ver un artículo, un runbook o una revisión de diseño con atribución.

Reproducir el ejemplo

Descargar el accesorio público

El paquete JSON incluye el contrato de evento escrito, illustrative filas de entrada, SQL exacto, resultado esperado, notas de revisión y versión del motor. El CSV contiene el resultado mostrado.

Cómo funciona el SQL

  1. 1SQLSTATE es más seguro y estable que agrupar cadenas de error sin formato.
  2. 2El nombre de la operación conserva la propiedad de la aplicación.
  3. 3Las distintas solicitudes estiman el impacto de cara al cliente.

Casos extremos para decidir

  • No todos los controladores exponen SQLSTATE de forma consistente.
  • Un mismo SQLSTATE puede tener diferentes causas.
  • Almacene categorías de errores desinfectadas, no valores de declaraciones completos ni mensajes del servidor.

Panel recomendado

  • Barras: fallos por SQLSTATE
  • Tendencia: fracasos por lanzamiento
  • Tabla: operaciones afectadas y recuentos de solicitudes

Guía de alerta

Alerta sobre un nuevo SQLSTATE de gran volumen después del lanzamiento o una clase crítica conocida, como un error de conexión.

Leer configuración de alerta

Pon la receta a trabajar

Instrumentación y guías relacionadas.

Continuar el análisis

Ejecútelo en eventos reales.

Crea una tabla, adapta los campos y guarda el resultado.

Comience gratis, envíe eventos estructurados y utilice el resultado de la consulta como un gráfico, un widget de panel compartido o una entrada de alerta.

Obtén una clave API