liufumingren 49681b7bdd 加固日志:写入不再静默丢失 + 心跳每 5 分钟落一行
上次现场排查发现 16:28-22:47 六小时日志全丢,但同一时间上报和
scan-records.json 都正常 —— 原因是 File.AppendAllText 按 FileShare.Read
打开,日志文件被别的程序占着时每次都抛 IOException,又被 catch{} 吞掉。

- AppLog 改用 FileShare.ReadWrite|Delete 打开并重试一次,仍失败则累加丢弃计数
- agent-status.json 暴露 LogDropped / LogLastDroppedAt,现场能看出日志是否完整
- 心跳日志改为每 5 分钟一行(含在线通道数、待上传条数),持续失败也每 5 分钟补一行
- 通道断开日志沿用原有节流(前 3 次 + 每 10 次),配合心跳行可定位断点

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-22 03:12:14 +08:00

191 lines
6.2 KiB
C#
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

using System;
using System.Collections.Generic;
using System.Globalization;
using System.IO;
using System.Text;
using System.Threading;
namespace YuncangTrace.LocalService.Services;
/// <summary>
/// 进程级日志(托盘 / 登录窗 / 主窗 / HTTP 服务都往这里写)
///
/// 只落文件、不再进界面:**按天一个文件** <c>logs\log_2026-09-22.txt</c>,就放在软件目录下
/// (<see cref="AppContext.BaseDirectory"/>)。装到只读位置(如 Program Files)时自动退回
/// <c>%LOCALAPPDATA%\YuncangTrace\logs</c>。
///
/// 写日志失败绝不能影响主流程 —— 所有 IO 异常都吞掉。
/// </summary>
public static class AppLog
{
private const string FolderName = "logs";
private static readonly object Gate = new();
private static readonly Encoding Utf8NoBom = new UTF8Encoding(false);
private static string? _logDirectory;
private static int _cleanupState;
/// <summary>日志保留天数(超过的按天文件自动删除)</summary>
public const int KeepDays = 14;
/// <summary>日志目录(首次访问时创建)</summary>
public static string LogDirectory => _logDirectory ??= ResolveDirectory();
/// <summary>写入一行日志(按天分文件,多线程安全)</summary>
public static void Write(string message)
{
EnsureCleanup();
var now = DateTime.Now;
var line = $"[{now:yyyy-MM-dd HH:mm:ss}] {message}{Environment.NewLine}";
var path = Path.Combine(LogDirectory, FileNameOf(now));
// 不要用 File.AppendAllText:它按 FileShare.Read 打开,只要日志文件正被
// 记事本/编辑器/日志工具独占打开,每次写入都会失败(2026-10-21 现场丢了 6 小时日志)。
// 这里显式 FileShare.ReadWrite,并重试一次;仍然失败就记一次丢弃计数,
// 由 agent-status.json 暴露出去,避免「日志没了还查不出」。
for (var attempt = 0; attempt < 2; attempt++)
{
try
{
using var stream = new FileStream(path, FileMode.Append, FileAccess.Write,
FileShare.ReadWrite | FileShare.Delete);
var bytes = Utf8NoBom.GetBytes(line);
stream.Write(bytes, 0, bytes.Length);
return;
}
catch
{
if (attempt == 0) Thread.Sleep(20);
}
}
Interlocked.Increment(ref _dropped);
LastDroppedAt = DateTime.Now;
}
private static int _dropped;
/// <summary>累计丢弃的日志行数(写文件一直失败时增长)</summary>
public static int Dropped => Volatile.Read(ref _dropped);
/// <summary>最近一次丢弃日志的时间</summary>
public static DateTime? LastDroppedAt { get; private set; }
/// <summary>进程内只清理一次(后台服务整天不重启也只跑一次)</summary>
private static void EnsureCleanup()
{
if (Interlocked.Exchange(ref _cleanupState, 1) != 0) return;
Cleanup(KeepDays);
}
/// <summary>
/// 删除超过 <paramref name="keepDays"/> 天的按天日志(文件名 <c>log_yyyy-MM-dd.txt</c>)。
/// 删不掉的文件静默跳过。
/// </summary>
public static int Cleanup(int keepDays = KeepDays)
{
var removed = 0;
try
{
var dir = LogDirectory;
if (!Directory.Exists(dir)) return 0;
var cutoff = DateTime.Today.AddDays(-Math.Max(keepDays, 1));
foreach (var file in Directory.EnumerateFiles(dir, "log_*.txt"))
{
var name = Path.GetFileNameWithoutExtension(file);
if (!name.StartsWith("log_", StringComparison.OrdinalIgnoreCase)) continue;
if (!DateTime.TryParseExact(name.Substring(4), "yyyy-MM-dd", CultureInfo.InvariantCulture,
DateTimeStyles.None, out var date)) continue;
if (date >= cutoff) continue;
try
{
File.Delete(file);
removed++;
}
catch
{
// 个别文件被占用(用户用记事本开着)就跳过
}
}
}
catch
{
// 目录不可读:当作没有日志
}
return removed;
}
/// <summary>
/// 清理日志:删除目录下全部 <c>log_*.txt</c>,返回删掉的文件数。
/// 当天正在写的文件也能删,下次 <see cref="Write"/> 会重建。
/// </summary>
public static int Clear()
{
var removed = 0;
try
{
lock (Gate)
{
var dir = LogDirectory;
if (!Directory.Exists(dir)) return 0;
foreach (var file in Directory.EnumerateFiles(dir, "log_*.txt"))
{
try
{
File.Delete(file);
removed++;
}
catch
{
// 个别文件被占用(比如用户用记事本打开着)就跳过
}
}
}
}
catch
{
// 目录不可读:当作没有日志
}
return removed;
}
private static string FileNameOf(DateTime time) => $"log_{time:yyyy-MM-dd}.txt";
private static string ResolveDirectory()
{
var candidates = new List<string>
{
// 首选:软件目录(与 exe 同级)
Path.Combine(AppContext.BaseDirectory, FolderName),
// 兜底:用户数据目录(exe 所在目录不可写时)
Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.LocalApplicationData), "YuncangTrace", FolderName),
};
foreach (var dir in candidates)
{
try
{
Directory.CreateDirectory(dir);
return dir;
}
catch
{
// 试下一个
}
}
return candidates[candidates.Count - 1];
}
}