Skip to main content

Glossary

This section defines commonly used terminology referenced within the documentation.

Bridge​

Synonym to "connector"

Broker​

A broker is an instance of a Zeebe installation which executes processes and manages process state. A single broker will be installed on a single machine.

Client​

A client interacts with the Zeebe broker on behalf of the business application. Clients poll for work from the broker.

Cluster​

A cluster represents a configuration of one or more brokers collaborating to execute processes. Each broker in a cluster acts as a leader or a follower.

Command​

A command represents an action to be taken or executed. Example commands include: deploy a process, execute a process, etc.

Connector​

A piece of software that connects the workflow engine with some other system or infrastructure. The connector might be uni or bidirectional and possibly includes a job worker. The boundary between connectors and job workers can be fuzzy, but in general connectors connect to other active pieces of software. For example, a 'DMN connector' might connect to a managed DMN Engine, while a 'DMN worker' will use a DMN library to directly execute decisions.

Correlation​

Correlation refers to the act of matching a message with an inflight process instance.

Correlation Key​

A correlation is an attribute within a message which is used to match this message against a certain variable within an inflight process instance. If the value of the correlation key matches the value of the variable within the process instance, the message is matched to this process instance.

Deployment​

A process cannot execute unless it is known by the broker. Deployment is the process of pushing or deploying processes to the broker.

Event​

An event represents a state change associated with an aspect of an executing process instance. Events capture variable changes, state transition in process elements, etc. An event will be represented by a timestamp, the variable name and variable value. Events are stored in an append-only log.

Exporter​

An exporter represents a sink to which Zeebe will submitted all records within the log. This gives users of Zeebe an opportunity to persist records with the log for future use as this data will not be available after log compaction.

Follower​

In a clustered environment, a broker which is not a leader is a follower of a given partition. A follower can become the new leader when the old leader is no longer reachable.

Gateway​

Clients communicate with the Zeebe cluster through a gateway. The gateway provides a gRPC API and forwards client commands to the cluster. Depending on the setup, a gateway can be embedded in the broker or can be configured to be standalone.

Incident​

An incident represents an error condition which prevents Zeebe from advancing an executing process instance. Zeebe will create an incident if there was an uncaught exception thrown in your code and the number of retries of the given step has been exceeded.

Job​

A job represents a distinct unit of work within a business process. Service tasks represent such jobs in your process and are identified by a unique id. A job has a type to allow specific job workers to find jobs that they can work on.

Job activation timeout​

This is the amount of time the broker will wait for a complete or fail response from the job worker after a job has been submitted to the job worker for processing before it marks the job as available again for other job workers.

Job worker​

A special type of client that polls for and executes available jobs. An uncompleted job prevents Zeebe from advancing process execution to the next step.

Leader​

In a clustered environment, one broker, the leader, is responsible for process execution and housekeeping of data within a partition. Housekeeping includes, taking snapshots, replication and running exports.

Log​

The log comprises of an ordered sequence of records written to persistent storage. The log is appended-only and is stored on disk within the broker.

Message​

A message contains information to be delivered to interested parties during execution of a process instance. Messages can be published via Kafka or Zeebe’s internal messaging system. Messages are associated with timestamp and other constraints such as time-to-live (TTL).

Partition​

A partition represents a logical grouping of data in a Zeebe broker. This data includes process instance variables stored in RocksDB, commands and events generated by Zeebe stored in the log. The number of partitions is defined by configuration.

Process​

A process is a defined sequence of distinct steps representing your business logic. Examples of a process could be an e-commerce shopping experience, onboarding a new employee, etc. In Zeebe, process are identified by a unique process id. The process is usually also referred to as the BPMN model.

Process instance​

While a process represents a defined sequence of distinct steps representing your business logic, a process instance represents a currently executing or completed process. For a single process, there could be many associated process instances in various stages of their executing lifecycle. Process instances are identitied by process instance ids. Executing process instances are also sometimes referred to as inflight processes.

Process instance variable​

A process instance variable represents the execution state (i.e data) of a process instance. These variables capture business process parameters which are input and output of various stages of the process instance and which also influence process flow execution.

Record​

A record represents a command or an event. For example, a command to create a new process instance, or a state transition of an executing process instance representing an event at a given point in time would result to generation of a record. During the execution lifecycle of a process instance, numerous records will be generated to capture various commands and events generated. Records are stored in the log.

Replication​

Replication is the act of copying data in a partition from a leader to its followers within a clustered Zeebe installation. After replication, the leader and followers of a partition will have the exact same data. Replication allows the system to be resilient to brokers going down.

Replication factor​

This is the number of times data in a partition will be copied and this depends on the number of brokers in a cluster. A cluster with one leader and two followers will have a replication factor of three, as data in each partition needs to have three copies.

Request timeout​

This is how long a client will wait for a response from the broker after the client has submitted a request. If a response is not received within the client request timeout, the client can consider the broker unreachable.

Snapshot​

The state of all active process instances, (these are also known as inflight process instances) are stored as records in an in-memory database called RocksDB. A snapshot represents a copy of all data within the in-memory database at any given point in time. Snapshots are binary images stored on disk and can be used to restore execution state of a process. The size of a snapshot is affected by the size of the data. Size of the data depends on several factors including complexity of the model or business process, the size and quantity of variables in each process instance as well as the total number of executing process instances in a broker.

Segment​

The log consists of one or more segments. Each segment is a file that contains an ordered sequence records. Segments are deleted when the log is compacted.

Worker​

A worker executes a job. In the Zeebe nomenclature, these are also referred to as job workers.

Workflow​

Please see process.

Workflow instance​

Please see process instance.

Workflow instance variable​

Please see process instance variable.