К основному содержанию
скилл CX Codex

net-observability — скилл для Claude Code

Скилл net-observability для настройки enterprise observability в ASP.NET Core: структурированное логирование через Serilog, распределённый трейсинг с OpenTelemetry, метрики Prometheus и health checks для Kubernetes.

MIT 1 установок ★ 186 обновлён 2026-02-02

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add mitkox/ai-coding-factory --skill net-observability -a claude-code
Открыть на GitHub

Что делает net-observability

Скилл генерирует полный стек observability для .NET-приложений. Включает конфигурацию Serilog с обогащением логов (машина, окружение, потоки), настройку OpenTelemetry для трейсинга HTTP-запросов и вызовов Entity Framework, экспорт метрик в Prometheus и Jaeger. Добавляет middleware для отслеживания корреляционных ID через заголовок X-Correlation-Id, чтобы связать логи одного запроса во всех сервисах.

В состав входит health check для liveness и readiness проб (проверяет базу данных, Redis и статус приложения), готовые для Kubernetes. Генерирует примеры пользовательских метрик через System.Diagnostics.Metrics — счётчики запросов и гистограммы длительности. Требует установки пакетов Serilog.AspNetCore, OpenTelemetry и их расширений; весь код следует .NET 8 best practices.

Пригодится при подготовке приложения к production: нужны логи, трейсинг и метрики. Работает с ASP.NET Core, совместим с Docker и Kubernetes.

Какие задачи решает

  • настроить структурированное логирование в ASP.NET Core
  • добавить распределённый трейсинг для микросервисов
  • собрать метрики приложения для Prometheus
  • реализовать health checks для orchestration
  • отслеживать запросы через корреляционные ID

Примеры запросов агенту

  • Установи net-observability в проект и настрой Serilog с обогащением логов
  • Добавь OpenTelemetry для трейсинга HTTP-запросов и экспорта в Jaeger
  • Реализуй health checks для базы данных и готовых проб Kubernetes

Как установить net-observability

1Через Skills CLI (Vercel)

npx skills add mitkox/ai-coding-factory --skill net-observability -a claude-code

2Вручную: положить файлы

~/.claude/skills/net-observability/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/net-observability/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о net-observability

Как установить net-observability в Claude Code?

Запусти npx skills add mitkox/ai-coding-factory --skill net-observability -a claude-code, затем открой ~/.claude/skills/net-observability/SKILL.md.

Что делает скилл net-observability?

Генерирует конфигурацию для логирования (Serilog), распределённого трейсинга (OpenTelemetry), метрик (Prometheus) и health checks. Добавляет middleware для отслеживания корреляционных ID и примеры пользовательских метрик.

Какие пакеты нужны для работы?

Требуются Serilog.AspNetCore, OpenTelemetry, OpenTelemetry.Exporter.Jaeger и расширения для ASP.NET Core. Все версии указаны в исходниках скилла.

Исходный текст

SKILL.md · MIT
---
name: net-observability
description: Implement observability patterns with OpenTelemetry, structured logging, and distributed tracing
license: MIT
compatibility: opencode
metadata:
  audience: .net-developers
  framework: aspnetcore
  patterns: opentelemetry, serilog, metrics
---

## What I Do

I help you implement enterprise observability patterns:
- Structured logging with Serilog
- Distributed tracing with OpenTelemetry
- Metrics collection with Prometheus
- Health checks for Kubernetes
- Correlation IDs for request tracking
- Application Performance Monitoring (APM)

## When to Use Me

Use this skill when:
- Setting up logging infrastructure
- Implementing distributed tracing
- Adding metrics and monitoring
- Configuring health checks
- Preparing for production deployment

## Packages Required

```xml
<PackageReference Include="Serilog.AspNetCore" Version="8.0.0" />
<PackageReference Include="Serilog.Sinks.Console" Version="5.0.1" />
<PackageReference Include="Serilog.Sinks.Seq" Version="6.0.0" />
<PackageReference Include="Serilog.Enrichers.Environment" Version="2.3.0" />
<PackageReference Include="Serilog.Enrichers.Thread" Version="3.1.0" />
<PackageReference Include="OpenTelemetry" Version="1.7.0" />
<PackageReference Include="OpenTelemetry.Extensions.Hosting" Version="1.7.0" />
<PackageReference Include="OpenTelemetry.Instrumentation.AspNetCore" Version="1.7.0" />
<PackageReference Include="OpenTelemetry.Instrumentation.Http" Version="1.7.0" />
<PackageReference Include="OpenTelemetry.Exporter.Prometheus.AspNetCore" Version="1.7.0-rc.1" />
<PackageReference Include="OpenTelemetry.Exporter.Jaeger" Version="1.5.1" />
```

## Serilog Configuration

### Program.cs Setup
```csharp
using Serilog;

var builder = WebApplication.CreateBuilder(args);

// Configure Serilog
builder.Host.UseSerilog((context, loggerConfiguration) =>
{
    loggerConfiguration
        .ReadFrom.Configuration(context.Configuration)
        .Enrich.FromLogContext()
        .Enrich.WithMachineName()
        .Enrich.WithEnvironmentName()
        .Enrich.WithThreadId()
        .Enrich.WithProperty("Application", "YourAppName")
        .WriteTo.Console(
            outputTemplate: "[{Timestamp:HH:mm:ss} {Level:u3}] {CorrelationId} {Message:lj} {Properties:j}{NewLine}{Exception}")
        .WriteTo.Seq("http://localhost:5341"); // Optional: Seq server
});
```

### appsettings.json
```json
{
  "Serilog": {
    "MinimumLevel": {
      "Default": "Information",
      "Override": {
        "Microsoft": "Warning",
        "Microsoft.Hosting.Lifetime": "Information",
        "Microsoft.EntityFrameworkCore": "Warning",
        "System": "Warning"
      }
    },
    "WriteTo": [
      {
        "Name": "Console",
        "Args": {
          "theme": "Serilog.Sinks.SystemConsole.Themes.AnsiConsoleTheme::Code, Serilog.Sinks.Console"
        }
      }
    ]
  }
}
```

## OpenTelemetry Configuration

### Distributed Tracing Setup
```csharp
using OpenTelemetry.Resources;
using OpenTelemetry.Trace;
using OpenTelemetry.Metrics;

builder.Services.AddOpenTelemetry()
    .ConfigureResource(resource => resource
        .AddService(serviceName: "YourServiceName", serviceVersion: "1.0.0"))
    .WithTracing(tracing => tracing
        .AddSource("YourServiceName")
        .AddAspNetCoreInstrumentation()
        .AddHttpClientInstrumentation()
        .AddEntityFrameworkCoreInstrumentation()
        .AddJaegerExporter(options =>
        {
            options.AgentHost = "localhost";
            options.AgentPort = 6831;
        }))
    .WithMetrics(metrics => metrics
        .AddAspNetCoreInstrumentation()
        .AddHttpClientInstrumentation()
        .AddRuntimeInstrumentation()
        .AddPrometheusExporter());
```

## Correlation ID Middleware

```csharp
public class CorrelationIdMiddleware
{
    private const string CorrelationIdHeader = "X-Correlation-Id";
    private readonly RequestDelegate _next;

    public CorrelationIdMiddleware(RequestDelegate next)
    {
        _next = next;
    }

    public async Task InvokeAsync(HttpContext context)
    {
        var correlationId = context.Request.Headers[CorrelationIdHeader].FirstOrDefault()
            ?? Guid.NewGuid().ToString();

        context.Items["CorrelationId"] = correlationId;
        context.Response.Headers[CorrelationIdHeader] = correlationId;

        using (LogContext.PushProperty("CorrelationId", correlationId))
        {
            await _next(context);
        }
    }
}
```

## Health Checks

```csharp
builder.Services.AddHealthChecks()
    .AddNpgSql(connectionString, name: "database", tags: new[] { "ready" })
    .AddRedis(redisConnectionString, name: "redis", tags: new[] { "ready" })
    .AddCheck("self", () => HealthCheckResult.Healthy(), tags: new[] { "live" });

// Map endpoints
app.MapHealthChecks("/health");
app.MapHealthChecks("/health/ready", new HealthCheckOptions
{
    Predicate = check => check.Tags.Contains("ready")
});
app.MapHealthChecks("/health/live", new HealthCheckOptions
{
    Predicate = check => check.Tags.Contains("live")
});
```

## Custom Metrics

```csharp
using System.Diagnostics.Metrics;

public class ApplicationMetrics
{
    private readonly Counter<long> _requestCounter;
    private readonly Histogram<double> _requestDuration;
    
    public ApplicationMetrics(IMeterFactory meterFactory)
    {
        var meter = meterFactory.Create("YourApp.Metrics");
        
        _requestCounter = meter.CreateCounter<long>(
            "app.requests.total",
            description: "Total number of requests");
            
        _requestDuration = meter.CreateHistogram<double>(
            "app.requests.duration",
            unit: "ms",
            description: "Request duration in milliseconds");
    }
    
    public void RecordRequest(string endpoint, long durationMs)
    {
        _requestCounter.Add(1, new KeyValuePair<string, object?>("endpoint", endpoint));
        _requestDuration.Record(durationMs, new KeyValuePair<string, object?>("endpoint", endpoint));
    }
}
```

## Best Practices

1. **Structured Logging**: Always use structured logging with properties
2. **Correlation IDs**: Propagate correlation IDs across services
3. **Log Levels**: Use appropriate log levels (Debug, Information, Warning, Error, Critical)
4. **Sensitive Data**: Never log sensitive data (passwords, tokens, PII)
5. **Performance**: Be mindful of logging overhead in hot paths
6. **Health Checks**: Implement both liveness and readiness probes
7. **Metrics**: Track business and technical metrics separately

## Example Usage

```
Use net-observability skill to:

1. Set up Serilog with structured logging
2. Add OpenTelemetry distributed tracing
3. Configure Prometheus metrics
4. Implement health checks for Kubernetes
5. Add correlation ID tracking
```

I will generate complete observability infrastructure following .NET 8 best practices.

© mitkox · MIT · mitkox/ai-coding-factory

Похожие скиллы

Все скиллы по теме «Бэкенд и API» →
logging-observability wshaddix Скилл logging-observability настраивает структурированные логи, корреляцию запросов и журналирование HTTP в ASP.NET Core Razor Pages. Нужен при сборке наблюдаемости приложения. CX Codex +1 550установок monitoring-observability travisjneuman Скилл monitoring-observability помогает внедрить OpenTelemetry, структурированные логи и трейсинг в микросервисах. Он пригодится при настройке алертов по SLO и отладке распределённых систем. CX Codex +1 146установок opentelemetry-net-instrumentation Aaronontheweb Скилл opentelemetry-net-instrumentation для Claude Code расставляет трассировку, метрики и логи в .NET-коде по спецификации OpenTelemetry. Покрывает телеметрией библиотеку или приложение. CX Codex +1 442установок observability-monitoring aiskillstore Скилл observability-monitoring для Claude Code задаёт шаблоны структурированных логов, метрик RED, трассировки OpenTelemetry и алертов Prometheus для наблюдаемости бекенда. CX Codex +1 1установок Observability taste f Промпт Observability taste для ChatGPT задаёт правила инструментирования и мониторинга сервисов. Он помогает спроектировать логи, метрики, трассировки и оповещения. GP ChatGPT ★ 178 201звёзд репо python-observability Seth Hobson Скилл python-observability для Claude Code: настраивает структурные логи, метрики Prometheus и распределённый трейсинг в Python-проектах. Помогает разобраться в проблемах боевых систем через корреляцию логов, метрик и трейсов. CX Codex +1 11 547установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой