Coralogix Open Source Integrations repository is Coralogix's way to ship our best practices when it comes to interaction with our platform, as well as collaborating with our users. Currently we support:
Logging integrations, Fluentd and Fluentbit,
Metrics integrations, Prometheus,
Tracing integrations, OpenTelemetry.
Please see #Getting Started for more information about the existing integrations.
This repository contains directories for each integration type, logs and metrics, and open-telemetry that can send all.
Inside each integration type there are multiple ways to install our integrations, using helm, installing kubernetes manifests directly, using a docker image or installing a service.
All K8s integrations, both helm and manifests, require a secret
called coralogix-keys
with the relevant private key
under a secret key called PRIVATE_KEY
,
inside the same namespace
that the integration is installed in.
- The
private key
appears under 'Data Flow' --> 'API Keys' in Coralogix UI:
kubectl create secret generic coralogix-keys \
-n <the-namespace-of-the-integrations> \
--from-literal=PRIVATE_KEY=<private-key>
for more information regarding the coralogix private key please visit here
The created secret should look like this:
apiVersion: v1
data:
PRIVATE_KEY: <encrypted-private-key>
kind: Secret
metadata:
name: coralogix-keys
namespace: <the-integration-namespace>
type: Opaque
In the 'logs' integrations inside the 'k8s-helm' there are two supported helm charts
, one using the Coralogix
output plugin,
and another one using the http
output plugin.
We recommend using the http
chart, since it's an open source plugin, and therefore it is more community driven.
Under each integration there is an 'image' directory which our GitHub Actions workflows use in order to build the image and publish it to DockerHub.
Our Helm charts repository can be added to the local repos list with the following command. It will create a repository named coralogix-charts-virtual
. If you wish to change it to anything else, be sure to adapt your commands in the other segments referring to this repository.
helm repo add coralogix-charts-virtual https://cgx.jfrog.io/artifactory/coralogix-charts-virtual
In order to get the updated helm charts from the added repository, please run:
helm repo update
For installation of each integration, please go inside each intergation's directory:
Our k8s manifests integration allow you to install without the use of Helm, specifically for those times were using helm is impossible.
For installation of each integration, please go inside each intergation's directory: