/plugadvpl:log-diagnose

Parse Protheus log files into timestamped events and match alert rules.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/JoniPraia/plugadvpl --skill plugadvpl-log-diagnose
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: /plugadvpl:log-diagnose
Source: https://github.com/JoniPraia/plugadvpl/tree/main/skills/log-diagnose
Command: npx skills add https://github.com/JoniPraia/plugadvpl --skill plugadvpl-log-diagnose

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you quickly understand what went wrong in Protheus by turning noisy console/error/profile/compilation logs into actionable findings with official correction tips, without manually reading huge log files.

Core Features & Use Cases

  • Event-based log parsing: Breaks logs into discrete events using recognized header formats (timestamp/thread/severity), preserving stacks and multi-line SQL dumps.
  • Recency-first rule matching: Applies 19 alert rules in reverse order to prioritize the most recent root-cause signals.
  • TDN correction tips enrichment: Attaches a correction tip and (when applicable) official TDN URLs from a catalog of 93 tips.
  • Targeted filtering: Supports filtering by severity, category, rule id, basename, and “since” window based on the log’s last timestamp.

Quick Start

Run /plugadvpl:log-diagnose on your Protheus log directory and review the resulting findings with correction suggestions and official TDN links.

Frequently Asked Questions about /plugadvpl:log-diagnose

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I diagnose Protheus errors from console.log and error.log files?

Diagnose Protheus logs by parsing timestamped events from console.log and error.log files, matching them against alert rules, and enriching outputs with TDN correction tips. It extracts root-cause signals from noisy multi-line logs to pinpoint compilation failures and thread errors.

What is the best way to find the root cause of Protheus compilation failures and thread errors?

Finding the root cause of Protheus compilation failures involves applying recency-first alert rules to parsed log events. This approach prioritizes the most recent error signals in compila.log files, helping you quickly identify underlying RPO or authentication problems.

Can I filter Protheus log diagnostics by severity and time window?

Filtering Protheus log diagnostics by severity, category, rule id, and time window is fully supported. You can set a since filter relative to the log's last timestamp to narrow down specific database or ORA issues during targeted troubleshooting.

Does Protheus log diagnostics support extracting events from multiple log formats?

Protheus log diagnostics supports extracting events from multiple log header formats across console, error, profile, and compila.log files. It preserves stacks and multi-line SQL dumps during two-stage parsing to ensure accurate REST API and network issue detection.

Why are my Protheus REST API startup errors not showing correct TDN tips?

REST API startup errors may miss TDN tips if the log header format is unrecognized during event parsing. Successful diagnosis requires matching parsed events against the 19 alert rules to properly attach applicable official TDN URLs from the 93-tip catalog.

What are the limitations of automated Protheus log triage?

Automated Protheus log triage relies on recognizing specific log header formats and 19 predefined alert rules. Logs with non-standard headers or novel error patterns outside the current TDN tip catalog may not yield enriched correction suggestions or actionable findings.