本文へ移動
Telemetry
データベースの信頼性 SQL レシピ

SQLSTATEとリリースによるデータベースエラーの分析

データベースの障害をポータブル SQLSTATE クラス、アプリケーション操作、リリースごとにグループ化します。

初心者database_error_eventsレビュー済み 2026-07-28テスト済み アパッチ DataFusion 45.2.0

レビュー者 Telemetry 製品チーム . SQL の互換性、イベント コントラクト、合成出力、および操作上の注意事項. 基準と所有権を確認する

質問に回答しました

アプリケーションのリリース後に増加したデータベース エラー クラスはどれですか?

生のエラー メッセージは不安定であり、機密値が含まれている可能性があります。 SQLSTATE と制御された操作名により、リリースの比較と正しい所有者へのルーティングがサポートされます。

イベント契約

クエリが期待するフィールド

フィールド種類なぜ存在するのか
timestamp_utcTimestampデータベース障害時間。
database_systemUtf8データベースシステム。
operation_nameUtf8アプリケーションの動作を制御します。
sqlstateUtf8移植可能な SQLSTATE コード (利用可能な場合)。
releaseUtf8アプリケーションのリリース。
request_idUtf8安全な親リクエストの識別子。
DataFusion SQL

クエリをコピーする

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;

この読み取り専用クエリは、空の型付きテーブルに対して計画され、実行されます。 アパッチ DataFusion 45.2.0。決定論的なサンプル出力は合成され、個別にレビューされます。フィールド タイプ、しきい値、ビジネス定義を独自のデータと照合して検証します。 テスト方法を読んでください。

クエリ結果

SQLSTATEによるデータベース障害

チェックアウト時のシリアル化エラーは、リリースのデータベース エラーの大半を占めます。

database_systemreleaseoperation_namesqlstatefailuresaffected_requests
postgresqlapi-88checkout40001184176
postgresqlapi-88project-create235056262

合成出力例。運用上の決定に使用する前に、独自のイベント スキーマとしきい値に対してクエリを実行します。

Database failures by SQLSTATE: Analyze Database Errors by SQLSTATE and Release 結果例からの合成 failures 値の静的チャート
決定論的な出力例のインデックス可能な SVG。記事、ランブック、または出典を明示した設計レビューのためにダウンロードしてください。

例を再現する

パブリックフィクスチャをダウンロードする

JSON バンドルには、型付きイベント コントラクトが含まれています。 illustrative 入力行、正確な SQL、予想される出力、レビューメモ、およびエンジンのバージョン。 CSV には、表示された結果が含まれます。

SQL の仕組み

  1. 1SQLSTATE は、生のエラー文字列をグループ化するよりも安全で安定しています。
  2. 2オペレーション名はアプリケーションの所有権を保持します。
  3. 3個別のリクエストにより、顧客への影響が推定されます。

決定すべきエッジケース

  • すべてのドライバーが一貫して SQLSTATE を公開するわけではありません。
  • 同じ SQLSTATE でも原因が異なる場合があります。
  • 完全なステートメント値やサーバー メッセージではなく、サニタイズされたエラー カテゴリを保存します。

推奨されるダッシュボード

  • バー: SQLSTATE による失敗
  • 傾向: リリースごとの障害
  • 表: 影響を受ける操作とリクエスト数

アラートガイダンス

リリース後の新しい大量の SQLSTATE、または接続障害などの既知のクリティカル クラスに関するアラート。

アラート設定を読む

レシピを活用する

関連する機器とガイド

分析を続ける

実際のイベントで実行する

テーブルを作成し、フィールドを調整して、結果を保存します

無料で始めて、構造化されたイベントを送信し、クエリ結果をグラフ、共有ダッシュボード ウィジェット、またはアラート入力として使用します。

API キーを取得する