---
icon: material/github
---

# GitHub Repositories

Repositories in the [log-10x](https://github.com/log-10x){target="_blank"} org are organized by the [App Guide](https://doc.log10x.com/apps/) adoption sequence: from compiling symbols and local testing, through cloud cost reporting, to edge optimization and data lake streaming.

<div style="text-align: center;">

```mermaid
graph LR
    A["⚙️ Compiler<br/>Generate Symbols"] --> B["🤖 MCP<br/>Cost POC"]
    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
```

</div>

## :material-table-search: Quick Reference

| I want to...                              | Repos                                                 |
|-------------------------------------------|-------------------------------------------------------|
| Drive 10x from your AI agent              | [log10x-mcp]                                          |
| Evaluate locally                          | [pipeline-releases] · [config]                        |
| Deploy edge with any forwarder            | [config] + your forwarder's upstream chart, see the [Receiver deployment guide](https://doc.log10x.com/apps/receiver/deploy/) |
| 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]                              |

---

## :material-download: Install & Configure

Get the engine, clone the config workspace, and start exploring.

| Repo | Purpose |
|------|---------|
| [log10x-mcp] | MCP server the AI agent runs (`npx log10x-mcp`) to drive the apps from a chat session |
| [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](https://doc.log10x.com/install/) · [Config Reference](https://doc.log10x.com/config/) · [Compiler](https://doc.log10x.com/compile/) · [Reporter](https://doc.log10x.com/apps/reporter/) · [MCP](https://doc.log10x.com/apps/)

---

## :material-upload-network-outline: In-Cluster Deployment

Deploy 10x apps to your Kubernetes cluster on top of your forwarder's **upstream** Helm chart. The integration model depends on the forwarder: a sidecar container (`log10x/edge-10x`) added via a values or kustomize overlay for Fluentd, Fluent Bit, Logstash, OpenTelemetry Collector, and Vector, or an image swap to the embedded 10x variant (`log10x/filebeat-10x`) for Filebeat. The Reporter runs as a DaemonSet alongside your forwarder; the Receiver runs in the forwarder path (sidecar or, for Filebeat, embedded).

| Forwarder | Upstream chart |
|-----------|----------------|
| Fluentd | `fluent/fluentd` (`log10x/edge-10x` sidecar via kustomize post-renderer overlay) |
| Fluent Bit | `fluent/fluent-bit` (`log10x/edge-10x` sidecar via extraContainers values overlay) |
| 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](https://doc.log10x.com/apps/receiver/deploy/) and the [Reporter deployment guide](https://doc.log10x.com/apps/reporter/deploy/).

**Docs:** [Reporter](https://doc.log10x.com/apps/reporter/) · [Receiver](https://doc.log10x.com/apps/receiver/) (Filter and Compact modes)

---

## :material-cloud-arrow-right-outline: 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](https://doc.log10x.com/apps/retriever/)

---

## :material-puzzle-outline: Extensions & Integrations

| Repo | Purpose |
|------|---------|
| [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 |

---

## :material-source-branch: GitOps & Operations

| Repo | Purpose |
|------|---------|
| [gitops-demo] | Example: manage Log10x config as code with GitOps |
| [status] | [status.log10x.com](https://status.log10x.com){target="_blank"}: uptime monitoring |


[pipeline-releases]: https://github.com/log-10x/pipeline-releases "log-10x/pipeline-releases"
[config]: https://github.com/log-10x/config "log-10x/config"
[log10x-mcp]: https://github.com/log-10x/log10x-mcp "log-10x/log10x-mcp"
[modules]: https://github.com/log-10x/modules "log-10x/modules"
[docker-images]: https://github.com/log-10x/docker-images "log-10x/docker-images"
[helm-charts]: https://github.com/log-10x/helm-charts "log-10x/helm-charts"
[terraform-aws-tenx-retriever-infra]: https://github.com/log-10x/terraform-aws-tenx-retriever-infra "log-10x/terraform-aws-tenx-retriever-infra"
[terraform-aws-tenx-retriever]: https://github.com/log-10x/terraform-aws-tenx-retriever "log-10x/terraform-aws-tenx-retriever"
[splunk-app]: https://github.com/log-10x/splunk-app "log-10x/splunk-app"
[elasticsearch-plugin]: https://github.com/log-10x/elasticsearch-plugin "log-10x/elasticsearch-plugin"
[prometheus-remote-write]: https://github.com/log-10x/prometheus-remote-write "log-10x/prometheus-remote-write"
[log10x-decoder-java]: https://github.com/log-10x/log10x-decoder-java "log-10x/log10x-decoder-java"
[log10x-decoder-js]: https://github.com/log-10x/log10x-decoder-js "log-10x/log10x-decoder-js"
[gitops-demo]: https://github.com/log-10x/gitops-demo "log-10x/gitops-demo"
[status]: https://github.com/log-10x/status "log-10x/status"