Loki Component
Log aggregation system from Grafana. Stores logs in S3-compatible storage with label-based indexing for cost-effective log management.
Architecture
Loki Server - Log aggregation + query
Distributor - Ingestion endpoint
Ingester - Write path + chunking
Querier - Read path + LogQL
Storage - S3/MinIO/SeaweedFS backend
Quick Reference
| Attribute |
Example |
Default |
Effect |
namespace REQ |
loki |
- |
Kubernetes namespace |
retention_period |
720h |
720h |
Log retention (30 days) |
deployment_mode |
SingleBinary |
SingleBinary |
SingleBinary, SimpleScalable |
replicas |
1 |
1 |
Loki instance count |
Link Variables
| Variable |
Link Type |
Purpose |
__minio |
loki-minio |
MinIO S3 storage backend |
__bucket |
loki-bucket |
MinIO bucket for chunks |
__swbucket |
loki-seaweedfs (bucket) |
SeaweedFS S3 bucket |
__prometheus |
prometheus-loki |
Metrics scraping |
Storage Configuration
__bucket or __swbucket link auto-configures:
- S3 endpoint URL
- Bucket name for chunks
- Access credentials
- Region (minio for MinIO)
- s3ForcePathStyle: true
Storage schema:
- boltdb-shipper for index
- S3 for chunks
Generated Files
| File |
Condition |
Contains |
| helm/helm-values.yaml |
Always |
Loki Helm configuration |
| config/loki.yaml |
Always |
Loki server configuration |
Ports
| Port |
Purpose |
Protocol |
| 3100 |
HTTP API (push/query) |
HTTP |
| 9095 |
gRPC (internal) |
gRPC |
| 7946 |
Memberlist (gossip) |
TCP/UDP |
API Endpoints
POST /loki/api/v1/push - Log ingestion
GET /loki/api/v1/query - Instant query
GET /loki/api/v1/query_range - Range query
GET /loki/api/v1/labels - Label names
GET /loki/api/v1/label/{name}/values - Label values
GET /ready - Readiness check
GET /metrics - Prometheus metrics
Technical Info
Chart Version: 4.7.4
Ports: 3100 (HTTP), 9095 (gRPC)
Query Language: LogQL