Files
wwtools/aalogcli/lib/build/patched/LogHeader.cs
T
Joseph Doherty 32f26272ae Initial commit: Wonderware / System Platform tools and reference
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>
2026-05-03 18:22:20 -04:00

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);
}
}
}