Skip to content

Integration MySqlConnector Extension

Aryeh Citron edited this page Apr 29, 2026 · 5 revisions

The TestTrackingDiagrams.Extensions.MySqlConnector package adds MySQL operation tracking to your test diagrams via MySqlConnector's built-in DiagnosticSource instrumentation. No production code changes required.

Zero production changes. MySqlConnector emits diagnostic events automatically. This extension subscribes to them globally.


How It Works

MySqlConnector publishes DiagnosticSource events under "MySqlConnector". The MySqlDiagnosticTracker subscribes and correlates command execution events by ExecutionId GUID, classifies operations via UnifiedSqlClassifier, and logs to RequestResponseLogger.


Install

dotnet add package TestTrackingDiagrams.Extensions.MySqlConnector

Setup

Option A — Dependency Injection

services.AddMySqlTestTracking(options =>
{
    options.Verbosity = SqlTrackingVerbosityLevel.Detailed;
});

Option B — Static (No DI)

MySqlTestTracking.EnsureTracking(new MySqlTrackingOptions
{
    Verbosity = SqlTrackingVerbosityLevel.Detailed
});

// In teardown:
MySqlTestTracking.Reset();

Configuration

Property Default Description
ServiceName "MySQL" Participant name in diagrams
Verbosity Detailed Raw, Detailed, or Summarised
LogSqlText false Include full SQL text in Detailed mode
LogParameters false Include parameter values
DependencyCategory "MySQL" Controls participant shape/colour
UriScheme "mysql" URI scheme in diagram URIs

All options inherit from SqlTrackingOptionsBase.


Verbosity Levels

Level Arrow label URI
Raw Full SQL text mysql://host/database
Detailed SELECT FROM Users mysql://host/database/Users
Summarised SELECT mysql:///database/Users

Home


Demo


Getting Started

Common Tasks

Integration Guides

Extensions

Configuration

Features

Reference

Clone this wiki locally