Jakapil.Capture.Contracts 1.0.0

.NET 8.0 This package targets .NET 8.0. The package is compatible with this framework or higher.
There is a newer version of this package available.
See the version list below for details. 
dotnet add package Jakapil.Capture.Contracts --version 1.0.0
                    


                    

                
NuGet\Install-Package Jakapil.Capture.Contracts -Version 1.0.0
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package. 
<PackageReference Include="Jakapil.Capture.Contracts" Version="1.0.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="Jakapil.Capture.Contracts" Version="1.0.0" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="Jakapil.Capture.Contracts" />
                    


                            Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package. 
paket add Jakapil.Capture.Contracts --version 1.0.0
                    


                    

                
#r "nuget: Jakapil.Capture.Contracts, 1.0.0"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package. 
#:package Jakapil.Capture.Contracts@1.0.0
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package. 
#addin nuget:?package=Jakapil.Capture.Contracts&version=1.0.0
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=Jakapil.Capture.Contracts&version=1.0.0
                    


                            Install as a Cake Tool

Jakapil.Capture

Jakapil Capture, çalışan .NET API'lerinin HTTP trafiğini yakalayan bir ASP.NET Core middleware SDK'sıdır. Uygulamanıza tek satırlık bir middleware olarak eklenir; gelen istekleri, dönen yanıtları ve korelasyon sinyallerini arka planda, istek yolunu (request path) bloke etmeden yakalar ve bir Jakapil collector'a dışa aktarır (export).

Yakalanan trafik, Jakapil tarafında kendi kendini doğrulayan test senaryolarına dönüştürülür. Middleware üretim yükü altında güvenli olacak şekilde tasarlanmıştır: yanıt daima istemciye tamponsuz akar, capture kopyası sınırlıdır ve kuyruk backpressure altında en eski girişleri düşürür (istek hattını asla bloke etmez).

Kurulum

dotnet add package Jakapil.Capture

Kullanım

Program.cs içinde servisi kaydedin ve middleware'i pipeline'a ekleyin:

builder.Services.AddJakapilCapture(
    ingestKey: builder.Configuration["Jakapil:Capture:IngestKey"]!,
    collectorUri: "https://collector.jakapil.example");

// ...

app.UseJakapilCapture();

ingestKey sizin ingest anahtarınızdır ve collector'a X-Jakapil-Key başlığında olduğu gibi gönderilir — bu yüzden yalnızca ortam değişkeni / secret üzerinden verilmelidir, koda gömülmez. collectorUri yakalanan etkileşimlerin gönderileceği collector adresidir.

İnce ayar gerekirse Action<JakapilCaptureOptions> alan overload'ı kullanabilirsiniz:

builder.Services.AddJakapilCapture(options =>
{
    options.IngestKey = builder.Configuration["Jakapil:Capture:IngestKey"]!;
    options.CollectorUri = "https://collector.jakapil.example";
    options.SampleRate = 0.25;
});

Yapılandırma seçenekleri

Seçenek Tür Varsayılan Açıklama
Enabled bool true Ana açma/kapama anahtarı. false iken middleware saf geçiştir (passthrough).
SampleRate double 1.0 Yakalanacak isteklerin oranı, [0, 1]. 1.0 = her şeyi yakala.
CollectorUri string? null Yakalanan etkileşimlerin gönderileceği collector'ın kök adresi. Boş bırakılırsa export işçisi idle kalır.
IngestKey string? null X-Jakapil-Key başlığında collector'a gönderilen ham ingest anahtarı.
MaxInlineBodyBytes int 1048576 (1 MiB) Bu boyut ya da daha küçük gövdeler satır-içi (inline) yakalanır; daha büyükler kesilir ve Truncated işaretlenir.

Diğer ayarlar (MaxCapturedResponseBytes, StreamingContentTypes, QueueCapacity, SensitiveHeaderNames, CorrelationHeaderNames, ExportBatchMaxItems, ExportFlushIntervalSeconds) makul varsayılanlarla gelir; ayrıntılar için JakapilCaptureOptions XML doküman yorumlarına bakın.

Lisans

MIT

Product Compatible and additional computed target framework versions.
.NET net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 was computed.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

  • net10.0

    • No dependencies.

  • net8.0

    • No dependencies.

NuGet packages (1)

Showing the top 1 NuGet packages that depend on Jakapil.Capture.Contracts:

Package Downloads
Jakapil.Capture

ASP.NET Core middleware SDK that captures HTTP traffic from running .NET APIs.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
2.0.0 142 8/19/2026
1.4.0 147 8/11/2026
1.3.1 134 8/4/2026
1.2.1 128 7/29/2026
1.2.0 127 7/29/2026
1.1.0 135 7/17/2026
1.0.1 169 7/13/2026
1.0.0 138 7/13/2026