32f26272ae
Five tools under one repo, all docs organized per DOCS-GUIDE.md: - aalogcli: .NET 4.8 / x86 CliFx CLI for reading System Platform binary logs (*.aaLGX) for LLM debugging, built on aaOpenSource/aaLog. Commands: last, tail, range, unread, fields. Stable JSON envelope under --llm-json. Build template under lib/build/ for rebuilding aaLogReader.dll. - aot: ArchestrA Object Toolkit 2014 v4.0 reference material. Dev guide (Markdown converted from CHM), API reference for the ArchestrA.Toolkit namespace, and the Monitor / Watchdog VS sample solutions. - graccesscli: .NET 4.8 / x86 CliFx CLI that automates Galaxy configuration via the ArchestrA GRAccess COM interop. Includes session daemon, IPC protocol, and llm-json envelope contract. - grdb: SQL/DDL exploration of the Galaxy Repository database. DDL captures, reusable queries, hierarchy / contained-name <-> tag-name translation notes. - histdb: LLM-oriented reference for AVEVA Historian retrieval. INSQL linked-server, extension tables, every wwXxx time-domain extension, every retrieval mode, alarm/event SQL recipes, REST API. Distilled from the 243-page Historian Retrieval Guide. Root contains: - CLAUDE.md: thin index pointing into each tool's README. - DOCS-GUIDE.md: doctrine for organizing docs for LLM consumption. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
259 lines
8.3 KiB
C#
259 lines
8.3 KiB
C#
using System;
|
|
using Newtonsoft.Json;
|
|
using System.Text;
|
|
using System.Runtime.CompilerServices;
|
|
|
|
namespace aaLogReader
|
|
{
|
|
public class LogHeader : ILogHeader
|
|
{
|
|
private static readonly log4net.ILog log = log4net.LogManager.GetLogger(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType);
|
|
|
|
public string LogFilePath { get; set; }
|
|
|
|
public ulong StartMsgNumber { get; set; }
|
|
|
|
public ulong MsgCount { get; set; }
|
|
|
|
public ulong EndMsgNumber
|
|
{
|
|
get
|
|
{
|
|
return (ulong)(checked(this.StartMsgNumber + this.MsgCount) - 1);
|
|
}
|
|
}
|
|
|
|
private ulong _startFileTime;
|
|
private DateTimeOffset _startDateTime;
|
|
|
|
public ulong StartFileTime
|
|
{
|
|
get { return _startFileTime; }
|
|
set
|
|
{
|
|
_startFileTime = value;
|
|
_startDateTime = DateTimeOffset.FromFileTime((long)value);
|
|
}
|
|
}
|
|
|
|
public DateTimeOffset StartDateTime
|
|
{
|
|
get { return _startDateTime; }
|
|
}
|
|
|
|
[JsonIgnore]
|
|
public DateTime StartDateTimeLocal
|
|
{
|
|
get { return _startDateTime.LocalDateTime; }
|
|
}
|
|
|
|
[JsonIgnore]
|
|
public DateTime StartDateTimeUtc
|
|
{
|
|
get { return _startDateTime.UtcDateTime; }
|
|
}
|
|
|
|
private ulong _endFileTime;
|
|
private DateTimeOffset _endDateTime;
|
|
|
|
public ulong EndFileTime
|
|
{
|
|
get { return _endFileTime; }
|
|
set
|
|
{
|
|
_endFileTime = value;
|
|
_endDateTime = DateTimeOffset.FromFileTime((long)value);
|
|
}
|
|
}
|
|
|
|
public DateTimeOffset EndDateTime
|
|
{
|
|
get { return _endDateTime; }
|
|
}
|
|
|
|
[JsonIgnore]
|
|
public DateTime EndDateTimeLocal
|
|
{
|
|
get { return _endDateTime.LocalDateTime; }
|
|
}
|
|
|
|
[JsonIgnore]
|
|
public DateTime EndDateTimeUtc
|
|
{
|
|
get { return _endDateTime.UtcDateTime; }
|
|
}
|
|
|
|
public int OffsetFirstRecord { get; set; }
|
|
|
|
public int OffsetLastRecord { get; set; }
|
|
|
|
public string ComputerName { get; set; }
|
|
|
|
public string Session { get; set; }
|
|
|
|
public string PrevFileName { get; set; }
|
|
|
|
public string HostFQDN { get; set; }
|
|
|
|
[JsonIgnore]
|
|
public ReturnCodeStruct ReturnCode { get; set; }
|
|
|
|
public string ToJSON()
|
|
{
|
|
return JsonConvert.SerializeObject(this);
|
|
}
|
|
|
|
/// <summary>
|
|
/// Return the log header data in the form of a Key-Value Pair
|
|
/// </summary>
|
|
/// <param name="format">Full or Minimal</param>
|
|
/// <returns></returns>
|
|
public string ToKVP()
|
|
{
|
|
string returnValue;
|
|
StringBuilder localSB = new StringBuilder();
|
|
|
|
try
|
|
{
|
|
|
|
localSB.AppendFormat("MsgStartingNumber=\"{0}\"", this.StartMsgNumber.ToString("yyyy-MM-dd HH:mm:ss.fff"));
|
|
localSB.AppendFormat(", MsgCount=\"{0}\"", this.MsgCount);
|
|
localSB.AppendFormat(", MsgLastNumber=\"{0}\"", this.EndMsgNumber);
|
|
localSB.AppendFormat(", StartDateTime=\"{0}\"", this.StartDateTime);
|
|
localSB.AppendFormat(", EndDateTime=\"{0}\"", this.EndDateTime);
|
|
localSB.AppendFormat(", OffsetFirstRecord=\"{0}\"", this.OffsetFirstRecord);
|
|
localSB.AppendFormat(", OffsetLastRecord=\"{0}\"", this.OffsetLastRecord);
|
|
localSB.AppendFormat(", ComputerName=\"{0}\"", this.ComputerName);
|
|
localSB.AppendFormat(", Session=\"{0}\"", this.Session);
|
|
localSB.AppendFormat(", PrevFileName=\"{0}\"", this.PrevFileName);
|
|
localSB.AppendFormat(", HostFQDN=\"{0}\"", this.HostFQDN);
|
|
|
|
returnValue = localSB.ToString();
|
|
}
|
|
catch (Exception ex)
|
|
{
|
|
LogException(ex);
|
|
returnValue = "";
|
|
}
|
|
|
|
return returnValue;
|
|
}
|
|
|
|
/// <summary>
|
|
/// Get a header for a series of log records with a delimiter
|
|
/// </summary>
|
|
/// <param name="Delimiter"></param>
|
|
/// <param name="format"></param>
|
|
/// <returns></returns>
|
|
private string localHeader(char Delimiter = ',')
|
|
{
|
|
string returnValue;
|
|
StringBuilder localSB = new StringBuilder();
|
|
|
|
try
|
|
{
|
|
localSB.Append("LogFilePath");
|
|
localSB.Append(Delimiter + "MsgStartingNumber");
|
|
localSB.Append(Delimiter + "MsgCount");
|
|
localSB.Append(Delimiter + "MsgLastNumber");
|
|
localSB.Append(Delimiter + "StartDateTime");
|
|
localSB.Append(Delimiter + "StartFileTime");
|
|
localSB.Append(Delimiter + "EndDateTime");
|
|
localSB.Append(Delimiter + "EndFileTime");
|
|
localSB.Append(Delimiter + "OffsetFirstRecord");
|
|
localSB.Append(Delimiter + "OffsetLastRecord");
|
|
localSB.Append(Delimiter + "ComputerName");
|
|
localSB.Append(Delimiter + "Session");
|
|
localSB.Append(Delimiter + "PrevFileName");
|
|
localSB.Append(Delimiter + "HostFQDN");
|
|
|
|
returnValue = localSB.ToString();
|
|
}
|
|
catch (Exception ex)
|
|
{
|
|
LogException(ex);
|
|
returnValue = "";
|
|
}
|
|
|
|
return returnValue;
|
|
}
|
|
|
|
public static string Header(char Delimiter = ',')
|
|
{
|
|
LogHeader lh = new LogHeader();
|
|
return lh.localHeader(Delimiter);
|
|
}
|
|
|
|
public static string HeaderCSV()
|
|
{
|
|
return LogHeader.Header(',');
|
|
}
|
|
|
|
public static string HeaderTSV()
|
|
{
|
|
return LogHeader.Header('\t');
|
|
}
|
|
|
|
/// <summary>
|
|
/// Get the lastRecordRead in the form of a delimited string
|
|
/// </summary>
|
|
/// <param name="Delimiter">Delimiter to Use</param>
|
|
/// <param name="format">Full or Minimal</param>
|
|
/// <returns></returns>
|
|
public string ToDelimitedString(char Delimiter = ',')
|
|
{
|
|
|
|
string returnValue;
|
|
StringBuilder localSB = new StringBuilder();
|
|
|
|
try
|
|
{
|
|
localSB.Append("\"" + this.LogFilePath + "\"");
|
|
localSB.Append(Delimiter + this.StartMsgNumber.ToString());
|
|
localSB.Append(Delimiter + this.MsgCount.ToString());
|
|
localSB.Append(Delimiter + this.EndMsgNumber.ToString());
|
|
localSB.Append(Delimiter + "\"" + this.StartDateTime.ToString("yyyy-MM-dd HH:mm:ss.fff") + "\"");
|
|
localSB.Append(Delimiter + this.StartFileTime.ToString());
|
|
localSB.Append(Delimiter + "\"" + this.EndDateTime.ToString("yyyy-MM-dd HH:mm:ss.fff") + "\"");
|
|
localSB.Append(Delimiter + this.EndFileTime.ToString());
|
|
localSB.Append(Delimiter + this.OffsetFirstRecord.ToString());
|
|
localSB.Append(Delimiter + this.OffsetLastRecord.ToString());
|
|
localSB.Append(Delimiter + "\"" + this.ComputerName + "\"");
|
|
localSB.Append(Delimiter + this.Session);
|
|
localSB.Append(Delimiter + "\"" + this.PrevFileName + "\"");
|
|
localSB.Append(Delimiter + "\"" + this.HostFQDN + "\"");
|
|
|
|
returnValue = localSB.ToString();
|
|
}
|
|
catch (Exception ex)
|
|
{
|
|
LogException(ex);
|
|
returnValue = "";
|
|
}
|
|
|
|
return returnValue;
|
|
}
|
|
|
|
public string ToCSV()
|
|
{
|
|
return this.ToDelimitedString(',');
|
|
}
|
|
|
|
public string ToTSV()
|
|
{
|
|
return this.ToDelimitedString('\t');
|
|
}
|
|
|
|
#if NET45_OR_GREATER
|
|
private void LogException(Exception ex, [CallerMemberName]string methodName = "")
|
|
{
|
|
#else
|
|
[System.Runtime.CompilerServices.MethodImpl(System.Runtime.CompilerServices.MethodImplOptions.NoInlining)]
|
|
private void LogException(Exception ex)
|
|
{
|
|
string methodName = new System.Diagnostics.StackFrame(1, false).GetMethod().Name;
|
|
#endif
|
|
log.Error(string.Format("{0}: {1} - {2}", methodName, ex.GetType().Name, ex.Message), ex);
|
|
}
|
|
}
|
|
} |