# py-logging

**Repository Path**: public_python/py-logging

## Basic Information

- **Project Name**: py-logging
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-30
- **Last Updated**: 2026-02-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Py-Logging-structlog 日志中间件

一个高性能、企业级的Python日志中间件，融合Java Logback设计理念，提供完整的日志解决方案。

## ✨ 特性

- 🚀 **高性能异步处理**：基于asyncio的异步架构，支持高并发场景
- 📝 **结构化日志**：内置JSON格式支持，便于日志分析和收集
- 🔐 **数据脱敏**：内置敏感信息自动脱敏，满足安全合规要求
- ⚙️ **动态配置**：支持YAML/JSON配置，支持热更新
- 🔌 **丰富输出**：控制台、文件、Kafka、Elasticsearch等多种输出目标
- 🎯 **注解支持**：通过装饰器简化日志记录，支持切面编程
- 📊 **监控集成**：集成Prometheus、Sentry等监控系统

## 🚀 快速开始

### 安装

```bash
pip install py-logging
```

### 基本使用

```python
from logger import get_logger

logger = get_logger("myapp")
logger.info("用户登录", user_id=123, action="login")
```

### 配置文件

创建 `logback.yaml`：

```yaml
version: 1.0
appenders:
  console:
    type: console
    level: INFO
loggers:
  root:
    level: INFO
    appenders: ["console"]
```

## 📚 文档

- [快速开始](docs/quickstart.md)
- [配置详解](docs/configuration.md)
- [API参考](docs/api_reference.md)
- [高级用法](docs/advanced_usage.md)
- [部署指南](docs/deployment.md)

## 🏗️ 架构

```
├── 核心层 (core)      # 日志框架、配置管理、异步处理
├── 输出器 (appenders) # 各种输出目标实现
├── 编码器 (encoders)  # 日志格式编码
├── 过滤器 (filters)   # 日志过滤规则
├── 注解系统 (annotations) # 注解和切面编程
└── 集成模块 (integrations) # 第三方框架集成
```

## 📊 性能指标

- 同步日志吞吐量：> 85,000 条/秒
- 异步日志吞吐量：> 200,000 条/秒
- 内存占用：< 50MB（百万条日志）
- 延迟：< 5ms（95%分位）

## 🤝 贡献

欢迎提交Issue和Pull Request！详见[贡献指南](CONTRIBUTING.md)。

## 📄 许可证

MIT License © 2026 Py-Logging Team