log-analysis

Search and analyze Breenix kernel logs for errors and checkpoints.

7|Updated Nov 21, 2015
One-click install
npx skills add https://github.com/ryanbreen/breenix --skill log-analysis
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: log-analysis
Source: https://github.com/ryanbreen/breenix/tree/main/breenix-log-analysis
Command: npx skills add https://github.com/ryanbreen/breenix --skill log-analysis

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Kernel logs are the primary window into system behavior, but manually sifting through verbose, timestamped output to find critical information can be time-consuming. This Skill provides efficient patterns and tools for searching, filtering, and analyzing Breenix kernel logs, enabling rapid debugging and verification.

Core Features & Use Cases

  • Targeted Log Search: Quickly find specific errors, panics, page faults, or checkpoint signals using grep or the find-in-logs script.
  • Execution Flow Tracing: Follow the kernel's boot sequence or specific subsystem initialization to understand behavior.
  • Error Context Extraction: Retrieve surrounding log lines to understand the context of a failure.
  • Use Case: Your latest kernel build is failing a test, and you need to understand why. Use this Skill to search the latest log for "PANIC" or "PAGE FAULT", extract the relevant lines with context, and trace the execution flow leading up to the error, quickly pinpointing the source of the problem.

Quick Start

Find panics in recent logs

echo '-i "panic"' > /tmp/log-query.txt ./scripts/find-in-logs

Find context around a test completion signal

echo '-A20 -B10 "KERNEL_POST_TESTS_COMPLETE"' > /tmp/log-query.txt ./scripts/find-in-logs

Directly grep for double faults with context

grep -A10 -B5 "Double Fault" logs/breenix_20250120_*.log

Frequently Asked Questions about log-analysis

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

FAQPage Schema
How do I search kernel logs for errors and panics?

Kernel log search uses grep-like patterns to locate errors, panics, and faults in timestamped Breenix logs. Use the find-in-logs script with flags like -i for case-insensitive matching, or grep directly on log files with context flags (-A, -B) to extract surrounding lines that reveal failure causes.

What's the best way to diagnose a kernel test failure?

Diagnose kernel test failures by searching logs for panic or fault signals, then extracting context lines before and after to trace execution flow. Checkpoint signals and subsystem initialization patterns reveal where the boot sequence broke, pinpointing the error source.

Can I trace kernel execution flow through logs?

Execution flow tracing follows the kernel's boot sequence and subsystem initialization by searching for checkpoint signals and timestamped log entries. Extract surrounding context to understand behavior progression and identify where execution diverged from expected patterns.

How do I extract context around a specific log event?

Extract surrounding context using grep with -A (after) and -B (before) flags, or the find-in-logs script with similar parameters. This reveals the events and system state leading up to and following a critical log entry like a panic or test-completion signal.

What file patterns do kernel logs follow in Breenix?

Breenix kernel logs follow timestamped file naming patterns like breenix_YYYYMMDD_*.log. Knowing these patterns enables efficient log location and targeted searches across multiple log files without manual path lookup.

Do I need special tools to analyze kernel logs beyond grep?

Basic grep handles most kernel log searches, but the find-in-logs script provides streamlined searching with support for scriptable patterns and checkpoint recognition. Both approaches work; the script adds convenience for repeated or complex queries.