Workflow Components in Kestra – Reference Guide

Get to know the main orchestration components of a Kestra workflow.

Core Workflow Components


Flow

Understand Kestra Flows, the fundamental units of orchestration. Learn to define tasks, inputs, outputs, and logic to automate your business processes.

Tasks

Explore Tasks in Kestra, the building blocks of your flows. Differentiate between Runnable tasks for processing and Flowable tasks for orchestration logic.

Namespace

Organize your Kestra workflows with Namespaces. Learn to group flows, manage access, and structure your orchestration environment hierarchically.

Plugins

Understand how Kestra plugins work, how to choose versions, and where to find or build the right integration.

Execution

Manage Flow Executions in Kestra. Learn how to trigger, monitor, and troubleshoot workflow runs, understand states, and access execution metrics.

Variables

Master Variables in Kestra to reuse values across tasks and flows. Learn to configure, modify, and utilize dynamic variables with Pebble templating.

Inputs

Make your Kestra flows dynamic with Inputs. Learn to declare typed inputs, validate values, and pass parameters at runtime for flexible workflow execution.

Outputs

Leverage Outputs in Kestra to share data between tasks and flows. Learn to capture, store, and reuse execution results and artifacts in your workflows.

Checks

Implement Checks in Kestra for pre-execution validation. Guard your workflows by enforcing conditions on inputs before any task begins execution.

Triggers

Automate flow execution with Kestra Triggers. Explore scheduled, event-based, and webhook triggers to start workflows based on time or external events.

Labels

Organize and filter Kestra flows and executions with Labels. Use key-value tags to group workflows by team, environment, project, or priority.

Plugin Defaults

Streamline Kestra flow configuration with Plugin Defaults. Set global or flow-level default values for task properties to reduce repetition and boilerplate.

Subflows

Modularize your Kestra workflows with Subflows. Learn to call flows from other flows, pass inputs and outputs, and build reusable orchestration components.

Errors

Master error handling in Kestra. Explore strategies like global and local error handlers, allowing failures, and configuring alerts for robust workflows.

Retries

Configure Retries in Kestra to handle transient failures. Learn about constant, exponential, and random retry strategies for tasks and flows.

Task Timeout

Control task duration with Timeouts in Kestra. Prevent hanging processes and manage costs by setting maximum execution times for your tasks.

Concurrency Limits

Manage workflow load with Concurrency Limits in Kestra. Control the number of parallel executions for a flow to protect resources and downstream systems.

Descriptions

Document your Kestra workflows effectively. Add Markdown descriptions to flows, tasks, inputs, and triggers to improve maintainability and collaboration.

Disabled flag

Temporarily disable flows, tasks, or triggers in Kestra. Use the disabled flag for debugging, testing, or pausing specific workflow components without deletion.

States

Understand the Kestra Execution Lifecycle. Reference guide to all execution and task run states, including Created, Running, Success, Failed, and more.

SLA

Enforce Service Level Agreements (SLAs) in Kestra. Monitor workflow duration and assertions, triggering alerts or actions when performance targets are missed.

Finally

Ensure cleanup with Finally tasks in Kestra. Execute specific tasks at the end of a flow regardless of success or failure, perfect for resource teardown.

afterExecution

Trigger actions after flow completion with afterExecution tasks. Run logic based on final execution status (Success/Failed) for notifications or reporting.

Task Cache

Optimize performance with Task Caching in Kestra. Cache outputs of expensive tasks to skip re-execution and speed up workflows when inputs haven't changed.

Was this page helpful?