Observability

CloudWatch Logs

Protocol: JSON 1.1 (X-Amz-Target: Logs.*)
Endpoint: POST http://localhost:4566/ CloudWatch Logs supports log groups, log streams, event ingestion, retention policies, filtering, and tagging.

CloudWatch Logs operations (14)

Action	Description
`CreateLogGroup`	Create a log group
`DeleteLogGroup`	Delete a log group
`DescribeLogGroups`	List log groups
`CreateLogStream`	Create a log stream inside a log group
`DeleteLogStream`	Delete a log stream
`DescribeLogStreams`	List log streams in a group
`PutLogEvents`	Write log events to a stream
`GetLogEvents`	Read log events from a stream
`FilterLogEvents`	Search log events with a filter pattern
`PutRetentionPolicy`	Set log retention (days)
`DeleteRetentionPolicy`	Remove log retention policy
`TagLogGroup`	Tag a log group
`UntagLogGroup`	Remove tags
`ListTagsLogGroup`	List tags

Configuration

floci:
  services:
    cloudwatchlogs:
      enabled: true
      max-events-per-query: 10000

Examples

export AWS_ENDPOINT=http://localhost:4566

# Create a log group and stream
aws logs create-log-group --log-group-name /app/backend --endpoint-url $AWS_ENDPOINT
aws logs create-log-stream \
  --log-group-name /app/backend \
  --log-stream-name 2025/01/app-1 \
  --endpoint-url $AWS_ENDPOINT

# Write log events
TIMESTAMP=$(date +%s%3N)   # milliseconds
aws logs put-log-events \
  --log-group-name /app/backend \
  --log-stream-name 2025/01/app-1 \
  --log-events "[{\"timestamp\":$TIMESTAMP,\"message\":\"Service started\"}]" \
  --endpoint-url $AWS_ENDPOINT

# Read log events
aws logs get-log-events \
  --log-group-name /app/backend \
  --log-stream-name 2025/01/app-1 \
  --endpoint-url $AWS_ENDPOINT

# Search logs
aws logs filter-log-events \
  --log-group-name /app/backend \
  --filter-pattern "ERROR" \
  --endpoint-url $AWS_ENDPOINT

# Set retention
aws logs put-retention-policy \
  --log-group-name /app/backend \
  --retention-in-days 30 \
  --endpoint-url $AWS_ENDPOINT

CloudWatch Metrics

Protocol: Query (XML) and JSON 1.1 (both supported)
Endpoint: POST http://localhost:4566/ CloudWatch Metrics supports publishing custom metrics, querying statistics, and managing alarms.

CloudWatch Metrics operations (8)

Action	Description
`PutMetricData`	Publish custom metrics
`ListMetrics`	List available metrics
`GetMetricStatistics`	Get metric statistics (Average, Sum, etc.)
`GetMetricData`	Query metrics with math expressions
`PutMetricAlarm`	Create a metric alarm
`DescribeAlarms`	List alarms
`DeleteAlarms`	Delete alarms
`SetAlarmState`	Manually set alarm state

Examples

export AWS_ENDPOINT=http://localhost:4566

# Publish a custom metric
aws cloudwatch put-metric-data \
  --namespace MyApp \
  --metric-data '[{
    "MetricName": "RequestCount",
    "Value": 42,
    "Unit": "Count",
    "Dimensions": [{"Name":"Service","Value":"api"}]
  }]' \
  --endpoint-url $AWS_ENDPOINT

# List metrics
aws cloudwatch list-metrics \
  --namespace MyApp \
  --endpoint-url $AWS_ENDPOINT

# Get statistics
aws cloudwatch get-metric-statistics \
  --namespace MyApp \
  --metric-name RequestCount \
  --dimensions Name=Service,Value=api \
  --start-time $(date -u -v-1H +%Y-%m-%dT%H:%M:%SZ) \
  --end-time $(date -u +%Y-%m-%dT%H:%M:%SZ) \
  --period 300 \
  --statistics Sum \
  --endpoint-url $AWS_ENDPOINT

# Create an alarm
aws cloudwatch put-metric-alarm \
  --alarm-name high-error-rate \
  --metric-name ErrorCount \
  --namespace MyApp \
  --statistic Sum \
  --period 60 \
  --threshold 10 \
  --comparison-operator GreaterThanThreshold \
  --evaluation-periods 1 \
  --endpoint-url $AWS_ENDPOINT

Step Functions

Protocol: JSON 1.1 (X-Amz-Target: AmazonStatesService.*)
Endpoint: POST http://localhost:4566/ Step Functions supports Standard and Express state machines with full ASL execution, task token callbacks, and execution history.

Step Functions operations (12)

Action	Description
`CreateStateMachine`	Create a state machine (Standard or Express)
`DescribeStateMachine`	Get state machine definition and metadata
`ListStateMachines`	List all state machines
`DeleteStateMachine`	Delete a state machine
`StartExecution`	Start a new execution
`DescribeExecution`	Get execution status and output
`ListExecutions`	List executions for a state machine
`StopExecution`	Stop a running execution
`GetExecutionHistory`	Get the full event history of an execution
`SendTaskSuccess`	Report task success (for `.waitForTaskToken` tasks)
`SendTaskFailure`	Report task failure
`SendTaskHeartbeat`	Send a heartbeat for long-running tasks

Examples

export AWS_ENDPOINT=http://localhost:4566

# Create a state machine
SM_ARN=$(aws stepfunctions create-state-machine \
  --name my-workflow \
  --definition '{
    "Comment": "Simple workflow",
    "StartAt": "HelloWorld",
    "States": {
      "HelloWorld": {
        "Type": "Pass",
        "Result": {"message": "Hello, World!"},
        "End": true
      }
    }
  }' \
  --role-arn arn:aws:iam::000000000000:role/step-functions-role \
  --query stateMachineArn --output text \
  --endpoint-url $AWS_ENDPOINT)

# Start an execution
EXEC_ARN=$(aws stepfunctions start-execution \
  --state-machine-arn $SM_ARN \
  --input '{"key":"value"}' \
  --query executionArn --output text \
  --endpoint-url $AWS_ENDPOINT)

# Check status
aws stepfunctions describe-execution \
  --execution-arn $EXEC_ARN \
  --endpoint-url $AWS_ENDPOINT

# Get event history
aws stepfunctions get-execution-history \
  --execution-arn $EXEC_ARN \
  --endpoint-url $AWS_ENDPOINT

CloudFormation

Protocol: Query (XML) — POST http://localhost:4566/ with Action= parameter CloudFormation supports stacks, change sets, resource provisioning, stack sets, and stack policies.

CloudFormation operations (20+)

Action	Description
`CreateStack`	Deploy a CloudFormation template
`UpdateStack`	Update an existing stack
`DeleteStack`	Delete a stack and its resources
`DescribeStacks`	Get stack status and outputs
`ListStacks`	List stacks by status
`DescribeStackEvents`	Get stack creation/update event history
`DescribeStackResources`	Get all resources in a stack
`DescribeStackResource`	Get a specific stack resource
`ListStackResources`	List resource summaries
`GetTemplate`	Retrieve the template body
`ValidateTemplate`	Validate a template without deploying
`CreateChangeSet`	Create a change set
`DescribeChangeSet`	Get change set details
`ExecuteChangeSet`	Apply a change set
`ListChangeSets`	List change sets for a stack
`DeleteChangeSet`	Delete a change set
`SetStackPolicy`	Set a stack policy
`GetStackPolicy`	Retrieve the current stack policy
`ListStackSets`	List StackSets
`DescribeStackSet`	Get StackSet details
`CreateStackSet`	Create a new StackSet

Examples

export AWS_ENDPOINT=http://localhost:4566

# Validate a template
aws cloudformation validate-template \
  --template-body file://template.yml \
  --endpoint-url $AWS_ENDPOINT

# Deploy a stack
aws cloudformation create-stack \
  --stack-name my-stack \
  --template-body file://template.yml \
  --parameters ParameterKey=Env,ParameterValue=dev \
  --endpoint-url $AWS_ENDPOINT

# Check status
aws cloudformation describe-stacks \
  --stack-name my-stack \
  --endpoint-url $AWS_ENDPOINT

# Watch events
aws cloudformation describe-stack-events \
  --stack-name my-stack \
  --endpoint-url $AWS_ENDPOINT

# Update
aws cloudformation update-stack \
  --stack-name my-stack \
  --template-body file://template.yml \
  --endpoint-url $AWS_ENDPOINT

# Create a change set
aws cloudformation create-change-set \
  --stack-name my-stack \
  --change-set-name my-change-set \
  --template-body file://template.yml \
  --endpoint-url $AWS_ENDPOINT

# Describe a change set
aws cloudformation describe-change-set \
  --stack-name my-stack \
  --change-set-name my-change-set \
  --endpoint-url $AWS_ENDPOINT

# Execute the change set
aws cloudformation execute-change-set \
  --stack-name my-stack \
  --change-set-name my-change-set \
  --endpoint-url $AWS_ENDPOINT

# Delete
aws cloudformation delete-stack \
  --stack-name my-stack \
  --endpoint-url $AWS_ENDPOINT

Get Started

Configuration

Services

Contributing

Observability

CloudWatch Logs

Configuration

Examples

CloudWatch Metrics

Examples

Step Functions

Examples

CloudFormation

Examples

Build docs developers (and LLMs) love

Get Started

Configuration

Services

Contributing

​CloudWatch Logs

​Configuration

​Examples

​CloudWatch Metrics

​Examples

​Step Functions

​Examples

​CloudFormation

​Examples

Build docs developers (and LLMs) love

CloudWatch Logs

Configuration

Examples

CloudWatch Metrics

Examples

Step Functions

Examples

CloudFormation

Examples