Aws/alarms

Query and analyze CloudWatch Alarms for operational visibility and incident response.

Authentication

Uses the default AWS credential chain. Requires CloudWatch permissions.

Required IAM Permissions

• cloudwatch:DescribeAlarms
• cloudwatch:DescribeAlarmHistory

Usage

# Create alarms model
swamp model create @webframp/aws/alarms aws-alarms --global-arg region=us-east-1

# List all alarms
swamp model method run aws-alarms list_alarms

# List alarms in ALARM state
swamp model method run aws-alarms list_alarms --input stateValue=ALARM

# Get active alarms (convenience method)
swamp model method run aws-alarms get_active

# Get alarm history for last 24 hours
swamp model method run aws-alarms get_history --input startTime=24h

# Get history for a specific alarm
swamp model method run aws-alarms get_history --input alarmName=my-alarm --input startTime=7d

# Get alarm summary with state counts and recent changes
swamp model method run aws-alarms get_summary --input historyHours=6

Time Formats

The startTime and endTime parameters accept:

• Relative times: 30m, 1h, 2d (minutes, hours, days ago)
• ISO 8601 dates: 2026-03-30T12:00:00Z

Methods

• list_alarms - List alarms with optional state and prefix filters
• get_active - Get all alarms currently in ALARM state
• get_history - Get alarm state change history
• get_summary - Get summary with state counts and recent changes

2026.07.30.1

Added: Optional profile global argument for multi-account credential resolution. When set, credentials resolve via fromIni (supports SSO token cache and shared-config profiles). When omitted, the default credential chain applies as before. Fully backward compatible — no changes required for existing instances.