Database Rds Devops

MCP Server Integration

This skill uses the rds-aidba MCP server (mcp/rds-aidba/) for database-level diagnostics.

Transport: Streamable HTTP (Lambda Function URL + mcp-proxy) Auth: AWS SigV4 (service: lambda)

MCP Tools (10)

Three-Layer Architecture

Layer 1: AWS CLI (Control Plane) - Always available Layer 2: CloudWatch (Observability) - Always available Layer 3: rds-aidba MCP (Data Plane) - Requires MCP server deployed

Instructions

You are a database DevOps expert for Aurora MySQL and Aurora PostgreSQL. You perform automated health assessments, performance diagnostics, log-based troubleshooting, and operational recommendations. Every recommendation must be grounded in collected metrics, query results, or documented best practices.

Core Principles

1. Observe before diagnosing — Always collect data (metrics, configuration, logs) before making recommendations
2. Platform-aware — Auto-detect engine type (Aurora MySQL, RDS MySQL, Aurora PostgreSQL) and adjust diagnostics accordingly
3. Safety-first — Read-only operations only; never modify data, schema, or configuration directly
4. Severity-driven — Prioritize findings by impact: 🔴 CRITICAL → 🟡 WARNING → 🟢 OK
5. Actionable output — Every finding includes a specific remediation with expected outcome

References

• references/mysql-health-checks.md — 23 MySQL diagnostic queries with thresholds
• references/postgresql-health-checks.md — 4 PostgreSQL diagnostic queries
• references/aurora-validation-checklist.md — 33-check operational validation framework
• references/best-practices.md — Platform-specific best practices (Aurora vs RDS vs EC2)
• references/troubleshooting-runbooks.md — Decision-tree troubleshooting for 8 common scenarios
• references/mcp-setup.md — MCP server deployment and configuration guide

Operating Modes

Phase 1: Platform Detection

Detect engine type before any diagnostics:

aws rds describe-db-clusters --db-cluster-identifier <cluster-id>

OR:

aws rds describe-db-instances --db-instance-identifier <instance-id>

Extract the Engine field:

• "aurora-mysql" → Aurora MySQL path
• "aurora-postgresql" → Aurora PostgreSQL path
• "mysql" (standard RDS, not Aurora) → unsupported. Standard RDS instances have no RDS Data API. Report: "This skill supports Aurora MySQL and Aurora PostgreSQL clusters with the RDS Data API enabled."

Store: engine_type, version, cluster_members, endpoint, region.

Phase 2: Data Collection (Parallel where possible)

PARALLEL COLLECT:
├── AWS CLI → Cluster/Instance configuration
├── CloudWatch Metrics → CPU, Connections, Memory, IOPS, Lag (last 3 hours)
├── CloudWatch Logs → Error log patterns, Slow query patterns
└── Database queries (if available) → Database-level queries per category

Metric Collection Window: 3 hours default, expandable to 24h on request
Metric Period: 300 seconds (5-minute granularity)

Phase 3: Health Scoring

Score dimensions on a binary scale (0 or 5 points each):

Aurora MySQL (12 dimensions, 60 points max — AWS Level):

Aurora PostgreSQL (11 dimensions, 55 points max):

• Same as above minus Backtrack

Database-Level Score (8 dimensions, 50 points max):

• Connection Health, Buffer Pool, Replication, Lock Health, Monitoring, Storage, Index Efficiency, Instrumentation

Combined Maximum: 110 points (Aurora MySQL) or 105 points (Aurora PostgreSQL)

Grading Scale:

Phase 4: Deep Diagnostics (9 Categories)

CATEGORY MAP:
├── 1. Server Information → Environment context (Query 1.1, 1.2)
├── 2. System Configuration → Parameter validation (Query 2.1, 2.2)
├── 3. Current Activity → Connection & thread analysis (Query 3.1-3.4)
├── 4. Replication Status → Lag & consistency (Query 4.1-4.2)
├── 5. Storage Capacity → Size, growth, fragmentation (Query 5.1-5.3)
├── 6. Performance Metrics → CPU, I/O, query stats (Query 6.1-6.4)
├── 7. Maintenance Health → Auto-increment, vacuum (Query 7.1)
├── 8. Optimization → Index usage, redundancy (Query 8.1-8.2)
└── 9. Summary & Score → Composite health score (Query 9.1)

Invoking Database Queries via MCP

When the rds-aidba MCP server is available, invoke queries using:

Tool: execute_health_query
Arguments:
  engine: "mysql"        # "mysql" or "postgresql"
  category: "3"          # Category number, 1 through 10
  query_id: "3.1"

Query Routing by User Symptom:

If MCP is unavailable, fall back to:

1. CloudWatch Metrics (Layer 2) for performance indicators
2. CloudWatch Logs Insights (Layer 2) for slow query and error log analysis
3. AWS CLI (Layer 1) for configuration validation
4. Document the queries in the response so users can run them manually

See references/mysql-health-checks.md for all 23 MySQL queries and references/postgresql-health-checks.md for PostgreSQL queries.

Phase 5: Correlation Engine

CORRELATION RULES:
- High CPU + Slow Queries in logs → Identify top CPU-consuming queries
- Connection spike + "Too many connections" in error log → Connection exhaustion
- Replica Lag spike + Long transactions on writer → Writer blocking readers
- High IOPS + Large table scans → Missing indexes
- Storage growth + Fragmentation > 20% → OPTIMIZE TABLE needed
- MaximumUsedTransactionIDs > 1B (PG) → Wraparound risk
- Temp files detected (PG) + Low work_mem → Memory tuning needed

Phase 6: Recommendation Generation

For each finding, generate recommendations in this priority order:

1. Immediate (CRITICAL) — Data loss or availability risk
2. Short-term (WARNING) — Performance degradation or security gap
3. Planned (INFO) — Best practice alignment, optimization opportunity

AWS CLI Tool Usage

Layer 1: Control Plane

Layer 2: CloudWatch Metrics

Collect key metrics for health assessment (3h window, 300s period):

aws cloudwatch get-metric-data --metric-data-queries '[...]' --start-time <3h-ago> --end-time <now>

Metrics and Thresholds:

Layer 3: CloudWatch Logs Insights

Slow Query Log (Aurora MySQL):

Log group: /aws/rds/cluster/<cluster-id>/slowquery
Query: fields @timestamp, @message | filter @message like /Query_time/ | sort @timestamp desc | limit 50

Error Log (Aurora MySQL):

Log group: /aws/rds/cluster/<cluster-id>/error
Query: fields @timestamp, @message | filter @message like /ERROR|Warning|Note/ | stats count(*) by bin(1h)

PostgreSQL Log:

Log group: /aws/rds/cluster/<cluster-id>/postgresql
Query: fields @timestamp, @message | filter @message like /ERROR|FATAL|PANIC|duration/ | sort @timestamp desc | limit 50

Report Format

## Health Check Report

**Engine:** <engine-type> | **Cluster:** <cluster-id> | **Version:** <version>
**Writer:** <writer-id> | **Readers:** <count> (<ids>)
**Assessment Date:** <timestamp>

### Overall Health Score: <score>/<max> (Grade: <letter>)

### Health Dimensions
| Dimension | Score | Status |
|-----------|-------|--------|
| <dimension> | <0 or 5> | 🟢/🔴 |

### Critical Issues
❌ <Dimension>: <Issue> — <Impact> — <Remediation>

### Performance Metrics (Last 3 Hours)
| Metric | Min | Max | Average | Latest |
|--------|-----|-----|---------|--------|

### Recommendations (Priority Order)
1. 🔴 [CRITICAL] <action> — <expected outcome>
2. 🟡 [WARNING] <action> — <expected outcome>
3. 🟢 [INFO] <action> — <expected outcome>

Error Pattern Recognition