AWS Step Function State Machine

Collect AWS Step Function State Machine Metrics

Configuration¶

Install Func¶

It is recommended to activate the Guance integration - Extensions - DataFlux Func (Automata): All prerequisites are automatically installed, please proceed with the script installation.

If deploying Func manually, refer to Manual Deployment of Func

Install Script¶

Note: Please prepare the required Amazon AK in advance (for simplicity, you can directly grant the global read-only permission ReadOnlyAccess)

Automata Version Activation Script¶

1. Log in to the Guance console
2. Click the 【Integration】 menu, select 【Cloud Account Management】
3. Click 【Add Cloud Account】, select 【AWS】, and fill in the required information on the interface. If you have already configured the cloud account information before, ignore this step.
4. Click 【Test】, after a successful test, click 【Save】. If the test fails, please check the relevant configuration information and retest.
5. Click 【Cloud Account Management】, you can see the added cloud account in the list, click the corresponding cloud account to enter the details page.
6. Click the 【Integration】 button on the cloud account details page, find AWS Step Function State Machine under the Not Installed list, and click the 【Install】 button to pop up the installation interface for installation.

Manual Activation Script¶

1. Log in to the Func console, click [Script Market], enter the Guance Script Market, and search for: integration_aws_sfn_state_machine

2. Click [Install], then input the corresponding parameters: AWS AK ID, AK Secret, and account name.

3. Click [Deploy Startup Script], the system will automatically create the Startup script set and configure the corresponding startup script.

4. After enabling, you can see the corresponding automatic trigger configuration in "Manage / Automatic Trigger Configuration". Click [Execute] to immediately execute once without waiting for the scheduled time. Wait a moment, and you can view the execution task records and corresponding logs.

Verification¶

1. In "Manage / Automatic Trigger Configuration", confirm whether the corresponding task has the automatic trigger configuration, and check the corresponding task records and logs for any exceptions.
2. In Guance, check if asset information exists in "Infrastructure - Resource Catalog".
3. In Guance, check if there are corresponding monitoring data in "Metrics".

Metrics¶

Configure Amazon CloudWatch to collect more metrics Amazon CloudWatch Metrics Details

AWS Step Function State Machine metrics are under the aws_states Measurement, with the description column including the description, unit, and statistical data for each metric.

Object¶

The collected AWS Step Function State Machine object data structure can be viewed in "Infrastructure - Resource Catalog".

{
  "measurement": "aws_sfn_state_machine",
  "tags": {
    "state_machine_arn"                 : "arn:xxx:axxxxow:ap-southeast-1:xxxx7738534:environment/MyAirflowEnvironment",
    "sate_machine_name"                 : "HelloWorldStateMachine",
    "RegionId"                          : "ap-southeast-1"
  },
  "fields": {
    "type"                        : "STANDARD",
    "creationDate"                : "2025-08-15T10:35:10.879000+08:00"
  }
}

Note: The fields in tags and fields may change with subsequent updates.