Integrations
Grafana Loki
Connect Castrel to Grafana Loki for log aggregation and analysis.
Overview
- Connector Name:
loki - Supported API Version: Grafana Loki HTTP API v1
- Supported Server Versions: Grafana Loki v3.0.0 and later
- Official Documentation: Grafana Loki Docs
Configuration
To use the Loki tools, you need to configure a Connector with the following fields:
| Field | Required | Description |
|---|---|---|
instance_name | Yes | Instance name to identify this connector instance. |
base_url | Yes | The base URL of your Loki server (e.g., http://loki:3100). |
auth_type | Yes | Set to none or basic. |
username | No | Basic Auth username. |
password | No | Basic Auth password. |
org_id | No | Organization ID for multi-tenant Loki setups (sets X-Scope-OrgID header). |
verify_ssl | No | SSL certificate verification (default: true). |
Available Tools
This connector provides a comprehensive set of tools for Loki log queries.
- Log queries: Execute LogQL instant queries (
/loki/api/v1/query) - Range queries: Execute LogQL range queries for time-windowed log streams
- Label exploration: List available label names and label values
- Stream filtering: Filter log streams by label selectors
Mention Support
Supports @loki in conversations to quickly select log stream labels via a three-column drill-down (label name → label value → operation).