Skip to main content

Aws/logs

@webframp/aws/logsv2026.04.22.1· 8d agoMODELS
01README

Query and analyze CloudWatch Logs for operational visibility and incident investigation.

Authentication

Uses the default AWS credential chain. Requires CloudWatch Logs permissions.

Required IAM Permissions

  • logs:DescribeLogGroups
  • logs:StartQuery
  • logs:GetQueryResults
  • logs:FilterLogEvents

Usage

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

# List log groups
swamp model method run aws-logs list_log_groups --input prefix=/aws/lambda

# Run a Logs Insights query
swamp model method run aws-logs query \
  --input 'logGroupNames=["/aws/lambda/my-function"]' \
  --input 'queryString=fields @timestamp, @message | filter @message like /error/i | limit 50' \
  --input startTime=1h

# Find error patterns
swamp model method run aws-logs find_errors \
  --input 'logGroupNames=["/aws/lambda/my-function"]' \
  --input startTime=2h

# Get recent events with filter
swamp model method run aws-logs get_recent_events \
  --input logGroupName=/aws/lambda/my-function \
  --input filterPattern=ERROR

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_log_groups - Discover log groups by prefix
  • query - Run CloudWatch Logs Insights queries
  • find_errors - Analyze error patterns with keyword detection
  • get_recent_events - Filter recent log events
02Models1
@webframp/aws/logsv2026.03.30.1aws/logs.ts
fn list_log_groups()
List CloudWatch log groups with optional prefix filter
fn query()
Run a CloudWatch Logs Insights query
fn find_errors()
Find and analyze error patterns in log groups using common error keywords
fn get_recent_events(logGroupName: string)
Get recent log events from a log group using filter
ArgumentTypeDescription
logGroupNamestringLog group name

Resources

log_groups(1h)— List of CloudWatch log groups
query_results(1d)— Results from a Logs Insights query
error_analysis(1d)— Error pattern analysis results
03Previous Versions3
2026.04.13.1Apr 13, 2026
2026.03.31.1Mar 31, 2026
2026.03.30.1Mar 30, 2026
04Stats
A
100 / 100
Downloads
18
Archive size
235.9 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
  • At least one platform tag (or universal)1/1earned
  • Two or more platform tags (or universal)1/1earned
  • License declared1/1earned
  • Verified public repository2/2earned
05Platforms
06Labels