zeek/doc/scripts/base/frameworks/cluster/index.rst
Tim Wojtulewicz ded98cd373 Copy docs into Zeek repo directly
This is based on commit 2731def9159247e6da8a3191783c89683363689c from the
zeek-docs repo.
2025-09-26 02:58:29 +00:00

38 lines
1.4 KiB
ReStructuredText

:orphan:
Package: base/frameworks/cluster
================================
The cluster framework provides for establishing and controlling a cluster
of Zeek instances.
:doc:`/scripts/base/frameworks/cluster/__load__.zeek`
:doc:`/scripts/base/frameworks/cluster/main.zeek`
A framework for establishing and controlling a cluster of Zeek instances.
In order to use the cluster framework, a script named
``cluster-layout.zeek`` must exist somewhere in Zeek's script search path
which has a cluster definition of the :zeek:id:`Cluster::nodes` variable.
The ``CLUSTER_NODE`` environment variable or :zeek:id:`Cluster::node`
must also be sent and the cluster framework loaded as a package like
``@load base/frameworks/cluster``.
.. warning::
The file ``cluster-layout.zeek`` should only contain the definition
of :zeek:id:`Cluster::nodes`. Specifically, avoid loading other Zeek
scripts or using :zeek:see:`redef` for anything but :zeek:id:`Cluster::nodes`.
Due to ``cluster-layout.zeek`` being loaded very early, it is easy to
introduce circular loading issues.
:doc:`/scripts/base/frameworks/cluster/pools.zeek`
Defines an interface for managing pools of cluster nodes. Pools are
a useful way to distribute work or data among nodes within a cluster.
:doc:`/scripts/base/frameworks/cluster/telemetry.zeek`