CLI Tool to run and tail a step function synchronously.
Project description
Stail
CLI Tool to run and tail a step function synchronously and persist event logs for the state machine execution on disk.
(Sample screenshot of terminal output)
Use cases:
- Running and monitoring step function execution directly from terminal or Jupyter notebook.
- In case of error, identifying the failed task and cause of error.
- Debugging by reading events log file and all the metadata about the failed task (for example input and output).
Installation:
pip install stail
Usage
Run
Starts a step function execution synchronously, tails the event history to the console and create a log file with all the events for the execution.
Log file is stored at stail_logs/[execution name (UUID)].log
stail run --arn [state machine arn] --input [input]
Options:
--arn State machine ARN
--input Input JSON to the state machine
Example:
stail run --arn arn:aws:states:<region>:<account_number>:stateMachine:<name> --input "{\"param\":\"hello\"}"
Version
Displays the version.
stail version
Author: Iman Kamyabi
Feedback: contact@imankamyabi.com
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
stail-0.2.2.tar.gz
(4.4 kB
view hashes)
Built Distribution
stail-0.2.2-py3-none-any.whl
(5.2 kB
view hashes)