Skip to content

[Feature] <Support pulling logs from Grafana Loki as log source> #4090

@jingshaoyi

Description

@jingshaoyi

Feature Request

Support pulling logs from Grafana Loki as log source

Is your feature request related to a problem? Please describe

Currently, HertzBeat's log integration module supports receiving logs via OTLP protocol, but lacks native integration with Grafana Loki as a log source. Many users have deployed Loki for log storage and want HertzBeat to be able to pull logs from Loki for unified monitoring and analysis.

Describe the solution you'd like

Add native Loki log source integration to enable HertzBeat to pull logs from Loki:

Describe alternatives you've considered

  1. Loki Log Pulling: Configure Loki datasource URL and query parameters
  2. LogQL Support: Support LogQL query language for filtering and querying logs
  3. Real-time Streaming: Implement real-time log streaming from Loki using Loki's tail API
  4. Label Filtering: Filter logs by Loki labels (app, env, namespace, etc.)
  5. Time Range Query: Support configurable time range for log queries

Additional context

Benefits:

  • Unified Observability: Combine metrics from HertzBeat with logs from Loki
  • Cost Effective: Leverage existing Loki deployment
  • Powerful Queries: Use LogQL for precise log filtering
  • Grafana Ecosystem: Integrate with existing Grafana/Loki dashboards

Technical References:

Implementation Suggestions:

  1. Add Loki client library dependency (e.g., com.grafana:loki-client)
  2. Create LokiLogSource class implementing the log source interface
  3. Implement LogQL query parser and executor
  4. Add periodic polling or WebSocket streaming support
  5. Convert Loki log entries to HertzBeat's internal log format

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    Status

    To do

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions