# Quickuse.Logging

**Repository Path**: quickuse/Quickuse.Logging

## Basic Information

- **Project Name**: Quickuse.Logging
- **Description**: 快速应用.日志组件。这个记录日志的类库，在原来的日志类库基础上做了再次扩展，提供了多个输出目标，方便将日志输出到不通目标。
- **Primary Language**: C#
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 5
- **Forks**: 1
- **Created**: 2020-04-22
- **Last Updated**: 2026-04-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Quickuse.Logging

轻量级 .NET 日志组件，扩展 `Microsoft.Extensions.Logging`，支持文件、邮件、HTTP、Elasticsearch 四种输出方式。

- 平台：`netstandard2.1`，兼容 .NET Core 3.1 / .NET 5~8+
- 配置：环境变量驱动，零代码配置，开箱即用
- 接入：支持 `LogManager` 静态 API 和 `ILogger<T>` 标准接口两种方式

在线文档：http://quickuse.gitee.io/quickuse.logging

## 安装

```bash
dotnet add package Quickuse.Logging
```

## 快速开始

**方式一：LogManager 静态 API**

```csharp
using Quickuse.Logging;

LogManager.Info("用户登录成功", module: "Auth", traceId: "trace-123");
LogManager.Error(ex, module: "Payment");
```

**方式二：ILogger\<T\>（ASP.NET Core）**

```csharp
// Startup.ConfigureServices
services.AddQuickuseLogging();

// Startup.Configure
app.UseQuickuseLogging();
```

## 配置示例

```bash
# 启用文件日志（Warn 及以上）
export LOG_FILE_LEVELS=Warn
export LOG_FILE_FILENAME=./logs/app.log

# 启用邮件告警（Error 及以上）
export LOG_EMAIL_LEVELS=Error
export LOG_EMAIL_MAILSERVER=smtp.example.com
export LOG_EMAIL_TOMAILS=ops@example.com

# 启用 Elasticsearch（Info 及以上）
export LOG_ES_LEVELS=Info
export LOG_ES_HOST=http://elasticsearch:9200
export LOG_ES_INDEXNAME=myapp-log
```

详细配置说明见[在线文档](http://quickuse.gitee.io/quickuse.logging)。