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

288 lines
9.9 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.IO;
using System.Text.Json;
namespace YuncangTrace.LocalService.Services;
/// <summary>后台服务的配置(`%ProgramData%\YuncangTrace\agent.json`,由桌面端写入)</summary>
public sealed class AgentConfig
{
/// <summary>后端根地址(例如 http://127.0.0.1:7300)</summary>
public string ServerBaseUrl { get; set; } = "";
/// <summary>设备**长期 JWT**(默认 365 天,服务上报扫码用)</summary>
public string DeviceToken { get; set; } = "";
/// <summary>刷新令牌(服务在访问令牌快过期时自动续期)</summary>
public string RefreshToken { get; set; } = "";
public string DeviceSn { get; set; } = "";
public int DeviceId { get; set; }
public int SubjectId { get; set; }
// ---------------- NTP(服务以 LocalSystem 运行,改系统时间不需要 UAC) ----------------
public bool NtpEnabled { get; set; } = true;
public string NtpServer { get; set; } = "ntp.aliyun.com";
public int NtpIntervalMinutes { get; set; } = 30;
/// <summary>写入时间(排查用)</summary>
public DateTime UpdatedAt { get; set; } = DateTime.Now;
}
/// <summary>后台服务的令牌文件(`agent-token.json`;服务自动续期后更新)</summary>
public sealed class AgentToken
{
public string DeviceToken { get; set; } = "";
public string RefreshToken { get; set; } = "";
public DateTime? ExpiresAt { get; set; }
public DateTime? RefreshExpiresAt { get; set; }
public DateTime UpdatedAt { get; set; } = DateTime.Now;
}
/// <summary>后台服务的运行状态(桌面端只读展示)</summary>
public sealed class AgentStatus
{
public bool Running { get; set; }
public string Version { get; set; } = "";
public string DeviceSn { get; set; } = "";
public int SubjectId { get; set; }
public string UploadStatus { get; set; } = "";
public string ChannelSyncStatus { get; set; } = "";
public int PendingRecords { get; set; }
public List<AgentChannelStatus> Channels { get; set; } = new();
public string? LastError { get; set; }
/// <summary>取流子进程(--hik-worker)状态;没有取流能力时 <see cref="AgentHikStatus.Available"/> 为 false</summary>
public AgentHikStatus Hik { get; set; } = new();
public string NtpLastSyncAt { get; set; } = "";
public double NtpLastOffsetSeconds { get; set; }
public double NtpRoundTripMs { get; set; }
public DateTime? NtpServerTime { get; set; }
/// <summary>当前访问令牌到期时间</summary>
public DateTime? TokenExpiresAt { get; set; }
/// <summary>刷新令牌到期时间</summary>
public DateTime? RefreshTokenExpiresAt { get; set; }
/// <summary>最近一次续期时间</summary>
public DateTime? LastTokenRefreshAt { get; set; }
/// <summary>最近一次续期失败原因(成功则 null)</summary>
public string? LastTokenRefreshError { get; set; }
/// <summary>最近一次成功心跳时间</summary>
public DateTime? LastHeartbeatAt { get; set; }
/// <summary>最近一次心跳失败原因(成功则 null)</summary>
public string? LastHeartbeatError { get; set; }
/// <summary>累计丢弃的日志行数(日志文件被占用/磁盘满时增长,用于现场判断「日志是否完整」)</summary>
public int LogDropped { get; set; }
/// <summary>最近一次丢日志的时间</summary>
public DateTime? LogLastDroppedAt { get; set; }
public DateTime UpdatedAt { get; set; } = DateTime.Now;
}
/// <summary>服务里某条通道的**运行时状态**(连接/最近条码),桌面端据此显示在线离线</summary>
public sealed class AgentChannelStatus
{
public string Mac { get; set; } = "";
public bool Connected { get; set; }
public string LastIp { get; set; } = "";
public string LastCode { get; set; } = "";
public DateTime? LastCodeAt { get; set; }
}
/// <summary>
/// 取流子进程的运行时状态(桌面端/客服排障用)。
///
/// <see cref="Available"/> 为 false 只表示"取不到视频",**扫码/上报照常工作**。
/// </summary>
public sealed class AgentHikStatus
{
/// <summary>SDK 与 ffmpeg 是否就位(自检结果)</summary>
public bool Available { get; set; }
/// <summary>worker 进程当前是否已连接</summary>
public bool Connected { get; set; }
/// <summary>HCNetSDK.dll 所在目录(找不到为 null)</summary>
public string? SdkDir { get; set; }
/// <summary>ffmpeg.exe 路径(找不到为 null)</summary>
public string? FfmpegPath { get; set; }
/// <summary>成片根目录</summary>
public string VideoRoot { get; set; } = "";
/// <summary>连续失败熔断到什么时候(null = 未熔断)</summary>
public DateTime? BlockedUntil { get; set; }
/// <summary>最近一次失败原因</summary>
public string? LastError { get; set; }
/// <summary>最近一次自检时间</summary>
public DateTime? ProbedAt { get; set; }
}
/// <summary>桌面端 → 后台服务的一次性命令(写文件,服务每秒轮询)</summary>
public sealed class AgentCommand
{
public DateTime? TriggerUploadAt { get; set; }
public DateTime? ClearRecordsAt { get; set; }
public string? ClearChannelId { get; set; }
public DateTime? ReloadChannelsAt { get; set; }
public DateTime? NtpSyncAt { get; set; }
public string? NtpServer { get; set; }
/// <summary>请求后台服务立即用刷新令牌续期访问令牌(测试/排障用)</summary>
public DateTime? RefreshTokenAt { get; set; }
}
/// <summary>服务发现到的设备(写文件供桌面端展示;只保留必要字段)</summary>
public sealed class AgentDiscoveredDevice
{
public string Mac { get; set; } = "";
public string Ip { get; set; } = "";
public string HostName { get; set; } = "";
public string Model { get; set; } = "";
public string Firmware { get; set; } = "";
public DateTime UpdatedAt { get; set; } = DateTime.Now;
}
/// <summary>
/// agent.json / agent-status.json / agent-command.json 的读写。
///
/// 两个进程(桌面端 + 服务)会同时读写这些文件,所以:
/// - 读:<c>FileShare.ReadWrite</c>,读到一半也不会抛;
/// - 写:先写 <c>.tmp</c> 再原子替换,避免对方读到半截 JSON。
/// </summary>
public static class AgentFiles
{
private static readonly JsonSerializerOptions Options = new()
{
WriteIndented = true,
Encoder = System.Text.Encodings.Web.JavaScriptEncoder.UnsafeRelaxedJsonEscaping,
};
public static AgentConfig? LoadConfig() => Read<AgentConfig>(AgentPaths.ConfigFile);
public static void SaveConfig(AgentConfig config)
{
config.UpdatedAt = DateTime.Now;
Write(AgentPaths.ConfigFile, config);
}
public static AgentToken? LoadToken() => Read<AgentToken>(AgentPaths.TokenFile);
public static void SaveToken(AgentToken token)
{
token.UpdatedAt = DateTime.Now;
Write(AgentPaths.TokenFile, token);
}
public static void ClearToken()
{
try
{
if (File.Exists(AgentPaths.TokenFile)) File.Delete(AgentPaths.TokenFile);
}
catch
{
// 删不掉不影响下次开启(会覆盖写)
}
}
public static AgentStatus? LoadStatus() => Read<AgentStatus>(AgentPaths.StatusFile);
public static void SaveStatus(AgentStatus status)
{
status.UpdatedAt = DateTime.Now;
Write(AgentPaths.StatusFile, status);
}
public static AgentCommand? LoadCommand() => Read<AgentCommand>(AgentPaths.CommandFile);
public static void SaveCommand(AgentCommand command) => Write(AgentPaths.CommandFile, command);
/// <summary>追加一条命令(保留还没被服务取走的其它命令)</summary>
public static void QueueCommand(Action<AgentCommand> apply)
{
var command = LoadCommand() ?? new AgentCommand();
apply(command);
SaveCommand(command);
}
/// <summary>服务执行完命令后清掉文件(下一条命令不会重复执行)</summary>
public static void ClearCommand()
{
try
{
if (File.Exists(AgentPaths.CommandFile)) File.Delete(AgentPaths.CommandFile);
}
catch
{
// 删不掉下次也只是重复执行一遍(幂等)
}
}
public static List<AgentDiscoveredDevice> LoadDiscovered()
=> Read<List<AgentDiscoveredDevice>>(AgentPaths.DiscoveredFile) ?? new List<AgentDiscoveredDevice>();
public static void SaveDiscovered(List<AgentDiscoveredDevice> devices)
=> Write(AgentPaths.DiscoveredFile, devices);
public static DateTime? FileTime(string path)
{
try
{
return File.Exists(path) ? File.GetLastWriteTimeUtc(path) : null;
}
catch
{
return null;
}
}
private static T? Read<T>(string path) where T : class
{
try
{
if (!File.Exists(path)) return null;
using var stream = new FileStream(path, FileMode.Open, FileAccess.Read, FileShare.ReadWrite);
using var reader = new StreamReader(stream);
var text = reader.ReadToEnd();
return string.IsNullOrWhiteSpace(text) ? null : JsonSerializer.Deserialize<T>(text, Options);
}
catch
{
return null;
}
}
private static void Write<T>(string path, T value)
{
try
{
var dir = Path.GetDirectoryName(path);
if (!string.IsNullOrEmpty(dir)) Directory.CreateDirectory(dir);
var temp = path + ".tmp";
File.WriteAllText(temp, JsonSerializer.Serialize(value, Options));
File.Move(temp, path, overwrite: true);
}
catch (Exception ex)
{
AppLog.Write($"[agent] 写文件失败({path}):{ex.Message}");
}
}
}