WebDriverBiDi.Logging 0.0.46

WebDriverBiDi.Logging

Microsoft.Extensions.Logging integration for the WebDriver BiDi .NET client library.

Overview

This package provides ILogger support for WebDriver BiDi diagnostic events, enabling you to capture WebDriver BiDi EventSource events through the standard .NET logging infrastructure.

Installation

dotnet add package WebDriverBiDi.Logging

Quick Start

using Microsoft.Extensions.Logging;
using Microsoft.Extensions.DependencyInjection;
using WebDriverBiDi;

// Configure logging with WebDriverBiDi events
var services = new ServiceCollection();
services.AddLogging(builder =>
{
    builder.AddConsole();
    builder.AddWebDriverBiDi(); // Add WebDriverBiDi event logging
});

var serviceProvider = services.BuildServiceProvider();

// Use WebDriverBiDi normally - events will be logged
await using var driver = new BiDiDriver();
await driver.StartAsync("ws://localhost:9222");

Configuration

Default Configuration

By default, events at EventLevel.Informational and above are captured:

builder.AddLogging(b => b.AddWebDriverBiDi());

Custom Event Level

Specify a minimum event level to capture:

using System.Diagnostics.Tracing;

builder.AddLogging(b => b.AddWebDriverBiDi(EventLevel.Verbose)); // Capture all events

Event Level Mapping

WebDriver BiDi EventSource levels are mapped to ILogger levels as follows:

Structured Logging

Events are logged with structured properties, enabling rich filtering and querying:

// Example log output with structured properties:
// Information: CommandCompleted, commandId=1, method=session.status, elapsedMilliseconds=42

Structured logging providers (Application Insights, Serilog, etc.) can capture these properties for powerful diagnostics.

Filtering

Use standard ILogger filtering to control which events are logged:

services.AddLogging(builder =>
{
    builder.AddConsole();
    builder.AddWebDriverBiDi();
    builder.AddFilter("WebDriverBiDi.Logging", LogLevel.Information); // Only Info and above
});

Or use configuration:

{
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "WebDriverBiDi.Logging": "Debug"
    }
  }
}

Usage Examples

ASP.NET Core

var builder = WebApplication.CreateBuilder(args);
builder.Logging.AddWebDriverBiDi();
var app = builder.Build();

Console Application

using Microsoft.Extensions.Logging;

using ILoggerFactory factory = LoggerFactory.Create(builder =>
{
    builder.AddConsole();
    builder.AddWebDriverBiDi(EventLevel.Verbose);
});

For comprehensive examples including Serilog, Application Insights, custom filtering, and performance monitoring, see the Observability Documentation.

Available Events

WebDriverBiDi emits events for:

• Connection lifecycle: Opening, Opened, Closing, Closed, Error
• Command execution: Sending, Completed, Timeout, Error
• Event handling: EventReceived, EventHandlerError
• Protocol processing: UnknownMessage, ProtocolError
• Transport lifecycle: Started, Stopped

See the observability documentation for complete event reference.

Performance

The EventSource bridge has minimal overhead:

• Events are only processed when logging is enabled
• Structured properties are created on-demand
• No allocations when logging is disabled
• Thread-safe and async-friendly

See Also

• WebDriverBiDi Package
• Observability Documentation
• Microsoft.Extensions.Logging Documentation