Logs

logs accepts structured log events and lets you create, list, and delete log groups and streams, then filter events by group and stream.

Status: Preview — Create/Describe/Delete group and stream plus PutLogEvents / FilterLogEvents via gateway. Lake-backed long retention expands later.

Concepts

Term	Meaning
Log group	Named collection (for example /cloud/app)
Log stream	Writer within a group
Filter pattern	Substring match over message text

Access

Hostname	logs.eu-central-1.cloud.skippr.io
Protocol	CloudWatch Logs JSON (X-Amz-Target: CloudWatchLogs.*)
Auth	SigV4 / Cloud JWT via gateway
Region	eu-central-1

Quickstart

Create a group and stream, then put and filter events (SigV4 or JWT via gateway — same credential model as other Cloud services):

# CreateLogGroup
curl -X POST "https://logs.eu-central-1.cloud.skippr.io/" \
  -H "Content-Type: application/x-amz-json-1.1" \
  -H "X-Amz-Target: CloudWatchLogs.CreateLogGroup" \
  -d '{"LogGroupName":"/app/acme"}'

# CreateLogStream
curl -X POST "https://logs.eu-central-1.cloud.skippr.io/" \
  -H "Content-Type: application/x-amz-json-1.1" \
  -H "X-Amz-Target: CloudWatchLogs.CreateLogStream" \
  -d '{"LogGroupName":"/app/acme","LogStreamName":"api"}'

# PutLogEvents (group and stream must already exist)
curl -X POST "https://logs.eu-central-1.cloud.skippr.io/" \
  -H "Content-Type: application/x-amz-json-1.1" \
  -H "X-Amz-Target: CloudWatchLogs.PutLogEvents" \
  -d '{"LogGroupName":"/app/acme","LogStreamName":"api","LogEvents":[{"Timestamp":1710000000000,"Message":"ready"}]}'

Operations

Operation	Notes
CreateLogGroup	Creates an empty group
CreateLogStream	Group must exist
DescribeLogGroups	Optional LogGroupNamePrefix
DescribeLogStreams	Lists streams in a group
DeleteLogGroup	Removes group, streams, and events
DeleteLogStream	Removes stream and its events
PutLogEvents	Requires existing group and stream
FilterLogEvents	Returns matching Events (includes LogStreamName)
Insights / subscriptions	Coming soon

Limits & errors

• Missing group or stream on Put → ResourceNotFoundException (404)
• Duplicate Create → ResourceAlreadyExistsException (409)
• Put without Create first is rejected (no auto-create)

Related

• Elt — lake / pipeline path
• Gateway
• Roadmap