AWS Step Functions

AWS Step Functions

Beta
Beta release

This source is currently in beta. It works end to end, but you may still hit rough edges. Let us know if you do.

Let AI connect your sources for you

Skip the manual setup — run this in your project and the wizard auto-detects your databases and APIs and connects them to PostHog.

Learn more
PostHog Wizard hedgehog

Connect AWS Step Functions to PostHog to sync your data into the PostHog data warehouse for analysis and modeling.

Sync state machines, versions, aliases, activities, executions, execution history, and Distributed Map runs from one AWS region. Grant states:ListStateMachines, states:ListExecutions, states:GetExecutionHistory, states:ListStateMachineVersions, states:ListStateMachineAliases, states:DescribeStateMachineAlias, states:ListActivities, states:ListMapRuns, and states:DescribeMapRun for the tables you select. Executions, history, and Map runs cover Standard workflows only. History excludes input and output payloads. All tables use full refresh because these APIs have no time filter.

Configuration

OptionDescription
AWS access key ID
Type: text
Required: True
AWS secret access key
Type: password
Required: True
AWS session token
Type: password
Required: False

Temporary credentials expire. Update them before the next scheduled sync.

AWS region
Type: text
Required: True

Linking AWS Step Functions to PostHog

  1. Go to the Data pipeline page in PostHog
  2. Click New source and select AWS Step Functions
  3. Fill in the required configuration fields
  4. Click Next, select the tables you want to sync, and then press Import

Supported tables

TableDescriptionSync methodIncremental fieldPrimary key
state_machines

State machines in the configured AWS region, including Standard and Express workflows.

Full refresh——
executions

Execution status and times for Standard workflows in the configured AWS region.

Full refresh——
execution_history

History events for Standard workflow executions, without input or output payloads.

Full refresh——
state_machine_versions

Published versions of each state machine in the configured AWS region.

Full refresh——
state_machine_aliases

Aliases of each state machine, with the versions they route executions to.

Full refresh——
activities

Activities that workers poll for tasks in the configured AWS region.

Full refresh——
map_runs

Distributed Map runs started by Standard workflow executions, with item and child execution counts.

Full refresh——
map_run_executions

Child workflow executions started by each Distributed Map run.

Full refresh——