Paralax.Logging 1.0.415

There is a newer version of this package available.
See the version list below for details.
dotnet add package Paralax.Logging --version 1.0.415
                    
NuGet\Install-Package Paralax.Logging -Version 1.0.415
                    
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="Paralax.Logging" Version="1.0.415" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Paralax.Logging" Version="1.0.415" />
                    
Directory.Packages.props
<PackageReference Include="Paralax.Logging" />
                    
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 Paralax.Logging --version 1.0.415
                    
#r "nuget: Paralax.Logging, 1.0.415"
                    
#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 Paralax.Logging@1.0.415
                    
#: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=Paralax.Logging&version=1.0.415
                    
Install as a Cake Addin
#tool nuget:?package=Paralax.Logging&version=1.0.415
                    
Install as a Cake Tool

<div align="center">

Paralax Logo

Paralax Framework

.NET 9.0 Build Status NuGet Version Coverage Status

</div>


Overview

The Paralax Framework is a modern, powerful, and modular open-source .NET framework optimized for building microservice architectures. It provides essential components, including encryption, CQRS, logging, messaging, persistence, cloud integration, and HTTP services. Paralax is optimized for .NET 9.0 and integrates seamlessly into cloud-native environments, making it ideal for scalable and resilient distributed systems.

Whether you’re building microservices from scratch or extending existing services, Paralax offers a comprehensive toolkit that is both flexible and easy to integrate.


Key Features

  • Modular and Extensible: Tailor your microservices by using only the components you need.
  • Security-First: Offers encryption, hashing, signing, and secrets management out of the box.
  • Advanced CQRS and Event Sourcing: Full support for the Command-Query Responsibility Segregation (CQRS) pattern and event sourcing for scalable applications.
  • Message Brokering: Seamless integration with RabbitMQ, Kafka, and other message brokers.
  • HTTP & Web API: Robust HTTP client, server support, and API gateway integration.
  • Serialization: Built-in support for both JSON and binary serialization, crucial for optimized data transfer between microservices.
  • Cloud-Native: Optimized for Kubernetes, Docker, and other cloud platforms.
  • Observability: Built-in support for logging, metrics, and distributed tracing using OpenTelemetry and Jaeger.
  • Persistence: Ready-to-use integrations with MongoDB, Redis, and Consul for robust data storage solutions.
  • API Documentation: Integration with Swagger and ReDoc to generate comprehensive API documentation.

Table of Contents


Getting Started

Prerequisites

  • .NET 9.0 SDK or higher: Download .NET 9.0
  • A container platform like Docker or Kubernetes (for cloud-native applications).

Installation

You can install the framework and its core components via NuGet:

dotnet add package Paralax
dotnet add package Paralax.Auth
dotnet add package Paralax.CQRS
dotnet add package Paralax.Logging
dotnet add package Paralax.MessageBrokers

For specialized functionality HTTP, Web API, and message brokers:

dotnet add package Paralax.HTTP
dotnet add package Paralax.WebAPI
dotnet add package Paralax.MessageBrokers.RabbitMQ
dotnet add package Paralax.Tracing.Jaeger

Usage

Once installed, you can start configuring Paralax in your microservices project. Below is an example of configuring logging, tracing, and CQRS with RabbitMQ for message brokering.

public static void Main(string[] args)
{
    var builder = WebApplication.CreateBuilder(args);

    // Add Paralax components
    builder.Services.AddParalaxLogging();
    builder.Services.AddParalaxTracing();
    builder.Services.AddParalaxCQRS();
    builder.Services.AddParalaxMessageBrokerRabbitMQ();

    var app = builder.Build();

    // Middleware setup
    app.UseParalax();

    app.Run();
}

Components

Paralax.Auth

The Paralax.Auth module provides authentication and authorization mechanisms, including JWT-based authentication and OAuth2 integrations.

Paralax.CQRS

This module implements the CQRS (Command-Query Responsibility Segregation) pattern, allowing for scalable, event-driven microservices. It provides:

  • Commands: Handling write operations.
  • Queries: Handling read operations.
  • Events: Implementing event sourcing.

Paralax.MessageBrokers

Supports popular messaging systems like RabbitMQ and Kafka. It enables asynchronous communication between microservices and ensures reliable delivery of messages.

Example:

services.AddParalaxMessageBrokerRabbitMQ(options =>
{
    options.HostName = "rabbitmq.example.com";
});

Paralax.HTTP

Provides a robust HTTP client and server integration, supporting binary serialization of payloads for performance-critical services.

Paralax.WebAPI

A framework built on top of ASP.NET Core Web API, optimized for building APIs with minimal overhead. It integrates binary serialization for efficient communication and supports Swagger for API documentation.

Paralax.Logging

Out-of-the-box logging integration with support for multiple sinks (e.g., Console, Elasticsearch, etc.). It uses best-in-class logging libraries to ensure visibility into your microservices.

Paralax.Tracing

Integrated distributed tracing with OpenTelemetry and Jaeger for monitoring service calls and diagnosing bottlenecks in complex microservice architectures.


Contributing

We welcome contributions from the open-source community! To contribute, please refer to the Contributing Guide for more details on how to get started.

Reporting Issues

If you encounter bugs or issues while using Paralax, please report them through the GitHub Issues page.


License

The Paralax Framework is licensed under the Apache-2.0 License. See the LICENSE file for details.


Credits

The Paralax Framework is maintained by ITSharpPro. We appreciate contributions from developers around the world who help improve the framework for the global development community.

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 is compatible.  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 was computed.  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.

NuGet packages (1)

Showing the top 1 NuGet packages that depend on Paralax.Logging:

Package Downloads
Paralax.CQRS.Logging

Paralax.CQRS.Logging - Logging for CQRS in microservices architecture

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
1.0.448 1,403 2/8/2025
1.0.446 189 2/8/2025
1.0.443 212 1/31/2025
1.0.441 167 1/31/2025
1.0.436 315 12/15/2024
1.0.434 175 12/15/2024
1.0.432 157 12/15/2024
1.0.430 152 12/15/2024
1.0.428 172 12/15/2024
1.0.424 184 12/14/2024
1.0.420 231 11/23/2024
1.0.415 223 11/9/2024
1.0.410 186 11/9/2024
1.0.406 221 10/30/2024
1.0.404 157 10/30/2024
1.0.401 300 10/18/2024
1.0.396 146 10/18/2024
1.0.388 156 10/18/2024
1.0.384 167 10/18/2024
1.0.380 166 10/17/2024
1.0.376 150 10/17/2024
1.0.372 163 10/17/2024
1.0.368 161 10/17/2024
1.0.364 135 10/17/2024
1.0.356 636 10/3/2024
1.0.354 159 10/3/2024
1.0.352 163 10/3/2024
1.0.350 188 10/3/2024
1.0.348 190 10/3/2024
1.0.346 192 10/3/2024
1.0.344 195 10/3/2024
1.0.343 187 10/1/2024
1.0.342 199 9/30/2024
1.0.339 180 9/30/2024
1.0.338 178 9/30/2024
1.0.335 227 9/30/2024
1.0.332 161 9/30/2024
1.0.331 156 9/30/2024
1.0.328 198 9/30/2024
1.0.325 178 9/30/2024
1.0.322 169 9/30/2024
1.0.319 176 9/30/2024
1.0.305 168 9/29/2024
1.0.303 171 9/29/2024
1.0.301 127 9/29/2024
1.0.299 142 9/29/2024
1.0.297 158 9/29/2024
1.0.291 178 9/29/2024
1.0.268 169 9/29/2024
1.0.258 172 9/28/2024
1.0.256 179 9/28/2024
1.0.254 186 9/28/2024
1.0.252 154 9/28/2024
1.0.248 200 9/28/2024
1.0.246 156 9/28/2024
1.0.217 170 9/28/2024
1.0.214 181 9/28/2024
1.0.211 172 9/28/2024
1.0.208 176 9/28/2024
1.0.205 176 9/28/2024
1.0.202 185 9/28/2024
1.0.199 181 9/27/2024
1.0.196 175 9/27/2024
1.0.193 191 9/27/2024
1.0.190 152 9/27/2024
1.0.187 156 9/27/2024
1.0.184 192 9/27/2024
1.0.181 172 9/27/2024
1.0.178 171 9/27/2024
1.0.175 174 9/26/2024
1.0.172 170 9/26/2024
1.0.169 189 9/26/2024
1.0.166 188 9/24/2024
1.0.159 187 9/23/2024
1.0.155 155 9/23/2024
1.0.152 169 9/23/2024
1.0.148 207 9/23/2024
1.0.145 193 9/23/2024
1.0.140 203 9/22/2024
1.0.137 174 9/22/2024
1.0.131 199 9/22/2024
1.0.104 184 9/21/2024
1.0.101 195 9/21/2024

Initial release of the Paralax.Logging package for comprehensive logging in a microservices architecture.