On This Page

Home / Edge/ Reference/ Knowledge Objects/Endpoint Lists

Endpoint Lists ​

An Endpoint List is a reusable set of receiver hosts, each with a load weight. The hosts stay in one place instead of being entered on each Destination.

You configure Endpoint Lists per Fleet, or within a Pack. You can use a list only within its scope, in the Fleet or Pack where you defined it. If a Pack and a Fleet each have an Endpoint List with the same ID, the lists stay separate.

Only the Cribl HTTP and Cribl TCP Destinations in the same Fleet or Pack can reference an Endpoint List. Endpoint Lists defined in an Edge Fleet are subject to Fleet inheritance.

Create an Endpoint List ​

  1. In the sidebar, select Fleets and choose a Fleet.
  2. In the Fleets submenu, select More.
  3. Select Knowledge, then Endpoint Lists.
  4. Select Add Endpoint List.
  5. Configure these settings:
    • ID: Unique identifier for the list. Supports letters, numbers, underscores, and hyphens.
    • Description: Optionally, enter a description.
    • Endpoints: Add one row for each host.
    • Host: Hostname of a receiver. Each host in the list must be unique.
    • Load weight: Relative traffic-handling capability for the host. Defaults to 1. The minimum value is 0. Cribl Edge distributes traffic across the hosts according to their relative weights. A host with a weight of 2 receives about twice the traffic of a host with a weight of 1. For best results, assign weights in the same order of magnitude.
  6. Select Save.

Delete an Endpoint List ​

  1. Go to Knowledge > Endpoint Lists for the Fleet or Pack.
  2. In the Actions column, select Delete.

Cribl Edge cannot delete an Endpoint List while a Destination in the same Fleet or Pack still references it. The error message shown when the deletion fails includes the number of referencing Destinations and names the Output ID for the first two Destinations. A Destination still counts as a reference when Load balancing is toggled off. Remove the list from those Destinations, and then delete the list again.