mirror of
https://github.com/yyhuni/xingrin.git
synced 2026-02-06 06:33:12 +08:00
7cd4354d8f
- Add user_logger utility for structured scan operation logging - Create scan log views and API endpoints for retrieving scan execution logs - Add scan-log-list component and use-scan-logs hook for frontend log display - Refactor asset search views to remove ArrayField support from pg_ivm IMMV - Update search_service.py to JOIN original tables for array field retrieval - Add system architecture requirements (AMD64/ARM64) to README - Update scan flow handlers to integrate logging system - Enhance scan progress dialog with log viewer integration - Add ANSI log viewer component for formatted log display - Update scan service API to support log retrieval endpoints - Migrate database schema to support new logging infrastructure - Add internationalization strings for scan logs (en/zh) This change improves observability of scan operations and resolves pg_ivm limitations with ArrayField types by fetching array data from original tables via JOIN operations.
57 lines
1.7 KiB
Python
57 lines
1.7 KiB
Python
"""
|
||
扫描日志记录器
|
||
|
||
提供统一的日志记录接口，用于在 Flow 中记录用户可见的扫描进度日志。
|
||
|
||
特性：
|
||
- 简单的函数式 API
|
||
- 只写入数据库（ScanLog 表），不写 Python logging
|
||
- 错误容忍（数据库失败不影响扫描执行）
|
||
|
||
职责分离：
|
||
- user_log: 用户可见日志（写数据库，前端展示）
|
||
- logger: 开发者日志（写日志文件/控制台，调试用）
|
||
|
||
使用示例：
|
||
from apps.scan.utils import user_log
|
||
|
||
# 用户日志（写数据库）
|
||
user_log(scan_id, "port_scan", "Starting port scan")
|
||
user_log(scan_id, "port_scan", "naabu completed: found 120 ports")
|
||
|
||
# 开发者日志（写日志文件）
|
||
logger.info("✓ 工具 %s 执行完成 - 记录数: %d", tool_name, count)
|
||
"""
|
||
|
||
import logging
|
||
from django.db import DatabaseError
|
||
|
||
logger = logging.getLogger(__name__)
|
||
|
||
|
||
def user_log(scan_id: int, stage: str, message: str, level: str = "info"):
|
||
"""
|
||
记录用户可见的扫描日志（只写数据库）
|
||
|
||
Args:
|
||
scan_id: 扫描任务 ID
|
||
stage: 阶段名称，如 "port_scan", "site_scan"
|
||
message: 日志消息
|
||
level: 日志级别，默认 "info"，可选 "warning", "error"
|
||
|
||
数据库 content 格式: "[{stage}] {message}"
|
||
"""
|
||
formatted = f"[{stage}] {message}"
|
||
|
||
try:
|
||
from apps.scan.models import ScanLog
|
||
ScanLog.objects.create(
|
||
scan_id=scan_id,
|
||
level=level,
|
||
content=formatted
|
||
)
|
||
except DatabaseError as e:
|
||
logger.error("ScanLog write failed - scan_id=%s, error=%s", scan_id, e)
|
||
except Exception as e:
|
||
logger.error("ScanLog write unexpected error - scan_id=%s, error=%s", scan_id, e)
|