메뉴
Implements structured logging and configures Serilog sinks for VanDaemon. Use when: Adding logging to services, configuring log sinks, debugging with structured data, setting up log enrichment.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
Builds REST APIs, SignalR hubs, and ASP.NET Core Web API applications. Use when: Creating controllers, configuring middleware, setting up dependency injection, implementing background services, or working with the API layer.
Develops Blazor WebAssembly single-page applications with component-based UI. Use when: Creating/modifying .razor components, managing component state, handling SignalR subscriptions, or working with MudBlazor UI components.
Writes C# code following VanDaemon conventions and clean architecture patterns Use when: Creating services, entities, controllers, or plugins in the VanDaemon codebase
Configures containerization with Docker and Docker Compose for VanDaemon. Use when: building containers, configuring docker-compose, deploying to Docker environments, troubleshooting container networking, or setting up multi-container applications.
Configures .NET 10 projects, builds, and manages C# runtime. Use when: building/running the solution, adding projects, managing NuGet packages, configuring Docker containers, or troubleshooting build issues.
Writes fluent, readable test assertions and validations using FluentAssertions library. Use when: Writing unit tests, validating service responses, asserting domain entity states, testing collections and async operations.
| name | serilog |
| description | Implements structured logging and configures Serilog sinks for VanDaemon. Use when: Adding logging to services, configuring log sinks, debugging with structured data, setting up log enrichment. |
| allowed-tools | Read, Edit, Write, Glob, Grep, Bash |
VanDaemon uses Serilog 8.x for structured logging with console and file sinks. Logs use semantic message templates with named properties for queryability. The API layer configures Serilog in Program.cs with rolling file output to logs/vandaemon-{Date}.txt.
// Inject ILogger<T> via constructor
private readonly ILogger<TankService> _logger;
public TankService(ILogger<TankService> logger)
{
_logger = logger;
}
// Use semantic message templates - property names in braces
_logger.LogInformation("Tank {TankId} updated to {Level}%", tankId, level);
_logger.LogWarning("Tank {TankName} below threshold: {CurrentLevel}% < {Threshold}%",
tank.Name, tank.CurrentLevel, tank.AlertLevel);
try
{
await plugin.SetStateAsync(controlId, state, ct);
}
catch (Exception ex)
{
// Exception as FIRST parameter, then message template
_logger.LogError(ex, "Failed to set state for control {ControlId}", controlId);
throw;
}
| Concept | Usage | Example |
|---|---|---|
| Message Template | Named placeholders for structured data | "Processing {TankId}" |
| Log Level | Severity filtering | LogInformation, LogWarning, LogError |
| Enrichment | Automatic context properties | Enrich.FromLogContext() |
| Sink | Output destination | Console, File, Seq |
When: Logging business operations with context
public async Task<Tank> UpdateTankAsync(Tank tank, CancellationToken ct)
{
_logger.LogDebug("Updating tank {TankId}: {TankName}", tank.Id, tank.Name);
// Business logic...
_logger.LogInformation("Tank {TankId} saved successfully", tank.Id);
return tank;
}
When: Tracking plugin initialization and disposal
public async Task InitializeAsync(Dictionary<string, object> config, CancellationToken ct)
{
_logger.LogInformation("Initializing {PluginName} v{Version}", Name, Version);
if (!config.TryGetValue("MqttBroker", out var broker))
{
_logger.LogWarning("{PluginName} missing MqttBroker config, using default", Name);
}
}