Setup guide
About 30 minutes on the AWS side
All connectors
Compare connection options
Kinesis is a streaming connection, best suited to event data you want reflected in Auxia continuously. If your data already lands in Amazon S3 — including through Kinesis Data Firehose — use the Amazon S3 connector instead.
Features
How it works
Auxia consumes your stream from Google Cloud with a Pub/Sub import topic, which reads Kinesis shards directly and writes records into Auxia’s warehouse as typed columns. There’s no intermediate ETL job for you to operate. Authentication uses workload identity federation: Auxia’s Google Cloud service account assumes an Auxia-managed AWS IAM role, and that role reads your stream. No AWS access keys are created or exchanged.Record format and schema
Records are parsed into typed columns, so the schema must be agreed before you send production traffic.- Format: each Kinesis record must be a single JSON object with a fixed shape. Field names map to columns by name.
- Event timestamp: include a timestamp field (for example
event_timestamp). The destination table is partitioned by day on it. - Extra fields that aren’t part of the agreed schema are ignored rather than failing the record, so you can add fields without breaking ingestion.
- Schema mismatches — for example a string in a numeric field — send the record to a dead-letter queue that Auxia monitors. Dead-lettered records are kept for 7 days for inspection and replay.
Operational notes
- Retention: keep your stream’s retention window long enough to absorb a transient outage. The default 24 hours is usually enough; longer retention gives a wider replay window.
- Append-only: as with every Auxia source, send corrections as new events rather than rewriting history.
Limitations
- Each record must be a single JSON object matching the agreed schema.
- Kinesis connections are set up with the Auxia team, not in the self-serve wizard.
- See Source data requirements for requirements shared by all connectors.