cloudthinker-ai/CloudSkills / skills/connections/aws-elasticache-deep
aws-elasticache-deep
VerifiedUse when working with Aws Elasticache Deep — aWS ElastiCache deep analysis for Redis and Memcached clusters, replication health, failover analysis, and performance metrics. Covers node-level metrics, memory utilization, cache hit rates, eviction tracking, connection analysis, and engine-specific diagnostics.
AWS ElastiCache Deep Skill
Deep analysis of AWS ElastiCache Redis and Memcached clusters with parallel execution and anti-hallucination guardrails.
Relationship to other AWS skills:
aws-elasticache-deep/→ ElastiCache-specific deep analysis (replication, failover, engine metrics)aws/→ "How to execute" (parallel patterns, throttling, output format)
CRITICAL: Parallel Execution Requirement
ALL independent operations MUST run in parallel using background jobs (&) and wait.
#!/bin/bash
export AWS_PAGER=""
for cluster in $clusters; do
get_cluster_metrics "$cluster" &
done
wait
Helper Functions
#!/bin/bash
export AWS_PAGER=""
# List replication groups (Redis)
list_replication_groups() {
aws elasticache describe-replication-groups \
--output text \
--query 'ReplicationGroups[].[ReplicationGroupId,Status,ClusterEnabled,AutomaticFailover,MultiAZ,NodeGroups[0].NodeGroupMembers[0].CacheNodeId]'
}
# List cache clusters
list_cache_clusters() {
aws elasticache describe-cache-clusters --show-cache-node-info \
--output text \
--query 'CacheClusters[].[CacheClusterId,Engine,EngineVersion,CacheNodeType,NumCacheNodes,CacheClusterStatus,ReplicationGroupId]'
}
# Get cluster metrics
get_cluster_metrics() {
local cluster_id=$1 days=${2:-1}
local end_time start_time
end_time=$(date -u +"%Y-%m-%dT%H:%M:%S")
start_time=$(date -u -d "$days days ago" +"%Y-%m-%dT%H:%M:%S" 2>/dev/null || date -u -v-${days}d +"%Y-%m-%dT%H:%M:%S")
aws cloudwatch get-metric-statistics \
--namespace AWS/ElastiCache --metric-name CPUUtilization \
--dimensions Name=CacheClusterId,Value="$cluster_id" \
--start-time "$start_time" --end-time "$end_time" \
--period $((days * 86400)) --statistics Average Maximum \
--output text --query "Datapoints[0].[\"$cluster_id\",\"CPU\",Average,Maximum]" &
aws cloudwatch get-metric-statistics \
--namespace AWS/ElastiCache --metric-name DatabaseMemoryUsagePercentage \
--dimensions Name=CacheClusterId,Value="$cluster_id" \
--start-time "$start_time" --end-time "$end_time" \
--period $((days * 86400)) --statistics Average Maximum \
--output text --query "Datapoints[0].[\"$cluster_id\",\"Memory\",Average,Maximum]" &
aws cloudwatch get-metric-statistics \
--namespace AWS/ElastiCache --metric-name CacheHitRate \
--dimensions Name=CacheClusterId,Value="$cluster_id" \
--start-time "$start_time" --end-time "$end_time" \
--period $((days * 86400)) --statistics Average \
--output text --query "Datapoints[0].[\"$cluster_id\",\"HitRate\",Average]" &
aws cloudwatch get-metric-statistics \
--namespace AWS/ElastiCache --metric-name Evictions \
--dimensions Name=CacheClusterId,Value="$cluster_id" \
--start-time "$start_time" --end-time "$end_time" \
--period $((days * 86400)) --statistics Sum \
--output text --query "Datapoints[0].[\"$cluster_id\",\"Evictions\",Sum]" &
wait
}
# Get replication lag (Redis)
get_replication_lag() {
local cluster_id=$1
local end_time start_time
end_time=$(date -u +"%Y-%m-%dT%H:%M:%S")
start_time=$(date -u -d "1 hour ago" +"%Y-%m-%dT%H:%M:%S" 2>/dev/null || date -u -v-1H +"%Y-%m-%dT%H:%M:%S")
aws cloudwatch get-metric-statistics \
--namespace AWS/ElastiCache --metric-name ReplicationLag \
--dimensions Name=CacheClusterId,Value="$cluster_id" \
--start-time "$start_time" --end-time "$end_time" \
--period 300 --statistics Average Maximum \
--output text --query 'Datapoints[*].[Timestamp,Average,Maximum]' | sort -k1 | tail -5
}
Common Operations
1. Cluster Inventory with Engine Details
#!/bin/bash
export AWS_PAGER=""
aws elasticache describe-cache-clusters --show-cache-node-info \
--output text \
--query 'CacheClusters[].[CacheClusterId,Engine,EngineVersion,CacheNodeType,NumCacheNodes,CacheClusterStatus,PreferredMaintenanceWindow]' | sort -k2
2. Replication Health (Redis)
#!/bin/bash
export AWS_PAGER=""
aws elasticache describe-replication-groups \
--output text \
--query 'ReplicationGroups[].[ReplicationGroupId,Status,ClusterEnabled,AutomaticFailover,MultiAZ,MemberClusters[]]'
# Check replication lag for all replica nodes
REPLICAS=$(aws elasticache describe-cache-clusters --output text \
--query 'CacheClusters[?Engine==`redis`].CacheClusterId')
END=$(date -u +"%Y-%m-%dT%H:%M:%S")
START=$(date -u -d "1 hour ago" +"%Y-%m-%dT%H:%M:%S" 2>/dev/null || date -u -v-1H +"%Y-%m-%dT%H:%M:%S")
for replica in $REPLICAS; do
aws cloudwatch get-metric-statistics \
--namespace AWS/ElastiCache --metric-name ReplicationLag \
--dimensions Name=CacheClusterId,Value="$replica" \
--start-time "$START" --end-time "$END" \
--period 300 --statistics Average Maximum \
--output text --query "Datapoints[-1].[\"$replica\",Average,Maximum]" &
done
wait
3. Memory and Eviction Analysis
#!/bin/bash
export AWS_PAGER=""
END=$(date -u +"%Y-%m-%dT%H:%M:%S")
START=$(date -u -d "1 day ago" +"%Y-%m-%dT%H:%M:%S" 2>/dev/null || date -u -v-1d +"%Y-%m-%dT%H:%M:%S")
CLUSTERS=$(aws elasticache describe-cache-clusters --output text --query 'CacheClusters[].CacheClusterId')
for cluster in $CLUSTERS; do
{
mem=$(aws cloudwatch get-metric-statistics \
--namespace AWS/ElastiCache --metric-name DatabaseMemoryUsagePercentage \
--dimensions Name=CacheClusterId,Value="$cluster" \
--start-time "$START" --end-time "$END" \
--period 86400 --statistics Average Maximum \
--output text --query 'Datapoints[0].[Average,Maximum]')
evictions=$(aws cloudwatch get-metric-statistics \
--namespace AWS/ElastiCache --metric-name Evictions \
--dimensions Name=CacheClusterId,Value="$cluster" \
--start-time "$START" --end-time "$END" \
--period 86400 --statistics Sum \
--output text --query 'Datapoints[0].Sum')
printf "%s\tMem:%s\tEvictions:%s\n" "$cluster" "$mem" "${evictions:-0}"
} &
done
wait
4. Cache Hit Rate Analysis
#!/bin/bash
export AWS_PAGER=""
END=$(date -u +"%Y-%m-%dT%H:%M:%S")
START=$(date -u -d "7 days ago" +"%Y-%m-%dT%H:%M:%S" 2>/dev/null || date -u -v-7d +"%Y-%m-%dT%H:%M:%S")
CLUSTERS=$(aws elasticache describe-cache-clusters --output text --query 'CacheClusters[].CacheClusterId')
for cluster in $CLUSTERS; do
{
hits=$(aws cloudwatch get-metric-statistics \
--namespace AWS/ElastiCache --metric-name CacheHits \
--dimensions Name=CacheClusterId,Value="$cluster" \
--start-time "$START" --end-time "$END" \
--period 604800 --statistics Sum \
--output text --query 'Datapoints[0].Sum')
misses=$(aws cloudwatch get-metric-statistics \
--namespace AWS/ElastiCache --metric-name CacheMisses \
--dimensions Name=CacheClusterId,Value="$cluster" \
--start-time "$START" --end-time "$END" \
--period 604800 --statistics Sum \
--output text --query 'Datapoints[0].Sum')
printf "%s\tHits:%s\tMisses:%s\n" "$cluster" "${hits:-0}" "${misses:-0}"
} &
done
wait
5. Connection Count Monitoring
#!/bin/bash
export AWS_PAGER=""
END=$(date -u +"%Y-%m-%dT%H:%M:%S")
START=$(date -u -d "1 day ago" +"%Y-%m-%dT%H:%M:%S" 2>/dev/null || date -u -v-1d +"%Y-%m-%dT%H:%M:%S")
CLUSTERS=$(aws elasticache describe-cache-clusters --output text --query 'CacheClusters[].CacheClusterId')
for cluster in $CLUSTERS; do
aws cloudwatch get-metric-statistics \
--namespace AWS/ElastiCache --metric-name CurrConnections \
--dimensions Name=CacheClusterId,Value="$cluster" \
--start-time "$START" --end-time "$END" \
--period 3600 --statistics Average Maximum \
--output text --query "Datapoints[-1].[\"$cluster\",Average,Maximum]" &
done
wait
Anti-Hallucination Rules
- Redis vs Memcached metrics - ReplicationLag only applies to Redis. CacheHitRate calculation differs between engines. Always check the engine type first.
- EngineCPUUtilization vs CPUUtilization - For Redis, use
EngineCPUUtilizationfor the Redis process CPU.CPUUtilizationincludes OS overhead. For Memcached with multiple cores,CPUUtilizationmay underreport per-core usage. - DatabaseMemoryUsagePercentage - This is Redis-only. For Memcached, use
BytesUsedForCacheItemsdivided bymaxmemory. - Cluster mode enabled vs disabled - Redis cluster mode (sharded) uses
NodeGroupswith multiple shards. Non-cluster mode has one shard with primary/replicas. - Failover requires Multi-AZ - Automatic failover only works with Multi-AZ enabled on the replication group. Check
AutomaticFailoverandMultiAZfields.
Output Format
Present results as a structured report:
Aws Elasticache Deep Report
═══════════════════════════
Resources discovered: [count]
Resource Status Key Metric Issues
──────────────────────────────────────────────
[name] [ok/warn] [value] [findings]
Summary: [total] resources | [ok] healthy | [warn] warnings | [crit] critical
Action Items: [list of prioritized findings]
Target ≤50 lines of output. Use tables for multi-resource comparisons.
Counter-Rationalizations
| Shortcut | Counter | Why |
|---|---|---|
| "I'll skip discovery and check known resources" | Always run Phase 1 discovery first | Resource names change, new resources appear — assumed names cause errors |
| "The user only asked for a quick check" | Follow the full discovery → analysis flow | Quick checks miss critical issues; structured analysis catches silent failures |
| "Default configuration is probably fine" | Audit configuration explicitly | Defaults often leave logging, security, and optimization features disabled |
| "Metrics aren't needed for this" | Always check relevant metrics when available | API/CLI responses show current state; metrics reveal trends and intermittent issues |
| "I don't have access to that" | Try the command and report the actual error | Assumed permission failures prevent useful investigation; actual errors are informative |
Common Pitfalls
- Node type naming: ElastiCache uses
cache.prefix (e.g.,cache.r6g.large), not the EC2 naming convention. - Reserved node pricing: ElastiCache RIs are separate from EC2 RIs. Check with
describe-reserved-cache-nodes. - Maintenance windows: During maintenance, nodes may be temporarily unavailable. Check
PreferredMaintenanceWindow. - CloudWatch statistics syntax: Use spaces not commas:
--statistics Average Maximum. - Snapshot retention: Automatic backups (Redis only) retain snapshots for a configurable period. Check
SnapshotRetentionLimit.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| writing-skillsobra/superpowersUse when creating new skills, editing existing skills, or verifying skills work before deployment | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |
| xlsxanthropics/skillsUse this skill any time a spreadsheet file is the primary input or output. This means any task where the user wants to: open, read, edit, or fix an existing .xlsx, .xlsm, .xltx, .csv, or .tsv file (e.g., adding columns, computing formulas, formatting, charting, cleaning messy data); create a new spreadsheet from scratch or from other data sources; or convert between tabular file formats. Trigger especially when the user references a spreadsheet file by name or path — even casually (like "the xlsx in my downloads") — and wants something done to it or produced from it. Also trigger for cleaning or restructuring messy tabular data files (malformed rows, misplaced headers, junk data) into proper spreadsheets. The deliverable must be a spreadsheet file. Do NOT trigger when the primary deliverable is a Word document, HTML report, standalone Python script, database pipeline, or Google Sheets API integration, even if tabular data is involved. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| shipping-and-launchaddyosmani/agent-skillsPrepares production launches. Use when preparing to deploy to production, or when asking what needs to be in place before shipping. Use when you need a pre-launch checklist, when setting up monitoring, when planning a staged rollout, or when you need a rollback strategy. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |
| childhoodthedotmack/claude-memBabysit a shipped release after merge, publication, or deployment. Verify published packages, production behavior, installed plugins, and late CI or user reports until the observation window is clean; use babysit for PR readiness before release. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |