🌈 Bifrost

Zero-Effort
Kubernetes Log Aggregation

Bifrost is a Kubernetes Operator that automatically deploys Grafana Alloy, Loki, and Grafana for complete log aggregation — with no manual configuration required.

Get Started View on GitHub
Quick Install
# Install Bifrost in your cluster kubectl apply -f https://raw.githubusercontent.com/peek8/bifrost/main/deploy/install.yaml
Why Bifrost?

From Complex to Simple

Stop wrestling with Helm charts, ConfigMaps, and interconnected services.

The Old Way

  • Install Alloy, Loki, and Grafana separately
  • Write and maintain complex YAML configurations
  • Manually configure datasources and connections
  • Debug integration issues between components
  • Update each component individually

The Bifrost Way

  • Apply one CRD and everything is deployed
  • Pre-configured and production-ready
  • Automatic datasource configuration
  • Components work together out of the box
  • Operator handles updates and reconciliation
Features

Everything You Need

A complete observability stack, deployed and managed automatically.

One-Command Deploy

Deploy the entire logging stack with a single kubectl apply command.

🔧

Auto-Configuration

Alloy, Loki, and Grafana are pre-configured to work seamlessly together.

📊

Grafana Dashboards

Access logs immediately through pre-configured Grafana dashboards.

🔄

Self-Healing

Kubernetes Operator pattern ensures continuous reconciliation and recovery.

📈

Scalable Architecture

Choose between simple mode for dev or scalable mode for production.

🎯

Namespace Filtering

Configure which namespaces to collect logs from with simple selectors.

Architecture

How It Works

Bifrost orchestrates a complete logging pipeline automatically.

📡 Grafana Alloy Collects logs from pods
💾 Loki Stores & indexes logs
📊 Grafana Visualize & query
Component Deployment Model
Grafana Alloy DaemonSet on all nodes
Loki StatefulSet with PVCs
Grafana Deployment with provisioning
Dashboard Managed dynamically by operator
Datasource Managed dynamically by operator
Quick Start

Get Started in Minutes

Three simple steps to complete log aggregation.

1

Install the Operator

Deploy Bifrost to your Kubernetes cluster.

kubectl apply -f https://raw.githubusercontent.com/peek8/bifrost/main/deploy/install.yaml
2

Create a LogPipeline

Define your logging configuration with a simple CRD.

apiVersion: bifrost.peek8.io/v1alpha1 kind: LogPipeline metadata: name: my-logs namespace: bifrost-system spec: loki: mode: simple grafana: enabled: true
3

Access Grafana

Port-forward and start exploring your logs.

kubectl port-forward svc/grafana 3000:3000 -n bifrost-system # Open http://localhost:3000 (admin/admin)
Roadmap

What's Coming

We're continuously improving Bifrost.

🔲 Metrics collection with Prometheus
🔲 Distributed tracing with Tempo
🔲 Alert management integration
🔲 Custom dashboard provisioning
🔲 Multi-cluster support
🔲 Log retention policies

Ready to simplify your logging?

Get started with Bifrost today and experience zero-effort Kubernetes log aggregation.

Star on GitHub Report an Issue