name: loki-logql-query-specialist description: Query and analyze logs using Loki and LogQL. Provides patterns for correlation ID tracing, error investigation, and service debugging using HuleEdu's structured logging. Integrates with Context7 for latest Loki documentation.

Loki LogQL Query Specialist

Compact skill for querying HuleEdu logs using Loki and LogQL, with focus on correlation-based debugging.

Activate when the user:

Correlation ID Tracing: Find all logs across services for a given correlation ID
Error Investigation: Query patterns for error logs with context
Service-Specific Queries: Filter logs by service/container
JSON Field Extraction: Parse and filter structured log fields
Label Strategy: Understand promoted labels vs message content
Promtail Configuration: Label extraction and pipeline stages
Query Optimization: Performance patterns and best practices
Context7 Integration: Fetch latest Loki/LogQL documentation when needed

Identify debugging objective (correlation trace, error investigation, service health)
Select appropriate query pattern from reference
Build LogQL query using HuleEdu label conventions
Execute query in Grafana or via Loki API
Interpret results and iterate if needed

Trace by Correlation ID (most common):

{container=~"huleedu_.*"} |= "correlation_id_value"

Service-Specific Errors:

{container="huleedu_batch_orchestrator_service"} |= "ERROR"

JSON Field Filtering:

{container=~"huleedu_.*"} | json | level="error" | correlation_id!=""