more features checks. setup improvements
This commit is contained in:
30
docs/features/checked/signals/runtime-agent-framework.md
Normal file
30
docs/features/checked/signals/runtime-agent-framework.md
Normal file
@@ -0,0 +1,30 @@
|
||||
# Runtime Agent Framework
|
||||
|
||||
## Module
|
||||
Signals
|
||||
|
||||
## Status
|
||||
VERIFIED
|
||||
|
||||
## Description
|
||||
Full runtime agent framework with IRuntimeAgent interface, .NET EventPipe agent, CLR method resolution, agent registration, health/heartbeat, runtime method events, and facts ingestion is implemented.
|
||||
|
||||
## Implementation Details
|
||||
- **Modules**: `src/Signals/StellaOps.Signals.RuntimeAgent/`
|
||||
- **Key Classes**:
|
||||
- `RuntimeAgentBase` (`src/Signals/StellaOps.Signals.RuntimeAgent/RuntimeAgentBase.cs`) - abstract base class for runtime agents
|
||||
- `DotNetEventPipeAgent` (`src/Signals/StellaOps.Signals.RuntimeAgent/DotNetEventPipeAgent.cs`) - .NET EventPipe-based runtime agent for method-level tracing
|
||||
- `ClrMethodResolver` (`src/Signals/StellaOps.Signals.RuntimeAgent/ClrMethodResolver.cs`) - resolves CLR method tokens to fully qualified method names
|
||||
- `AgentRegistrationService` (`src/Signals/StellaOps.Signals.RuntimeAgent/AgentRegistrationService.cs`) - handles agent registration and health/heartbeat
|
||||
- `RuntimeFactsIngestService` (`src/Signals/StellaOps.Signals.RuntimeAgent/RuntimeFactsIngestService.cs`) - ingests runtime method events as reachability facts
|
||||
- `RuntimeAgentController` (`src/Signals/StellaOps.Signals/Api/RuntimeAgentController.cs`) - API controller for agent management
|
||||
- **Interfaces**: `IRuntimeAgent`, `IAgentRegistrationService`, `IRuntimeFactsIngest`
|
||||
- **Source**: Feature matrix scan
|
||||
|
||||
## E2E Test Plan
|
||||
- [ ] Register a runtime agent via `AgentRegistrationService` and verify it appears in the registry
|
||||
- [ ] Start `DotNetEventPipeAgent` and verify it captures method-level events from a target process
|
||||
- [ ] Verify `ClrMethodResolver` resolves method tokens to fully qualified names
|
||||
- [ ] Verify `RuntimeFactsIngestService` processes runtime events and produces reachability facts
|
||||
- [ ] Verify agent heartbeat: confirm the agent sends periodic health signals
|
||||
- [ ] Manage agents via `RuntimeAgentController` API endpoints
|
||||
Reference in New Issue
Block a user