Enable Fleet Management for Kubernetes OpenTelemetry Collectors

Overview

Use this guide to enable remote configuration in Fleet Management for OpenTelemetry Collectors deployed through the Coralogix Kubernetes integration. After deployment, Fleet Manager provides centralized control over Agent, Cluster Collector, and Gateway configurations.

Fleet Management uses the OpenTelemetry Supervisor to apply remote configuration safely. Each Collector instance includes a Supervisor that polls the Fleet Manager, retrieves configuration updates, and restarts the Collector if needed.

See the Supervisor and configuration flow details in the Fleet Manager architecture documentation and Configuration deep dive.

Set up Fleet Management for Kubernetes

Before you begin

• Ensure that kubectl is installed.

• Ensure you run the installation with Helm v3.9+. To check the version run the following command:

  helm version

Step 1: Configure the Kubernetes OTel integration

1. Follow the installation steps of the Kubernetes Complete Observability integration in the Coralogix UI.

2. Select the features you want to deploy (APM, Logs, Metrics, eBPF, and others).

   

3. In Additional features, turn off the Fleet Management toggle.

   You disable it here because you will enable Fleet manually in the deployment manifest.

Step 2: Download the integration package

At the end of the integration flow:

1. Download the otel-config.zip file.
2. Save the package locally. You will use these configuration files when creating Fleet templates.

The ZIP includes recommended baseline configurations for the Agent, Cluster Collector, and Gateway.

Step 3: Edit the deployment code

1. In the final installation step, select Deployment code.

   

2. Modify only three sections in the full Helm values YAML:

   • opentelemetry-cluster-collector
   • opentelemetry-agent
   • opentelemetry-gateway

All other sections must remain unchanged.

Step 4: Update the deployment to enable Fleet Management

Replace the three OTel Collector sections with the following Fleet-enabled configuration.

opentelemetry-cluster-collector

opentelemetry-cluster-collector:
  presets:
    fleetManagement:
      enabled: true
      agentType: "cluster-collector"
      supervisor:
        enabled: true

opentelemetry-agent

opentelemetry-agent:
  presets:
    fleetManagement:
      enabled: true
      agentType: "agent"
      supervisor:
        enabled: true

opentelemetry-gateway

opentelemetry-gateway:
  enabled: true
  replicaCount: 2
  presets:
    fleetManagement:
      enabled: true
      agentType: "gateway"
      supervisor:
        enabled: true

Note: The Gateway replica count (replicaCount) can be increased if needed.

Step 5: Deploy the integration

Deploy the updated values file using the command shown in the integration UI. Example:

helm upgrade --install otel-coralogix-integration coralogix/otel-integration --version=0.0.243 --namespace default --render-subchart-notes --values - <<'EOF' 
global:
  domain: coralogix.com
  clusterName: test
opentelemetry-cluster-collector:
  presets:
    fleetManagement:
      enabled: true
      agentType: "cluster-collector"
      supervisor:
        enabled: true
opentelemetry-agent:
  presets:
    fleetManagement:
      enabled: true
      agentType: "agent"
      supervisor:
        enabled: true
opentelemetry-gateway:
  enabled: true
  replicaCount: 2
  presets:
    fleetManagement:
      enabled: true
      agentType: "gateway"
      supervisor:
        enabled: true
coralogix-ebpf-profiler:
  enabled: false
opentelemetry-ebpf-instrumentation:
  enabled: false
coralogix-operator:
  enabled: false
EOF

When deployed:

• Each Collector starts with a minimal bootstrap configuration.

• The Supervisor becomes responsible for merging and applying remote configuration.

  (See configuration behavior overview in the Config Drilldown documentation.)

Step 6: Validate the deployment

After deploying the integration, verify that your Collectors and Supervisors have successfully registered with Fleet Manager.

1. Access Fleet Management, then Agents.
2. Confirm that all expected Agents, Cluster Collectors, and Gateways appear.

If agents appear correctly, Fleet connectivity is working and you can proceed to create and activate configurations.

Step 7: Create a configuration group in Fleet Management

1. Access Fleet Management, then Configurations.
2. Select + New configuration.

This opens a new configuration group, which contains all versions of a single configuration and/or a configuration family.

Configuration families let you maintain synchronized configurations, like Agent, Cluster Collector, and Gateway. Learn more in our Fleet Management Configuration guide.

Step 8: Add the three configurations to form a configuration family

Create three new configurations for the Agent, Cluster Collector and Gateway using the files in otel.zip.

In each configuration, set the cluster selector value you plan to use:

• cx.cluster.name = <your-cluster-name>

Use the table below to complete each configuration in the family.

Configuration type	Required selectors	Configuration to paste
Agent	cx.agent.type = agent	agent.yaml
Cluster Collector	cx.agent.type = cluster-collector	cluster-collector.yaml
Gateway	cx.agent.type = gateway	gateway.yaml

Step 9: Save a configuration family version

Follow these steps to save and optionally activate the new version.

1. Select Save in the configuration editor.
2. (Optional) Select Activate immediately to apply the new version to all matching agents as soon as it is saved.
3. Select Save to create the new version.

The configuration group now includes the new configuration family version, and—if activation was selected—the Supervisor on each matching agent will pull and apply it.

Step 10: Check configuration status

Verify that the configuration list loads and displays each configuration family with:

• Current state (Active or Inactive)
• Agent application status (Healthy, Warning, Error)
• Version information

Support

Need help?

Our world-class customer success team is available 24/7 to walk you through your setup and answer any questions that may come up.

Feel free to reach out to us via our in-app chat or by sending us an email at support@coralogix.com.