framework_eng/skills/tool-usage/diagnostics/event-log-analysis/SKILL.md
Use for finding errors, events, and user actions in the registration log (RJ) via ClickHouse. Helps localize the time and context of a failure from the event log before turning to the tech log.
npx skillsauth add steelmorgan/1c-agent-based-dev-framework event-log-analysisInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
The RJ is a read-only source. Do not include raw entries in the output without masking personal data. By default, mode: "minimal".
For DBMS queries, locks, and platform exceptions, use tech-log-analysis.
| Trigger | Action |
|---------|----------|
| The user reports an error | First the latest Error, then a narrow time window |
| An error for a specific period | search_event_log with from/to |
| Auditing user actions | search_event_log with a user filter |
| Checking object changes | search_event_log with a metadata filter |
| Database state after tests | search_event_log with from: test_start_time, limit: 20 |
| Vanessa run failed | First the latest Error, if empty — without a level filter |
cluster_guid and infobase_guid from cluster_map.yaml.search_event_log with the required filters.records: event_time, event_presentation, comment, metadata_presentation.navigate_symbol to jump to the code.level: "Error" (without from/to when the exact time is unknown).from/to to ±15 minutes.tech-log-analysis.Timezone drift: local time and ClickHouse may differ; therefore, step 1 without a time filter is more reliable.
search_event_log(
cluster_guid: "...",
infobase_guid: "...",
from: "2025-02-11T13:00:00Z",
to: "2025-02-11T14:00:00Z",
level: "Error",
mode: "minimal",
limit: 100
)
| Situation | Conclusion |
|-----------|-------|
| No records | The database did not start / the RJ is unavailable |
| There are events, but Error is absent | The database is alive and the tests are running |
| The last event is a session end without errors | The tests completed successfully |
| There is an Error in event_presentation / comment | Analyze comment and metadata_presentation |
| Security warning | Move to visual diagnostics via GUI/screenshot |
After obtaining event_presentation and metadata_presentation:
metadata_presentation contains the name of a metadata object, call navigate_symbol to jump to the code.comment mentions an error text or a procedure name, search the codebase for the comment text.ОбщийМодуль.ОбработкаОшибок → ЗафиксироватьОшибку().If the comment field contains a session identifier, an HTTP request identifier, or a correlation id:
session=..., corrId=... or httpReq=....tech-log-analysis as filters (search_tech_log with session/corrId).The goal is to preserve correlation keys for the next step without mixing RJ and Tech Log analysis in a single query.
mode: "minimal".from/to to the minimum necessary period.| Capability | Purpose |
|------------|------------|
| search_event_log | Search the registration log (via ClickHouse) |
| navigate_symbol | Jump to code by metadata from an RJ entry |
| Error | Workaround |
|--------|---------------|
| GUIDs are not from cluster_map.yaml | Read the config; if it is missing, ask the user |
| ClickHouse is unavailable | Record the reason; suggest an alternative via the Tech Log |
| Time range is too wide — timeout | Narrow the window to 15–30 minutes; reduce limit |
| No errors in the RJ | Cascade: no level filter → narrow the window → Tech Log |
testing
MUST use BEFORE making a judgment about the cause of a conflict, a test failure, or an artifact dispute. Defines the end-to-end verification method L1→L6 and the classification of the first broken link.
development
MUST use AFTER a work cycle with ≥2 iterations (wrote → error → fixed → success). Provides the retrospective procedure and the format for recording practice/anti-patterns in references/learned-patterns.md or {project}/.context/learned-patterns.md.
tools
MUST use WHEN you are writing reusable knowledge into RLM (pattern / architectural decision / stable domain fact) OR reading it before a non-trivial task/solution in the domain. Provides the breakdown of native-push vs RLM-pull, tools for writing and reading RLM, H-MEM levels, and hygiene.
testing
MUST use WHEN the task is classified as simple (< 20 lines, 1 file, no new metadata objects, no architectural decisions). Provides a short cycle of 3 steps with a guard on the self path and mandatory verify.