Open Source·AI-Powered·Self-Hostable

AI-Powered Log Analysis for Microservices

Stream, analyze, and debug logs in real-time. Centralized visibility powered by Kafka, Elasticsearch, and AI — set up in under 5 minutes.

MIT License
Docker Ready
Java SDK
Zero Vendor Lock-in
LogSpectra Dashboard
Live
14:23:01.234INFOgatewayRequest processed successfully
14:23:01.456WARNauth-svcToken expiring in 5 minutes
14:23:01.789INFOuser-svcUser profile updated
14:23:02.012ERRORpaymentPayment gateway timeout
Open Source

Built in the open. Owned by you.

MIT Licensed

Use it, modify it, ship it. No strings attached.

Self-Hostable

One Docker command. Runs on your infra.

Fully Customizable

Swap components, extend pipelines, fork freely.

What is LogSpectra

Everything you need for log observability

From ingestion to AI-powered root cause analysis — LogSpectra closes the full loop.

AI Root Cause Detection

Automatically surfaces anomalies and suggests fixes using LLM-based analysis.

Real-Time Log Streaming

Logs flow instantly via Kafka — no polling, no lag, true streaming.

Kafka + Elasticsearch Pipeline

Battle-tested data pipeline. Scalable, fault-tolerant, production-ready.

Zero-Code SDK Integration

Add one Maven dependency and one YAML block. Nothing else required.

Architecture

Simple pipeline. Powerful outcomes.

Microservices
Kafka
Elasticsearch
LogSpectra Backend
AI Engine
Dashboard UI
< 5 minAverage setup time
< 200msLog ingestion latency
100%Open source
Quick Start

From zero to monitoring in minutes.

1

Download Setup

docker-compose.yml
version: '3.8'

services:
  postgres:
    image: postgres:15
    environment:
      POSTGRES_DB: ${POSTGRES_DB:-logspectra}
      POSTGRES_USER: ${POSTGRES_USER:-logspectra}
      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:-logspectra}
    ports:
      - "5432:5432"
    volumes:
      - postgres_data:/var/lib/postgresql/data

  zookeeper:
    image: confluentinc/cp-zookeeper:7.4.0
    environment:
      ZOOKEEPER_CLIENT_PORT: 2181
      ZOOKEEPER_TICK_TIME: 2000

  kafka:
    image: confluentinc/cp-kafka:7.4.0
    depends_on:
      - zookeeper
    ports:
      - "${KAFKA_HOST_PORT:-9092}:9092"
    environment:
      KAFKA_BROKER_ID: 1
      KAFKA_ZOOKEEPER_CONNECT: zookeeper:2181
      KAFKA_ADVERTISED_LISTENERS: PLAINTEXT://localhost:${KAFKA_HOST_PORT:-9092}
      KAFKA_OFFSETS_TOPIC_REPLICATION_FACTOR: 1

  elasticsearch:
    image: docker.elastic.co/elasticsearch/elasticsearch:8.11.0
    environment:
      - discovery.type=single-node
      - xpack.security.enabled=false
    ports:
      - "9200:9200"
    volumes:
      - es_data:/usr/share/elasticsearch/data

  logspectra:
    image: ghcr.io/kmvipin/logspectra:latest
    depends_on:
      - postgres
      - kafka
      - elasticsearch
    ports:
      - "${APP_HOST_PORT:-8080}:8080"
    environment:
      SPRING_DATASOURCE_URL: jdbc:postgresql://postgres:5432/${POSTGRES_DB:-logspectra}
      SPRING_DATASOURCE_USERNAME: ${POSTGRES_USER:-logspectra}
      SPRING_DATASOURCE_PASSWORD: ${POSTGRES_PASSWORD:-logspectra}
      KAFKA_BOOTSTRAP_SERVERS: kafka:9092
      ELASTICSEARCH_HOST: elasticsearch
      ELASTICSEARCH_PORT: 9200

volumes:
  postgres_data:
  es_data:
2

Run the System

docker-compose up -d
No need to edit docker-compose.yml directly. All values have sensible defaults and are fully overridable via environment variables.
3

Access the UI

URL:
http://localhost:8080
Username:admin
Password:admin
Change credentials after first login
4

Create a Project

In the LogSpectra UI, create a new project. Each project groups logs from one or more services.

New Project

my-microservices
Production microservices logs

After creation, copy your Project ID — you'll need it in the next step.

Project ID:
proj_a1b2c3d4e5f6
5

Configure SDK

Add this configuration to your application.yml:

application.yml
logspectra:
  enabled: true
  service-name: gateway-service
  project-id: YOUR_PROJECT_ID
  kafka:
    enabled: true
    bootstrap-servers: localhost:9092
    topic: service-logs
service-nameIdentifies which microservice sent this logproject-idLinks logs to your project in the UI
6

Add Maven Dependency

pom.xml
<dependency>
  <groupId>com.github.kmvipin</groupId>
  <artifactId>logspectra-starter</artifactId>
  <version>v1.0.1</version>
</dependency>

The starter auto-configures log interception. No additional code required — just the dependency and YAML above.

7

View Logs

Your logs are now flowing into LogSpectra.

  • Open the dashboard → select your project → watch logs arrive in real-time.
  • Use the AI Analysis tab to automatically detect anomalies and get root cause suggestions.
Open Dashboard
Why LogSpectra

Built for teams who can't afford blind spots.

Cut Debugging Time

Stop grep-ing through files. Find the root cause in seconds, not hours.

Centralized Observability

One dashboard for all your services. No more switching between log files.

AI-Powered Insights

Not just logs — understanding. AI surfaces patterns humans miss.

Zero-Code Integration

One dependency. One YAML block. Works with any Spring Boot service instantly.

Start monitoring your logs in minutes.

Free forever. No account needed. Runs entirely on your infrastructure.

View on GitHub