GitHub Repositories
Repositories in the log-10x org are organized by the App Guide adoption sequence — from compiling symbols and local testing, through cloud cost reporting, to edge optimization and data lake streaming.
graph LR
A["⚙️ Compiler<br/>Generate Symbols"] --> B["💻 Dev<br/>Test Locally"]
B --> C["📊 Reporter<br/>Analyze Costs (DaemonSet)"]
C --> D["⚡ Receiver<br/>Filter or Compact @ Source"]
D --> E["☁️ Retriever<br/>S3 Data Lake"]
classDef compiler fill:#6366f1,stroke:#4f46e5,color:#ffffff,stroke-width:2px,rx:8,ry:8
classDef dev fill:#8b5cf6,stroke:#7c3aed,color:#ffffff,stroke-width:2px,rx:8,ry:8
classDef reporter fill:#06b6d4,stroke:#0891b2,color:#ffffff,stroke-width:2px,rx:8,ry:8
classDef edge fill:#10b981,stroke:#059669,color:#ffffff,stroke-width:2px,rx:8,ry:8
classDef cloud fill:#f59e0b,stroke:#d97706,color:#ffffff,stroke-width:2px,rx:8,ry:8
class A compiler
class B dev
class C reporter
class D edge
class E cloud
Quick Reference
| I want to... | Repos |
|---|---|
| Evaluate locally | pipeline-releases · config |
| Deploy edge with any forwarder | config + your forwarder's upstream chart — see the Receiver deployment guide |
| Stream logs to S3 | helm-charts · terraform-aws-tenx-retriever-infra |
| Search compact events in Splunk | splunk-app |
| Search compact events in Elasticsearch | elasticsearch-plugin |
| Manage config as GitOps | gitops-demo · config |
Install & Configure
Get the engine, clone the config workspace, and start exploring.
| Repo | Purpose |
|---|---|
| pipeline-releases | Engine binaries and install scripts |
| config | Your working directory — apps, pipelines, data templates |
| modules | Pre-built app and pipeline definitions (reference) |
| docker-images | Container images for the engine |
Docs: Install Guide · Config Reference · Compiler · Dev · Reporter · MCP
In-Cluster Deployment
Deploy 10x apps to your Kubernetes cluster on top of your forwarder's upstream Helm chart — a values overlay adds the 10x sidecar (or, for Filebeat, swaps the image to log10x/filebeat-10x). The Reporter runs as a DaemonSet alongside your forwarder; the Receiver runs as a sidecar in the forwarder path.
| Forwarder | Upstream chart |
|---|---|
| Fluentd | fluent/fluentd |
| Fluent Bit | fluent/fluent-bit |
| Filebeat | elastic/filebeat (image swap to log10x/filebeat-10x) |
| Logstash | elastic/logstash |
| OpenTelemetry Collector | open-telemetry/opentelemetry-collector |
| Vector | vector/vector |
The full per-forwarder values overlay (license wiring, sidecar injection, return-path config) lives in the Receiver deployment guide and the Reporter deployment guide.
Docs: Reporter · Receiver (Filter and Compact modes)
Retriever
Store optimized logs in S3 and query on-demand. Provision infrastructure with Terraform, deploy with Helm.
| Repo | Purpose |
|---|---|
| helm-charts | Helm charts for Retriever and Cron pipelines |
| terraform-aws-tenx-retriever-infra | Terraform: SQS queues + S3 indexing infrastructure |
| terraform-aws-tenx-retriever | Terraform: Retriever application deployment |
Docs: Retriever Guide
Extensions & Integrations
| Repo | Purpose |
|---|---|
| pipeline-extensions | Java extensions: custom inputs, outputs, scanners |
| splunk-app | Splunk app — search/visualize compact events with zero data loss |
| elasticsearch-plugin | Elasticsearch/OpenSearch plugin — transparent query rewriting and _source expansion for compact events |
| log10x-decoder-java | Java library for expanding compact events in JVM applications and pipelines |
| log10x-decoder-js | JavaScript library for expanding compact events in Node.js and browser environments |
| prometheus-remote-write | Push 10x metrics to Prometheus via remote write protocol |
GitOps & Operations
| Repo | Purpose |
|---|---|
| gitops-demo | Example: manage Log10x config as code with GitOps |
| status | status.log10x.com — uptime monitoring |