Skip to main content

Aws/alarms

@webframp/aws/alarmsv2026.05.20.1· 10d agoMODELS
01README

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
02Models1
@webframp/aws/alarmsv2026.03.30.1aws/alarms.ts
fn list_alarms()
List CloudWatch alarms with optional state and name prefix filters
fn get_active()
Get all alarms currently in ALARM state (convenience method)
fn get_history()
Get alarm state change history
fn get_summary()
Get a summary of all alarms including state counts and recent changes

Resources

alarm_list(30m)— List of CloudWatch alarms
alarm_history(1h)— Alarm state change history
alarm_summary(15m)— Summary of alarm states
03Previous Versions5
2026.04.22.1Apr 22, 2026

updated platforms

2026.04.14.1Apr 14, 2026
2026.04.13.1Apr 13, 2026
2026.03.31.1Mar 31, 2026
2026.03.30.1Mar 30, 2026
04Stats
A
100 / 100
Downloads
46
Archive size
273.0 KB
  • Has README or module doc2/2earned
  • README has a code example1/1earned
  • README is substantive1/1earned
  • Most symbols documented1/1earned
  • No slow types1/1earned
  • Has description1/1earned
  • Platform support declared (or universal)2/2earned
  • License declared1/1earned
  • Verified public repository2/2earned
05Platforms
06Labels