TELEMETRY PIPELINE
Add an agent to a fleet

Add an agent to a fleet

After you've created a fleet, you can add supported telemetry agents to that fleet.

Add a Fluent Bit agent

Requires Fluent Bit v2.1.8 or later.

To add a Fluent Bit agent to a fleet:

YAML configuration is only supported in Chronosphere Telemetry Pipeline v2.25.0 or later, and requires Fluent Bit v3.2 or later. Additionally, to use YAML configuration files for individual agents in a fleet, the fleet_config_legacy_format parameter in that fleet's configuration file must be set to false.

  1. If necessary, install a new Fluent Bit agent (opens in a new tab).

  2. Update the customs section in the configuration file for that agent.

    customs:
      - name: calyptia
        api_key: 'KEY'
        fleet_name: 'NAME'
        fleet.interval_sec: SECONDS
        fleet.interval_nsec: NANOSECONDS
        fleet_config_legacy_format: false

    Replace the following values:

    • KEY: The API token you use to authenticate with Telemetry Pipeline.
    • NAME: The name of the fleet to which your agent will be added.
    • SECONDS: How often, in seconds, this agent should check for configuration updates. If unspecified, defaults to 15.
    • NANOSECONDS: How often, in nanoseconds, this agent should check for configuration updates. If unspecified, defaults to 0.
  3. Run the following command:

    fluent-bit -c CONFIG

    Replace CONFIG with the name of the configuration file you updated in the previous step.

Add a Core Agent

Requires Core Agent v23.4.5 or later.

To add an instance of Core Agent to a fleet:

YAML configuration is only supported in Chronosphere Telemetry Pipeline v2.25.0 or later, and requires Core Agent v25.1.1 or later. Additionally, to use YAML configuration files for individual agents in a fleet, the fleet_config_legacy_format parameter in that fleet's configuration file must be set to false.

  1. If necessary, install a new instance of Core Agent (opens in a new tab).

  2. Update the customs section in the configuration file for that agent.

    customs:
      - name: calyptia
        api_key: 'KEY'
        fleet_name: 'NAME'
        fleet.interval_sec: SECONDS
        fleet.interval_nsec: NANOSECONDS
        fleet_config_legacy_format: false

    Replace the following values:

    • KEY: The API token you use to authenticate with Telemetry Pipeline.
    • NAME: The name of the fleet to which your agent will be added.
    • SECONDS: How often, in seconds, this agent should check for configuration updates. If unspecified, defaults to 15.
    • NANOSECONDS: How often, in nanoseconds, this agent should check for configuration updates. If unspecified, defaults to 0.
  3. Run the following command:

    calyptia-fluent-bit -c CONFIG

    Replace CONFIG with the name of the configuration file you updated in the previous step.