Log Analysis Tool

---
name: analyzing-logs
description: |
  This skill enables Claude to analyze logs for performance insights and issue detection. It is triggered when the user requests log analysis, performance troubleshooting, or debugging assistance. The skill identifies slow requests, error patterns, resource warnings, and other key performance indicators within log files. Use this skill when the user mentions "analyze logs", "performance issues", "error patterns in logs", "slow requests", or requests help with "log aggregation". It helps identify performance bottlenecks and improve application stability by analyzing log data.
allowed-tools: Read, Write, Bash, Grep
version: 1.0.0
---

## Overview

This skill empowers Claude to automatically analyze application logs, pinpoint performance bottlenecks, and identify recurring errors. It streamlines the debugging process and helps optimize application performance by extracting key insights from log data.

## How It Works

1. **Initiate Analysis**: Claude activates the log analysis tool upon detecting relevant trigger phrases.
2. **Log Data Extraction**: The tool extracts relevant data, including timestamps, request durations, error messages, and resource usage metrics.
3. **Pattern Identification**: The tool identifies patterns such as slow requests, frequent errors, and resource exhaustion warnings.
4. **Report Generation**: Claude presents a summary of findings, highlighting potential performance issues and optimization opportunities.

## When to Use This Skill

This skill activates when you need to:
- Identify performance bottlenecks in an application.
- Debug recurring errors and exceptions.
- Analyze log data for trends and anomalies.
- Set up structured logging or log aggregation.

## Examples

### Example 1: Identifying Slow Requests

User request: "Analyze logs for slow requests."

The skill will:
1. Activate the log analysis tool.
2. Identify requests exceeding predefined latency thresholds.
3. Present a list of slow requests with corresponding timestamps and durations.

### Example 2: Detecting Error Patterns

User request: "Find error patterns in the application logs."

The skill will:
1. Activate the log analysis tool.
2. Scan logs for recurring error messages and exceptions.
3. Group similar errors and present a summary of error frequencies.

## Best Practices

- **Log Level**: Ensure appropriate log levels (e.g., INFO, WARN, ERROR) are used to capture relevant information.
- **Structured Logging**: Implement structured logging (e.g., JSON format) to facilitate efficient analysis.
- **Log Rotation**: Configure log rotation policies to prevent log files from growing excessively.

## Integration

This skill can be integrated with other tools for monitoring and alerting. For example, it can be used in conjunction with a monitoring plugin to automatically trigger alerts based on log analysis results. It can also work with deployment tools to rollback deployments when critical errors are detected in the logs.