home / skills / jeremylongshore / claude-code-plugins-plus-skills / analyzing-system-throughput

analyzing-system-throughput skill

safe

/plugins/performance/throughput-analyzer/skills/analyzing-system-throughput

This skill analyzes system throughput and recommends optimization and scaling strategies to increase capacity and reduce bottlenecks.

npx playbooks add skill jeremylongshore/claude-code-plugins-plus-skills --skill analyzing-system-throughput

Review the files below or copy the command above to add this skill to your agents.

Files (7)

SKILL.md

4.0 KB

---
name: analyzing-system-throughput
description: Analyze and optimize system throughput including request handling, data processing, and resource utilization. Use when identifying capacity limits or evaluating scaling strategies. Trigger with phrases like "analyze throughput", "optimize capacity", or "identify bottlenecks".
version: 1.0.0
allowed-tools: "Read, Write, Bash(performance:*), Bash(monitoring:*), Grep"
license: MIT
author: Jeremy Longshore <[email protected]>
---
# Throughput Analyzer

This skill provides automated assistance for throughput analyzer tasks.

## Overview

This skill allows Claude to analyze system performance and identify areas for throughput optimization. It uses the `throughput-analyzer` plugin to provide insights into request handling, data processing, and resource utilization.

## How It Works

1. **Identify Critical Components**: Determines which system components are most relevant to throughput.
2. **Analyze Throughput Metrics**: Gathers and analyzes current throughput metrics for the identified components.
3. **Identify Limiting Factors**: Pinpoints the bottlenecks and constraints that are hindering optimal throughput.
4. **Evaluate Scaling Strategies**: Explores potential scaling strategies and their impact on overall throughput.

## When to Use This Skill

This skill activates when you need to:
- Analyze system throughput to identify performance bottlenecks.
- Optimize system performance for increased capacity.
- Evaluate scaling strategies to improve throughput.

## Examples

### Example 1: Analyzing Web Server Throughput

User request: "Analyze the throughput of my web server and identify any bottlenecks."

The skill will:
1. Activate the `throughput-analyzer` plugin.
2. Analyze request throughput, data throughput, and resource saturation of the web server.
3. Provide a report identifying potential bottlenecks and optimization opportunities.

### Example 2: Optimizing Data Processing Pipeline

User request: "Optimize the throughput of my data processing pipeline."

The skill will:
1. Activate the `throughput-analyzer` plugin.
2. Analyze data throughput, queue processing, and concurrency limits of the data processing pipeline.
3. Suggest improvements to increase data processing rates and overall throughput.

## Best Practices

- **Component Selection**: Focus the analysis on the most throughput-critical components to avoid unnecessary overhead.
- **Metric Interpretation**: Carefully interpret throughput metrics to accurately identify limiting factors.
- **Scaling Evaluation**: Thoroughly evaluate the potential impact of scaling strategies before implementation.

## Integration

This skill can be used in conjunction with other monitoring and performance analysis tools to gain a more comprehensive understanding of system behavior. It provides a starting point for further investigation and optimization efforts.

## Prerequisites

- Access to throughput metrics in {baseDir}/metrics/throughput/
- System performance monitoring tools
- Historical throughput baselines
- Current capacity and scaling limits

## Instructions

1. Identify critical system components for throughput analysis
2. Collect request and data throughput metrics
3. Analyze resource saturation and queue depths
4. Identify bottlenecks and limiting factors
5. Evaluate horizontal and vertical scaling strategies
6. Generate capacity planning recommendations

## Output

- Throughput analysis reports with current capacity
- Bottleneck identification and root cause analysis
- Resource saturation metrics
- Scaling strategy recommendations
- Capacity planning projections

## Error Handling

If throughput analysis fails:
- Verify metrics collection infrastructure
- Check system monitoring tool access
- Validate historical baseline data
- Ensure performance testing environment
- Review component identification logic

## Resources

- Throughput optimization best practices
- Capacity planning methodologies
- Scaling strategy comparison guides
- Performance bottleneck detection techniques

Overview

This skill analyzes system throughput across request handling, data processing, and resource utilization to identify capacity limits and optimization opportunities. It produces actionable findings such as bottleneck locations, resource saturation metrics, and capacity projections. Use it to evaluate current performance and to inform scaling or tuning decisions.

How this skill works

The skill identifies the most throughput-critical components and collects request, data, and resource metrics from your monitoring sources. It analyzes throughput trends, queue depths, and concurrency limits to pinpoint limiting factors and root causes. Finally it evaluates horizontal and vertical scaling options and produces capacity planning recommendations and trade-offs.

When to use it

You need to identify performance bottlenecks affecting user-facing latency or throughput.
You are planning capacity changes and want data-driven scaling options.
You want to improve data pipeline processing rates or reduce queue buildup.
You need to validate whether resource limits (CPU, memory, I/O) cause throughput loss.
You want a prioritized list of optimizations before a load or release event.

Best practices

Focus analysis on the highest-impact components to limit scope and reduce noise.
Use recent and historical baselines to separate transient issues from systemic limits.
Combine throughput metrics with resource saturation and queue depth for accurate root-cause analysis.
Evaluate both horizontal and vertical scaling; include cost and operational complexity in trade-offs.
Validate suggested changes in a staging environment and re-run throughput tests to confirm gains.

Example use cases

Analyze a web server cluster to find whether request queuing, database saturation, or network I/O limits throughput.
Optimize a batch or streaming data pipeline by identifying slow stages, backpressure points, and concurrency ceilings.
Evaluate autoscaling rules and instance sizes to recommend a cost-effective scaling strategy for expected peak load.
Produce a capacity projection and deployment checklist ahead of a major marketing campaign or product launch.
Diagnose a sudden drop in throughput after a platform change and produce remediation steps.

FAQ

What inputs are required for a useful analysis?

Recent throughput metrics, historical baselines, and access to resource monitoring (CPU, memory, I/O, network, queue depths) are required for an accurate analysis.

Can this skill recommend both horizontal and vertical scaling?

Yes. The skill evaluates pros and cons of adding instances, increasing instance size, and tuning concurrency to recommend the best trade-offs for performance and cost.