pangu-rca 0.1.1

Pangu RCA CLI - AI-powered log analysis tool

Pangu RCA CLI

AI-powered log analysis tool for developers. Analyze error logs directly from your terminal.

Installation

pip install pangu-rca

Quick Start

# Analyze a log file
pangu-rca analyze error.log

# Analyze with English output
pangu-rca analyze error.log --lang en

# Pipe log content directly
cat error.log | pangu-rca analyze --stdin

# Get JSON output (for scripting)
pangu-rca analyze error.log --output json

# Check service health
pangu-rca health

Examples

Analyze a Java error log

$ pangu-rca analyze java_error.log

English version:

============================================================
🔍 Pangu RCA Agent - Analysis Result
============================================================

📋 Problem Type: Application Error
🎯 Confidence: 90.0%

📝 Detailed Reason:
   NullPointerException occurred during profile update request processing

🔑 Key Evidence:
   1. 2026-04-05 15:10:27 ERROR [http-nio-8080-exec-1] java.lang.NullPointerException: null
   2. 2026-04-05 15:10:27 ERROR [http-nio-8080-exec-1]     at com.example.UserService.updateProfile(UserService.java:145)
   3. 2026-04-05 15:10:27 WARN [http-nio-8080-exec-1] Request processing failed; nested exception is java.lang.NullPointerException

💡 Fix Suggestions:
   Review the UserService.updateProfile method at line 145 to identify potential null references. Add null checks and proper error handling to prevent similar issues.

Chinese version:

============================================================
🔍 Pangu RCA Agent - 分析结果
============================================================

📋 问题类型: 数据库连接超时
🎯 置信度: 95.0%

📝 详细原因:
   数据库连接池配置过小，导致在高并发场景下连接被耗尽...

🔑 关键证据:
   1. java.sql.SQLException: Connection timeout
   2. Caused by: java.sql.SQLTimeoutException: Timeout waiting for connection

💡 修复建议:
   增加数据库连接池的最大连接数，建议从 10 调整为 50...

Pipe from another command

# Analyze Docker container logs
docker logs my-container 2>&1 | pangu-rca analyze --stdin

# Analyze system logs
journalctl -u my-service --no-pager | pangu-rca analyze --stdin --lang en

Options

Option	Description	Default
--lang	Output language: zh or en	zh
--output	Output format: text or json	text
--api-url	Custom API endpoint	https://www.pangulab.com/api/analyze

Commands

• pangu-rca analyze <file> — Analyze a log file
• pangu-rca analyze --stdin — Read logs from stdin
• pangu-rca health — Check API service status
• pangu-rca --version — Show version
• pangu-rca --help — Show help

About

Pangu RCA Agent is an AI-powered log analysis tool that helps developers quickly identify root causes of errors from application logs. It supports Java, Python, Go, Rust, JavaScript, and many other programming languages.

Web version: https://www.pangulab.com

License

MIT