LogViewer
A modern log viewer with AI-assisted analysis (Qt 6)
Loading...
Searching...
No Matches
ActorDiscoverer.hpp
Go to the documentation of this file.
1#pragma once
2
3#include "EventsContainer.hpp"
4
5#include <map>
6#include <set>
7#include <string>
8#include <vector>
9
10namespace analyzer
11{
12
13// ---------------------------------------------------------------------------
14// Exchange mode
15// ---------------------------------------------------------------------------
16
18enum class ExchangeMode
19{
22 Pair,
23
28
33
37
41};
42
43// ---------------------------------------------------------------------------
44// Exchange pattern
45// ---------------------------------------------------------------------------
46
49{
51
52 // ── Pair / ReceiverOnly / SenderOnly ──────────────────────────────────
53 std::string senderField;
54 std::string receiverField;
55 std::string labelField;
56
58 std::set<std::string> actors;
59
60 // ── DirectionField ────────────────────────────────────────────────────
61 std::string actorField;
62 std::string directionField;
63 std::set<std::string> outgoingValues;
64 std::set<std::string> incomingValues;
65
66 // ── PatternField ──────────────────────────────────────────────────────
67 std::string patternField;
68 std::string separator;
69 std::string extractionPattern;
70
71 // ── Metadata ──────────────────────────────────────────────────────────
72 int confidence {0};
73 std::string description;
74};
75
76// ---------------------------------------------------------------------------
77// Discovery result
78// ---------------------------------------------------------------------------
79
81{
84 std::vector<ExchangePattern> patterns;
85
87 std::vector<std::string> actorFields;
88
90 [[nodiscard]] const ExchangePattern* bestPattern() const
91 {
92 return patterns.empty() ? nullptr : &patterns.front();
93 }
94};
95
96// ---------------------------------------------------------------------------
97// Discoverer
98// ---------------------------------------------------------------------------
99
112{
113public:
116 size_t sampleLimit = 10'000);
117
121 size_t sampleLimit = 10'000);
122
123 // ── Exposed for unit tests ─────────────────────────────────────────────
124 static std::string ToLower(const std::string& s);
125 static int ScoreSender (const std::string& fieldName);
126 static int ScoreReceiver (const std::string& fieldName);
127 static int ScoreActor (const std::string& fieldName);
128 static int ScoreLabel (const std::string& fieldName);
131 static int ScoreDirection(const std::string& fieldName,
132 const std::set<std::string>& values,
133 std::set<std::string>& outValues,
134 std::set<std::string>& inValues);
135
139 static std::tuple<std::string, std::set<std::string>, int>
140 DetectSeparatorPattern(const std::set<std::string>& fieldValues);
141};
142
143} // namespace analyzer
Container class for managing collections of LogEvent objects.
Definition ActorDiscoverer.hpp:112
static int ScoreReceiver(const std::string &fieldName)
Definition ActorDiscoverer.cpp:73
static int ScoreActor(const std::string &fieldName)
Definition ActorDiscoverer.cpp:74
static std::string ToLower(const std::string &s)
Definition ActorDiscoverer.cpp:55
static std::tuple< std::string, std::set< std::string >, int > DetectSeparatorPattern(const std::set< std::string > &fieldValues)
Definition ActorDiscoverer.cpp:389
static int ScoreSender(const std::string &fieldName)
Definition ActorDiscoverer.cpp:72
static ActorDiscoveryResult Discover(db::EventsContainer &events, size_t sampleLimit=10 '000)
Scan up to sampleLimit events and return all discovered patterns.
Definition ActorDiscoverer.cpp:108
static int ScoreLabel(const std::string &fieldName)
Definition ActorDiscoverer.cpp:75
static ActorDiscoveryResult DiscoverWithAI(db::EventsContainer &events, size_t sampleLimit=10 '000)
Definition ActorDiscoverer.cpp:550
static int ScoreDirection(const std::string &fieldName, const std::set< std::string > &values, std::set< std::string > &outValues, std::set< std::string > &inValues)
Definition ActorDiscoverer.cpp:77
High-performance, thread-safe container for managing large collections of LogEvent objects.
Definition EventsContainer.hpp:129
Definition ActorDiscoverer.cpp:13
ExchangeMode
How actor send/receive relationships are encoded in the log.
Definition ActorDiscoverer.hpp:19
Definition ActorDiscoverer.hpp:81
const ExchangePattern * bestPattern() const
Convenience: returns the best pattern or nullptr.
Definition ActorDiscoverer.hpp:90
std::vector< std::string > actorFields
Actor-like fields that don't belong to any detected exchange pattern.
Definition ActorDiscoverer.hpp:87
std::vector< ExchangePattern > patterns
Definition ActorDiscoverer.hpp:84
Describes how actor-to-actor message flow can be read from the log events.
Definition ActorDiscoverer.hpp:49
std::set< std::string > actors
All unique actor names seen (union of sender + receiver values).
Definition ActorDiscoverer.hpp:58
std::string separator
Separator character/string (e.g., ":")
Definition ActorDiscoverer.hpp:68
std::string patternField
Field containing embedded actor names.
Definition ActorDiscoverer.hpp:67
std::set< std::string > outgoingValues
Values that mean "sending".
Definition ActorDiscoverer.hpp:63
ExchangeMode mode
Definition ActorDiscoverer.hpp:50
std::string extractionPattern
Regex pattern to extract actor (e.g., "([^:]+):")
Definition ActorDiscoverer.hpp:69
std::string labelField
Best field for message labels.
Definition ActorDiscoverer.hpp:55
std::string actorField
Field carrying the actor name.
Definition ActorDiscoverer.hpp:61
std::set< std::string > incomingValues
Values that mean "receiving".
Definition ActorDiscoverer.hpp:64
std::string senderField
Field carrying the sender name (empty in ReceiverOnly)
Definition ActorDiscoverer.hpp:53
std::string directionField
Field whose VALUE indicates direction.
Definition ActorDiscoverer.hpp:62
int confidence
Score used to rank candidates (higher = better)
Definition ActorDiscoverer.hpp:72
std::string receiverField
Field carrying the receiver name (empty in SenderOnly)
Definition ActorDiscoverer.hpp:54
std::string description
Human-readable summary shown in the Discover dialog.
Definition ActorDiscoverer.hpp:73