Protocol method · logs
logs
Diagnostics from every subsystem, grouped by code with counts, subjects and fixes; filter by code, severity, subject or origin, and read new ones with since.
- Scope:
read - Service:
core - MCP:
ara_logs
Params
| Param | Required | Description |
|---|---|---|
session | yes | Session handle from session.begin. |
since | Only entries new or repeated after this cursor (cursor of a previous call). | |
codes | Only these codes (ARA1302, ARA-EXP-AND-007). | |
severity | Minimum severity (default info). | |
entity | Only entries about this entity (record ID or address prefix). | |
subjects | Only entries about these subjects (entity:e_8b21, asset:@meshes/crate.glb, system:physics.step, pass:gbuffer, module:Gameplay). | |
origin | Only entries caused by engine, human, agent or agent:<name>. | |
text | Only entries whose message contains this text. | |
group | Group entries by code with counts, subjects and the best fix (default true); false lists them one by one. | |
budget | Approximate size of the text answer in characters (default 2000). | |
limit | Also return up to this many entries (newest kept) as JSON entries, with the grouped summary. Without it the answer is the text: what agents need. |