WorkflowForge.Extensions.Observability.Performance 1.0.1

WorkflowForge.Extensions.Observability.Performance

Comprehensive performance monitoring extension for WorkflowForge with detailed metrics and analytics.

Installation

dotnet add package WorkflowForge.Extensions.Observability.Performance

Quick Start

using WorkflowForge.Extensions.Observability.Performance;

// Enable performance monitoring
var foundryConfig = FoundryConfiguration.ForProduction()
    .EnablePerformanceMonitoring();

var foundry = WorkflowForge.CreateFoundry("MyWorkflow", foundryConfig);

// Execute workflows (multiple times for meaningful statistics)
var smith = WorkflowForge.CreateSmith();
await smith.ForgeAsync(workflow, foundry);

// Access performance statistics
var stats = foundry.GetPerformanceStatistics();
Console.WriteLine($"Success Rate: {stats.SuccessRate:P2}");
Console.WriteLine($"Average Duration: {stats.AverageDuration}ms");
Console.WriteLine($"Operations/sec: {stats.OperationsPerSecond:F2}");

Key Features

• Foundry Performance Statistics: Comprehensive workflow execution metrics
• Operation-level Metrics: Detailed statistics for individual operations
• Real-time Monitoring: Live performance data collection and reporting
• Memory Efficient: Property-based storage without interface pollution
• Detailed Analytics: Success rates, timing, memory usage, error patterns

Performance Metrics

Foundry-Level Metrics

var stats = foundry.GetPerformanceStatistics();

// Execution Statistics
Console.WriteLine($"Total Operations: {stats.TotalOperations}");
Console.WriteLine($"Success Rate: {stats.SuccessRate:P2}");
Console.WriteLine($"Operations per Second: {stats.OperationsPerSecond:F2}");

// Timing Statistics
Console.WriteLine($"Average Duration: {stats.AverageDuration}ms");
Console.WriteLine($"95th Percentile: {stats.GetPercentile(95)}ms");

// Memory Statistics
Console.WriteLine($"Memory per Operation: {stats.AverageMemoryPerOperation / 1024:F2} KB");

Operation-Level Metrics

foreach (var opStats in stats.GetAllOperationStatistics())
{
    Console.WriteLine($"Operation '{opStats.OperationName}': {opStats.SuccessRate:P2} success, {opStats.AverageExecutionTime}ms avg");
}

Environment Configurations

// Development - detailed monitoring
var devConfig = FoundryConfiguration.ForDevelopment()
    .EnablePerformanceMonitoring(options =>
    {
        options.EnableDetailedOperationStats = true;
        options.EnableMemoryTracking = true;
        options.SampleRate = 1.0; // Monitor everything
    });

// Production - optimized monitoring
var prodConfig = FoundryConfiguration.ForProduction()
    .EnablePerformanceMonitoring(options =>
    {
        options.SampleRate = 0.1; // Sample 10% for performance
        options.EnableMemoryTracking = false;
    });

Examples & Documentation

• Complete Examples - Interactive performance monitoring samples
• Core Documentation - Core concepts
• Benchmark Results - Performance benchmarks
• Main README - Framework overview

Comprehensive performance monitoring for workflows