Install AxoSyslog with Helm

AxoSyslog provides Helm charts for syslog-ng. You can use these charts to install cloud-ready syslog-ng images created and maintained by Axoflow.

Prerequisites

You must have Helm 3.0 or newer installed to use these charts. Refer to the official Helm documentation for details.

Limitations

The chart provides parameters that make it easy to:

• collect logs using the kubernetes() source, and
• forward the logs using the network() and opensearch() destinations.

To use other sources and destinations, use the config.raw parameter. For the list of configurable parameters and their default values, see Parameters of the AxoSyslog collector Helm chart.

Install

To install the axosyslog-collector charts, complete the following steps.

1. Clone the chart repository.

   helm repo add axosyslog https://axoflow.github.io/axosyslog-charts
   helm repo update
   

2. Install the chart. The following command installs axosyslog-collector into the default namespace. For the list of configurable parameters and their default values, see Parameters of the AxoSyslog collector Helm chart.

   helm install --generate-name axosyslog/axosyslog-collector
   

   NAME: axosyslog-collector-1683469360
   LAST DEPLOYED: Sun May  7 16:22:40 2023
   NAMESPACE: default
   STATUS: deployed
   REVISION: 1
   TEST SUITE: None
   NOTES:
   1. Watch the axosyslog-collector-1683469360 container start.
     $ kubectl get pods --namespace=default -l app=axosyslog-collector-1683469360 -w
   

3. Check that the pod is running.

   kubectl get pods
   

   The output should look like:

   NAME                                   READY   STATUS    RESTARTS   AGE
   axosyslog-collector-1683469360-tptfb   1/1     Running   0          28s
   

Uninstall

Tip: List all installed releases using helm list.

To uninstall a chart release, run:

helm delete <name-of-the-release-to-delete>

Contribute

If you have fixed a bug or would like to contribute your improvements to these charts, open a pull request. We truly appreciate your help.