Skip to main content

Illumio Core 23.2 Install, Configure, Upgrade

Configure YAML

Flowlink requires configurable parameters using a YAML file.

Note

Refer to the /usr/local/illumio/flowlink_config_schema.json file provided with the Flowlink RPM for definitions of all the fields supported by the Flowlink configuration file.

Key Value Parameters

This table describes the YAML file key-value parameters.

Parameter

Required/Optional

Description

aggregation_minutes

Optional

The interval (in minutes) in which flows are aggregated and sent to the PCE.

Default interval: 10

Minimum allowed interval: 5

Maximum allowed interval: 60

For example:

aggregation_minutes: 10

api_key

Required

API key and secret of the PCE. This allows Flowlink to POST flows to the PCE. The API key and secret can be copied into a file. You can run a script to cat the contents of that file. In the example below, a file called api_info is created which contains the PCE API key and secret.

For example:

api_key: $cat /home/employee/api_info

destinations

Required

A list of dictionaries. It requires a name, parser, and connector. Flowlink configuration supports one or many destinations (flow types).

For more details about configuring the ingested flow types, see Ingested Flow Types.

data_directory

Required

The pathname of a directory where Flowlink can store any unsent data flow files or any restart information.

For example:

data_directory: /home/employee/

data_directory_size_mb

Optional

The maximum size (in Megabytes) of data that can be stored in the data directory before being pruned.

Default: 500

Minimum value: 100

For example:

data_directory_size_mb: 200

file_retention_hours

Optional

The maximum number of hours unsent data flow files will be stored before being pruned.

Default: 24

Minimum: 4

For example:

file_retention_hours: 8

metrics_print_seconds

Optional

The frequency (in seconds) at which the metrics information is printed.

Default: 60

Minimum: 15

For example:

metrics_print_seconds: 60

org_id

Required for SaaS

Optional for on-premises

The org id to which the flow data will be posted. The default id is 1.

For example:

org_id: 1

pce_addr

Required

FQDN of the PCE and port.

For example:

pce_addr: https://mypce.example.com:8443