Configure a Cribl Stream Worker to Use a Specific IP Address in a Multi-NIC Environment

Objective

Configure a Cribl Stream worker to use a specific IP address in a multi-NIC environment so the worker presents the intended address to the leader for API-related communication.

Environment

• Cribl Stream
• Distributed deployment with leader and worker nodes
• Worker hosts with multiple network interfaces or IP addresses
• Self-managed Linux hosts using systemd

Procedure

1. Log in to each worker host that must use a specific IP address.
2. Open a `systemd` override for the Cribl service:
   systemctl edit cribl.service
3. Add the following environment variable, replacing the example IP with the address that the worker should use:
   Environment=CRIBL_API_HOST=<desired_ip_address>
4. Save the override on the host.
5. Repeat the change on each worker that needs to advertise a specific IP address.
6. Verify in the leader UI that the worker now shows the intended IP address.

Last Validated

4.18.1

Additional Information

If the goal is to make an input listen on only one interface, that is a separate setting from the worker IP shown in the leader UI. In the case, the source-side behavior was described as listening on 0.0.0.0 by default, while CRIBL_API_HOST was called out specifically as the API-related setting for the host.