Note

The Fluent Bit Coralogix Helm chart is no longer supported. We recommend using the official [Fluent Bit Helm chart](https://coralogix.com/docs/integrations/kubernetes/fluent-bit-helm-chart-migration/index.md) instead.

Use our multi-arch [Helm chart](https://github.com/coralogix/telemetry-shippers/blob/master/logs/fluent-bit/k8s-helm/http/README.md) to streamline your Kubernetes monitoring by creating a DaemonSet on your [Kubernetes](http://kubernetes.io/) cluster using the [Helm](https://helm.sh/) package manager.

## Prerequisites

- Kubernetes 1.20+ with Beta APIs enabled
- Helm 2.9+ package manager [installed](https://helm.sh/)

## Installation

**STEP 1**. Create a namespace for the DaemonSet. The following example adopts the namespace **coralogix-logger**.

```shell
kubectl create namespace coralogix-logger
```

**STEP 2**. Create a secret key using your Coralogix [Send-Your-Data API key](https://coralogix.com/docs/user-guides/account-management/api-keys/send-your-data-api-key/index.md).

```shell
kubectl create secret generic coralogix-keys \
        -n coralogix-logger \
        --from-literal=PRIVATE_KEY=<Send-Your-Data API Key>
```

**STEP 3**. Add the Helm Chart Repo and run an update to fetch it.

```shell
helm repo add coralogix-charts-virtual https://cgx.jfrog.io/artifactory/coralogix-charts-virtual &&
helm repo update
```

**STEP 4**. Create an `override.yaml` to override particular settings.

- `endpoint`: Input the **[OpenTelemetry endpoint](https://coralogix.com/docs/integrations/coralogix-endpoints/index.md)** associated with your Coralogix domain.
- `dynamic_metadata`: You may change the dynamic field from which we extract the [application and subsystem name](https://coralogix.com/docs/user-guides/account-management/account-settings/application-and-subsystem-names/index.md) or a static value to overwrite these names.

```yaml
---
# fluentbit-override.yaml:
dynamic_metadata:
  app_name: kubernetes.namespace_name
  sub_system: kubernetes.container_name
fluent-bit:
  endpoint: ingress.[[DOMAIN_VALUE]]:443
  logLevel: error
```

```yaml
---
# fluentbit-override.yaml:
static_metadata:
  app_name: MyApplication
  sub_system: MySubsystem
fluent-bit:
  endpoint: ingress.[[DOMAIN_VALUE]]:443
  logLevel: error
```

- If a dynamic variable includes special characters, it **must** be declared in a different notation, such as the following. Failure to do so will result in LUA exceptions and failure to process properly.

```yaml
  app_name: kubernetes.labels["k8s-app"]
  app_name: kubernetes.labels["app.kubernetes.io/name"]
```

**STEP 5**. Deploy the Helm Chart.

```bash
helm upgrade fluent-bit-http coralogix-charts-virtual/fluent-bit-http \
  --install \
  --namespace=coralogix-logger \
  -f fluentbit-override.yaml
```

## Remove the Daemonset

**STEP 6**. Remove the DaemonSet.

```bash
helm uninstall fluent-bit-http \
     -n coralogix-logger
```

**Notes**:

- `podsecuritypolicy` has been deprecated for **Kubernetes v1.25+**.
- Disable this by adding the following to your override file:

```yaml
podSecurityPolicy:
  create: false
```

## Additional Resources

Review and make suggestions for improvement for our Helm chart in our [Integrations Repository](https://github.com/coralogix/telemetry-shippers/blob/master/logs/fluent-bit/k8s-helm/http/README.md).

## 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](mailto:support@coralogix.com).