1. Prerequisites

• Go: Version 1.24 or later installed (Download Go)
• Docker & Docker Compose: Installed and running (Download Docker Desktop)
• curl or Postman: For testing API endpoints

2. Clone the Repository

git clone https://github.com/Rzmy7/logLogger.git
cd logLogger

3. Environment Configuration

Copy the example environment file and adjust if necessary:

cp .env.example .env

Default local .env values:

POSTGRES_URL=postgresql://postgres:password@localhost:5432/log_analytics?sslmode=disable
REDIS_URL=redis://localhost:6379
KAFKA_BROKERS=localhost:9092
ELASTICSEARCH_URL=http://localhost:9200
HTTP_PORT=8081
ANALYTICS_PORT=8082
PROCESSOR_METRICS_PORT=8083
LOG_LEVEL=info

4. Start Infrastructure with Docker Compose

Start Kafka, Elasticsearch, Redis, PostgreSQL, Prometheus, and Grafana:

docker compose -f deployments/docker-compose.yml up -d

Verify running containers:

docker ps

| Service | Port | Health Check URL | |---|---|---| | Kafka Broker | 9092 | localhost:9092 | | Elasticsearch | 9200 | http://localhost:9200 | | Redis | 6379 | localhost:6379 | | PostgreSQL | 5432 | localhost:5432 | | Prometheus | 9090 | http://localhost:9090/-/healthy | | Grafana | 3000 | http://localhost:3000 (admin/admin) |

5. Run the Go Services

Open separate terminals to run each service:

# Terminal 1: Ingestor Service (:8081)
go run ./cmd/ingestor

# Terminal 2: Stream Processor (:8083 metrics)
go run ./cmd/processor

# Terminal 3: Analytics API (:8082)
go run ./cmd/analytics

---