Skip to main content

Glossary

The following terms are used in Temporal Platform documentation.

Action

An Action is the fundamental pricing unit in Temporal Cloud. Temporal Actions are the building blocks for Workflow Executions. When you execute a Temporal Workflow, its Actions create the ongoing state and progress of your Temporal Application.

Tags: term, pricing, temporal-cloud, explanation

Actions Per Second (APS)

APS, or Actions per second, is specific to Temporal Cloud. Each Temporal Cloud Namespace enforces a rate limit, which is measured in Actions per second (APS). This is the number of Actions, such as starting or signaling a Workflow, that can be performed per second within a specific Namespace.

Tags: term, pricing, temporal-cloud, explanation

Activity

In day-to-day conversation, the term "Activity" denotes an Activity Type, Activity Definition, or Activity Execution.

Tags: term, explanation

Activity Definition

An Activity Definition is the code that defines the constraints of an Activity Task Execution.

Tags: term, explanation

Activity Execution

An Activity Execution is the full chain of Activity Task Executions.

Tags: term, explanation

Activity Heartbeat

An Activity Heartbeat is a ping from the Worker that is executing the Activity to the Temporal Service.

Each ping informs the Temporal Service that the Activity Execution is making progress and the Worker has not crashed.

Tags: term, explanation

Activity Id

A unique identifier for an Activity Execution.

Tags: term, explanation

Activity Task

An Activity Task contains the context needed to make an Activity Task Execution.

Tags: term, explanation

Activity Task Execution

An Activity Task Execution occurs when a Worker uses the context provided from the Activity Task and executes the Activity Definition.

Tags: term, explanation

Activity Type

An Activity Type is the mapping of a name to an Activity Definition.

Tags: term, explanation

Archival

Archival is a feature specific to a Self-hosted Temporal Service that automatically backs up Event Histories from Temporal Service persistence to a custom blob store after the Closed Workflow Execution retention period is reached.

Tags: term, explanation

Asynchronous Activity Completion

Asynchronous Activity Completion occurs when an external system provides the final result of a computation, started by an Activity, to the Temporal System.

Tags: term, explanation

Audit Logging

Audit Logging is a feature that provides forensic access information for accounts, users, and Namespaces.

Tags: term, explanation, temporal-cloud, operations

Authorizer Plugin

The Authorizer plugin contains a single Authorize method, which is invoked for each incoming API call. Authorize receives information about the API call, along with the role and permission claims of the caller.

Tags: term

Child Workflow

A Child Workflow Execution is a Workflow Execution that is spawned from within another Workflow.

Tags: term, explanation, child-workflow

Claim Mapper

The Claim Mapper component is a pluggable component that extracts Claims from JSON Web Tokens (JWTs).

Tags: term

Codec Server

A Codec Server is an HTTP server that uses your custom Payload Codec to encode and decode your data remotely through endpoints.

Tags: term

Command

A Command is a requested action issued by a Worker to the Temporal Service after a Workflow Task Execution completes.

Tags: term, explanation

Continue-As-New

Continue-As-New is the mechanism by which all relevant state is passed to a new Workflow Execution with a fresh Event History.

Tags: term, explanation, continue-as-new

Core SDK

The Core SDK is a shared common core library used by several Temporal SDKs. Written in Rust, the Core SDK provides complex concurrency management and state machine logic among its standout features. Centralizing development enables the Core SDK to support quick and reliable deployment of new features to existing SDKs, and to more easily add new SDK languages to the Temporal ecosystem.

Tags: term, explanation, continue-as-new

Custom Data Converter

A custom Data Converter extends the default Data Converter with custom logic for Payload conversion or Payload encryption.

Tags: term, explanation

Data Converter

A Data Converter is a Temporal SDK component that serializes and encodes data entering and exiting a Temporal Service.

Tags: term, explanation

Default Data Converter

The default Data Converter is used by the Temporal SDK to convert objects into bytes using a series of Payload Converters.

Tags: term, explanation

Delay Workflow Execution

Start Delay determines the amount of time to wait before initiating a Workflow Execution. If the Workflow receives a Signal-With-Start during the delay, it dispatches a Workflow Task and the remaining delay is bypassed.

Tags: term, explanation, delay-workflow

Dual Visibility

Dual Visibility is a feature, specific to a Self-hosted Temporal Service, that lets you set a secondary Visibility store in your Temporal Service to facilitate migrating your Visibility data from one database to another.

Tags: term, explanation, filtered-lists, visibility

Durable Execution

Durable Execution in the context of Temporal refers to the ability of a Workflow Execution to maintain its state and progress even in the face of failures, crashes, or server outages.

Tags: temporal, durable-execution, term

Dynamic Handler

Dynamic Handlers are Workflows, Activities, Signals, or Queries that are unnamed and invoked when no other named handler matches the call from the Server at runtime.

Tags: term, explanation

Event

Events are created by a Temporal Service in response to external occurrences and Commands generated by a Workflow Execution.

Tags: term, explanation

Event History

An append-only log of Events that represents the full state a Workflow Execution.

Tags: term, explanation

Failback

After Temporal Cloud has resolved an outage or incident involving a failover, a failback process shifts Workflow Execution processing back to the original region that was active before the incident.

Failover

A failover shifts Workflow Execution processing from an active Temporal Namespace region to a standby Temporal Namespace region during outages or other incidents. Standby Namespace regions use replication to duplicate data and prevent data loss during failover.

Tags: term, explanation

Failure

Temporal Failures are representations of various types of errors that occur in the system.

Tags: term, explanation

Failure Converter

A Failure Converter converts error objects to proto Failures and back.

Tags: term, explanation

Failures

A Failure is Temporal's representation of various types of errors that occur in the system.

Tags: failure, explanation, term

Frontend Service

The Frontend Service is a stateless gateway service that exposes a strongly typed Proto API. The Frontend Service is responsible for rate limiting, authorizing, validating, and routing all inbound calls.

Tags: term

General Availability

Learn more about the General Availability release stage

Tags: product-release-stages, term

Global Namespace

A Global Namespace is a Namespace that duplicates data from an active Temporal Service to a standby Service using the replication to keep both Namespaces in sync. Global Namespaces are designed to respond to service issues like network congestion. When service to the primary Cluster is compromised, a failover transfers control from the active to the standby cluster.

Tags: term, explanation

Heartbeat Timeout

A Heartbeat Timeout is the maximum time between Activity Heartbeats.

Tags: term, explanation, timeouts

History Service

The History Service is responsible for persisting Workflow Execution state and determining what to do next to progress the Workflow Execution through History Shards.

Tags: term

History Shard

A History Shard is an important unit within a Temporal Service by which the scale of concurrent Workflow Execution throughput can be measured.

Tags: term

List Filter

A List Filter is the SQL-like string that is provided as the parameter to an advanced Visibility List API.

Tags: term, explanation, filtered-lists, visibility

Local Activity

A Local Activity is an Activity Execution that executes in the same process as the Workflow Execution that spawns it.

Tags: term, explanation

Matching Service

The Matching Service is responsible for hosting external Task Queues for Task dispatching.

Tags: term

Memo

A Memo is a non-indexed user-supplied set of Workflow Execution metadata that is returned when you describe or list Workflow Executions.

Tags: term, explanation

Multi-Cluster Replication

Multi-Cluster Replication is a feature which asynchronously replicates Workflow Executions from active Clusters to other passive Clusters, for backup and state reconstruction.

Tags: term, explanation

Multi-region Namespace

A multi-region Namespace (MRN) is a Temporal Cloud Namespace that is configured to work across an active region and a standby region. Each region corresponds to a dedicated Temporal Cloud Service. Temporal Cloud automatically replicates Workflow Executions and metadata from the active to the standby region. MRNs are designed to respond to service issues as they arise. In the event that the Namespace's performance is compromised, a failover transfers control from the active to the standby region.

Tags: term, explanation

Namespace

A Namespace is a unit of isolation within the Temporal Platform.

Tags: term, explanation

Nexus API Definitions

A common code package, schema, or documentation that a Caller can use to obtain Service and Operation names as associated input/output types a Service will accept for a given Operation.

Tags: term, explanation

Nexus API Registry

The Nexus API Registry stores information about Nexus Endpoints. In the open source version of Temporal, the registry is scoped to a cluster, while in Temporal Cloud, it is scoped to an account. Endpoint names must be unique within the registry. When the Temporal Service dispatches a Nexus request, it resolves the request's Endpoint to a Namespace and Task Queue through the Registry.

Tags: term, explanation

Nexus Async Completion Callback

A Nexus Async Completion Callback is the completion callback for an asynchronous Nexus Operation.

Tags: term, explanation

Nexus Endpoint

A Nexus Endpoint is an API proxy that can serve one or more Nexus Services from a target such as a Worker listening on a target Temporal Namespace and target Task Queue. This allows service providers to present a clean API contract and hide the underlying implementation, which may consist of many internal Workflows. Multiple Nexus Endpoints can target the same Namespace, and over time a Nexus Endpoint will be able to span multiple Namespaces with service routing rules.

Tags: term, explanation

Nexus Machinery

Temporal has built-in Nexus Machinery that performs the low-level Nexus RPC operations on the wire and provides an integrated Temporal SDK experience to create Nexus Services in a handler Worker and use them from a caller Workflow through a Nexus Endpoint.

Tags: term, explanation

Nexus Operation

An arbitrary-duration operation that may be synchronous or asynchronous, short-lived, or long-lived, and used to connect durable executions within and across Namespaces, clusters, regions, and clouds. Unlike a traditional RPC, an asynchronous Nexus Operation has an operation identity that can be used to re-attach to a long-lived Nexus Operation, for example, one backed by a Temporal Workflow. Nexus Operations support a uniform interface to get the status of an operation or its result, receive a completion callback, or cancel the operation – all of which are fully integrated into the Temporal Platform.

Tags: term, explanation

Nexus Operation Events

Nexus Operations Events are history events that surface in the Caller Workflow to indicate the state of an Operation including Nexus Operation Scheduled, Nexus Operation Started, Nexus Operation Completed.

Tags: term, explanation

Nexus Operation Handler

The Nexus handler code in a Temporal Worker typically created using Temporal SDK builder functions that make it easy to abstract Temporal primitives and expose a clean service contract for others to use.

Tags: term, explanation

Nexus RPC

Nexus RPC is a protocol designed with durable execution in mind. It supports arbitrary-duration Operations that extend beyond a traditional RPC — a key underpinning to connect durable executions within and across Namespaces, clusters, regions, and cloud boundaries.

Tags: term, explanation

Nexus Service

A Nexus Service is a named collection of arbitrary-duration Nexus Operations that provide an API contract suitable for sharing across team boundaries. Nexus Services are registered with a Temporal Worker that is listening on the target Namespace and Task Queue for an Endpoint.

Tags: term, explanation

Parent Close Policy

If a Workflow Execution is a Child Workflow Execution, a Parent Close Policy determines what happens to the Workflow Execution if its Parent Workflow Execution changes to a Closed status (Completed, Failed, Timed out).

Tags: term, explanation, child-workflow-executions

Payload

A Payload represents binary data such as input and output from Activities and Workflows.

Tags: term, payloads, explanation

Payload Codec

A Payload Codec transforms an array of Payloads into another array of Payloads.

Tags: term, explanation

Payload Converter

A Payload Converter serializes data, converting objects or values to bytes and back.

Tags: term, explanation

Pre-release

Learn more about the Pre-release stage

Tags: product-release-stages, term

Public Preview

Learn more about the Public Preview release stage

Tags: product-release-stages, term

Query

A Query is a synchronous operation that is used to report the state of a Workflow Execution.

Tags: term, queries, explanation

Remote data encoding

Remote data encoding is using your custom Data Converter to decode (and encode) your Payloads remotely through endpoints.

Tags: term, explanation

Requests Per Second (RPS)

RPS, or Requests per second, is used in the Temporal Service (both in self-hosted Temporal and Temporal Cloud). This is a measure that controls the rate of requests at the service level, such as the Frontend, History, or Matching Service.

Tags: term, explanation, temporal

Reset

A Reset terminates a Workflow Execution, removes the progress in the Event History up to the reset point, and then creates a new Workflow Execution with the same Workflow Type and Id to continue.

Tags: term, resets, explanation

Retention Period

A Retention Period is the amount of time a Workflow Execution Event History remains in the Temporal Service's persistence store.

Tags: term, explanation

Retry Policy

A Retry Policy is a collection of attributes that instructs the Temporal Server how to retry a failure of a Workflow Execution or an Activity Task Execution.

Tags: term, explanation

Run Id

A Run Id is a globally unique, platform-level identifier for a Workflow Execution.

Tags: term, explanation

Schedule

A Schedule enables the scheduling of Workflow Executions.

Tags: term, explanation

Schedule-To-Close Timeout

A Schedule-To-Close Timeout is the maximum amount of time allowed for the overall Activity Execution, from when the first Activity Task is scheduled to when the last Activity Task, in the chain of Activity Tasks that make up the Activity Execution, reaches a Closed status.

Tags: term, explanation, timeouts

Schedule-To-Start Timeout

A Schedule-To-Start Timeout is the maximum amount of time that is allowed from when an Activity Task is placed in a Task Queue to when a Worker picks it up from the Task Queue.

Tags: term, explanation, timeouts

Search Attribute

A Search Attribute is an indexed name used in List Filters to filter a list of Workflow Executions that have the Search Attribute in their metadata.

Tags: term, explanation, filtered-lists, visibility

Side Effect

A Side Effect is a way to execute a short, non-deterministic code snippet, such as generating a UUID, that executes the provided function once and records its result into the Workflow Execution Event History.

Tags: term, explanation

Signal

A Signal is an asynchronous request to a Workflow Execution.

Tags: term, signals, explanation

Signal-With-Start

Signal-With-Start starts and Signals a Workflow Execution, or just Signals it if it already exists.

Tags: term, explanation

Start-To-Close Timeout

A Start-To-Close Timeout is the maximum time allowed for a single Activity Task Execution.

Tags: term, explanation, timeouts

State Transition

A State Transition is a unit of progress by a Workflow Execution.

Tags: term, explanation

Sticky Execution

A Sticky Execution is a when a Worker Entity caches the Workflow Execution Event History and creates a dedicated Task Queue to listen on.

Tags: term, explanation

Task

A Task is the context needed to make progress with a specific Workflow Execution or Activity Execution.

Tags: term, explanation

Task Queue

A Task Queue is a first-in, first-out queue that a Worker Process polls for Tasks.

Tags: term, explanation

Task Routing

Task Routing is when a Task Queue is paired with one or more Worker Processes, primarily for Activity Task Executions.

Tags: term, explanation

Task Token

A Task Token is a unique identifier for an Activity Task Execution.

Tags: term, explanation

Temporal

Temporal is a scalable and reliable runtime for Reentrant Processes called Temporal Workflow Executions.

Tags: term, explanation

Temporal Application

A Temporal Application is a set of Workflow Executions.

Tags: term, explanation

Temporal CLI

The Temporal CLI is the most recent version of Temporal's command-line tool.

Tags: term, cli

Temporal Client

A Temporal Client, provided by a Temporal SDK, provides a set of APIs to communicate with a Temporal Service.

Tags: term, explanation

Temporal Cloud

Temporal Cloud is a managed, hosted Temporal environment that provides a platform for Temporal Applications.

Tags: term, explanation

Temporal Cloud Account Id

A Temporal Cloud Account Id is a unique identifier for a customer.

Tags: term, explanation

Temporal Cloud Namespace Id

A Cloud Namespace Id is a globally unique identifier for a Namespace in Temporal Cloud.

Tags: term, explanation

Temporal Cloud Namespace Name

A Cloud Namespace Name is a customer-supplied name for a Namespace in Temporal Cloud.

Tags: term, explanation

Temporal Cloud gRPC Endpoint

A Cloud gRPC Endpoint is a Namespace-specific address used to access Temporal Cloud from your code.

Tags: term, explanation

Temporal Cluster

The term "Temporal Cluster" is being phased out. Instead the term Temporal Service is now being used.

Temporal Service

A Temporal Service is a Temporal Server paired with Persistence and Visibility stores.

Tags: term, explanation

Temporal Service configuration

Temporal Service configuration is the setup and configuration details of your Temporal Service, defined using YAML.

Tags: term, explanation

Temporal Cron Job

A Temporal Cron Job is the series of Workflow Executions that occur when a Cron Schedule is provided in the call to spawn a Workflow Execution.

Tags: term, explanation

Temporal Platform

The Temporal Platform consists of a Temporal Service and Worker Processes.

Tags: term, explanation

Temporal SDK

A Temporal SDK is a language-specific library that offers APIs to construct and use a Temporal Client to communicate with a Temporal Service, develop Workflow Definitions, and develop Worker Programs.

Tags: term, explanation

Temporal Server

The Temporal Server is a grouping of four horizontally scalable services.

Tags: term, explanation

Temporal Web UI

The Temporal Web UI provides users with Workflow Execution state and metadata for debugging purposes.

Tags: term, web-ui

Timer

Temporal SDKs offer Timer APIs so that Workflow Executions are deterministic in their handling of time values.

Tags: term, explanation

Update

An Update is a request to and a response from Workflow Execution.

Tags: term, updates, explanation

Visibility

The term Visibility, within the Temporal Platform, refers to the subsystems and APIs that enable an operator to view Workflow Executions that currently exist within a Temporal Service.

Tags: term

Worker

In day-to-day conversations, the term Worker is used to denote both a Worker Program and a Worker Process. Temporal documentation aims to be explicit and differentiate between them.

Tags: term, explanation

Worker Entity

A Worker Entity is the individual Worker within a Worker Process that listens to a specific Task Queue.

Tags: term, explanation

Worker Process

A Worker Process is responsible for polling a Task Queue, dequeueing a Task, executing your code in response to a Task, and responding to the Temporal Server with the results.

Tags: term, explanation

Worker Program

A Worker Program is the static code that defines the constraints of the Worker Process, developed using the APIs of a Temporal SDK.

Tags: term, explanation

Worker Service

The Worker Service runs background processing for the replication queue, system Workflows, and (in versions older than 1.5.0) the Kafka visibility processor.

Tags: term

Worker Session

A Worker Session is a feature provided by some SDKs that provides a straightforward way to ensure that Activity Tasks are executed with the same Worker without requiring you to manually specify Task Queue names.

Tags: term, explanation

Workflow

In day-to-day conversations, the term "Workflow" frequently denotes either a Workflow Type, a Workflow Definition, or a Workflow Execution.

Tags: term, explanation

Workflow Definition

A Workflow Definition is the code that defines the constraints of a Workflow Execution.

Tags: term, explanation

Workflow Execution

A Temporal Workflow Execution is a durable, scalable, reliable, and reactive function execution. It is the main unit of execution of a Temporal Application.

Tags: term, explanation

Workflow Execution Timeout

A Workflow Execution Timeout is the maximum time that a Workflow Execution can be executing (have an Open status) including retries and any usage of Continue As New.

Tags: term, explanation, timeouts

Workflow History Export

Workflow History export allows users to export Closed Workflow Histories to a user's Cloud Storage Sink.

Tags: term, explanation, temporal-cloud, operations

Workflow Id

A Workflow Id is a customizable, application-level identifier for a Workflow Execution that is unique to an Open Workflow Execution within a Namespace.

Tags: term, explanation

Workflow Id Conflict Policy

A Workflow Id Conflict Policy determines how to resolve the conflict when spawning a new Workflow Execution with a particular Workflow Id that is used by an Open Workflow Execution already.

Tags: term, explanation

Workflow Id Reuse Policy

A Workflow Id Reuse Policy determines whether a Workflow Execution is allowed to spawn with a particular Workflow Id, if that Workflow Id has been used with a previous, and now Closed, Workflow Execution.

Tags: term, explanation

Workflow Run Timeout

This is the maximum amount of time that a single Workflow Run is restricted to.

Tags: term, explanation, timeouts

Workflow Task

A Workflow Task is a Task that contains the context needed to make progress with a Workflow Execution.

Tags: term, explanation

Workflow Task Execution

A Workflow Task Execution occurs when a Worker picks up a Workflow Task and uses it to make progress on the execution of a Workflow Definition.

Tags: term, explanation

Workflow Task Timeout

A Workflow Task Timeout is the maximum amount of time that the Temporal Server will wait for a Worker to start processing a Workflow Task after the Task has been pulled from the Task Queue.

Tags: term, explanation, timeouts

Workflow Type

A Workflow Type is a name that maps to a Workflow Definition.

Tags: term, explanation

tctl (deprecated)

tctl is a command-line tool that you can use to interact with a Temporal Service. It is superseded by the Temporal CLI utility.