Home

Logsenta Wiki

The only Kubernetes log agent with intelligent error context capture, rule-based alerting, and 9 pluggable storage backends — from PostgreSQL to Azure, AWS, and GCP cloud logging.

---

Welcome to the Logsenta documentation wiki!

Quick Links

• Features - Complete feature overview and unique capabilities
• How It Works - Architecture overview with diagrams
• Installation Guide
• Configuration Reference
• Storage Backends
• Alerting - Email, Slack, Teams, PagerDuty, and webhook notifications
• Capacity Planning
• Troubleshooting

What is Logsenta?

Logsenta-Engine is a scalable Kubernetes log monitoring agent designed to capture and store pod logs with intelligent error detection and rule-based alerting. It monitors pod logs across configured namespaces, captures contextual log data when errors are detected, and sends alerts to configured recipients via email or webhooks.

Key Features

Feature	Description
Multi-namespace Monitoring	Monitor pods across multiple Kubernetes namespaces
Error Pattern Detection	Regex and string-based error pattern matching
Capture All Mode	Option to capture all logs regardless of patterns
Configurable Capture Window	Capture logs before and after error detection
Multiple Storage Backends	PostgreSQL, MongoDB, MySQL, InfluxDB, Elasticsearch, Azure Log Analytics, AWS CloudWatch, GCP Cloud Logging
High Availability	Leader election prevents duplicate processing
Scalability	ThreadPoolExecutor handles 500+ pods efficiently

Architecture Overview

┌─────────────────────────────────────────────────────────────┐
│                    Kubernetes Cluster                        │
├─────────────────────────────────────────────────────────────┤
│                                                              │
│  ┌──────────────┐    ┌──────────────┐    ┌──────────────┐  │
│  │   Pod A      │    │   Pod B      │    │   Pod C      │  │
│  │   (logs)     │    │   (logs)     │    │   (logs)     │  │
│  └──────┬───────┘    └──────┬───────┘    └──────┬───────┘  │
│         │                   │                   │           │
│         └───────────────────┼───────────────────┘           │
│                             │                               │
│                             ▼                               │
│              ┌──────────────────────────┐                   │
│              │    Logsenta-Engine       │                   │
│              │  ┌────────────────────┐  │                   │
│              │  │ Log Stream Watcher │  │                   │
│              │  │ Error Detection    │  │                   │
│              │  │ Context Capture    │  │                   │
│              │  └────────────────────┘  │                   │
│              └────────────┬─────────────┘                   │
│                           │                                 │
└───────────────────────────┼─────────────────────────────────┘
                            │
                            ▼
              ┌──────────────────────────┐
              │    Storage Backend       │
              │  (PostgreSQL/MongoDB/    │
              │   Azure/AWS/GCP/etc.)    │
              └──────────────────────────┘

Getting Started

# Clone the repository
git clone https://github.com/DevOpsArts/logsenta.git
cd logsenta

# Install with default settings
helm install logsenta-engine ./charts/logsenta-engine \
  --namespace logsenta \
  --create-namespace

See the Installation Guide for detailed instructions.

Support

• Issues: GitHub Issues
• Helm Charts: GitHub Repository