Grafana Loki

aid: grafana-loki
name: Grafana Loki
description: Grafana Loki is Grafana Labs' open source log aggregation system — "like Prometheus, but for logs." Rather than
  full-text indexing log contents, Loki indexes only a small set of labels per log stream and stores the compressed lines
  in object storage, which is what makes it cheap to run at scale. It is queried with LogQL, a Prometheus-inspired query language,
  over an HTTP API that covers ingestion, querying, label and pattern discovery, live tailing over WebSocket, a Prometheus-compatible
  ruler for alerting and recording rules, and a cancellable log deletion API. Loki accepts native pushes and OpenTelemetry
  OTLP/HTTP logs, publishes proto3 gRPC service definitions for its push and query paths, and ships a first-party CLI (LogCLI),
  Helm charts, a Kubernetes operator, and Docker images. It is licensed AGPL-3.0 and self-hosted; the same engine is sold
  as the managed Grafana Cloud Logs service and as the self-managed Grafana Enterprise Logs distribution.
image: https://grafana.com/media/docs/loki/logo-grafana-loki.png
url: https://raw.githubusercontent.com/api-evangelist/grafana-loki/refs/heads/main/apis.yml
x-type: company
x-source: harvest:self-hosted-agent-stack
specificationVersion: '0.20'
created: '2026-08-27'
modified: '2026-08-27'
tags:
- Company
- Logs
- Logging
- Log Aggregation
- Observability
- Monitoring
- Open Source
- LogQL
- OpenTelemetry
- Telemetry
- Kubernetes
- Cloud Native
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com
- FN: APIs.json
  email: info@apis.io
apis:
- aid: grafana-loki:loki-http-api
  name: Loki HTTP API
  description: The Grafana Loki HTTP API — 40 documented endpoints for pushing logs (native and OTLP), querying with LogQL
    over instants and ranges, discovering labels, series, patterns and detected fields, streaming a live tail over WebSocket,
    managing Prometheus-shaped alerting and recording rule groups, submitting and cancelling log deletion requests, and reading
    component status and ring state. Loki is self-hosted software, so the base host is whichever address the operator binds;
    the documented default port is 3100 and TLS is terminated by the operator or a fronting proxy. Authorization is explicitly
    not part of this API.
  humanURL: https://grafana.com/docs/loki/latest/reference/loki-http-api/
  baseURL: http://{loki-host}:3100
  tags:
  - Logs
  - Logging
  - Observability
  - LogQL
  - OpenTelemetry
  properties:
  - type: Documentation
    url: https://grafana.com/docs/loki/latest/
  - type: APIReference
    url: https://grafana.com/docs/loki/latest/reference/loki-http-api/
  - type: GettingStarted
    url: https://grafana.com/docs/loki/latest/get-started/
  - type: Protobuf
    url: grpc/grafana-loki-push.proto
    name: Loki Pusher service (proto3)
  - type: Protobuf
    url: grpc/grafana-loki-logproto.proto
    name: Loki Querier and StreamData services (proto3)
  - type: Protobuf
    url: grpc/grafana-loki-rules.proto
    name: Loki ruler rule group messages (proto3)
- aid: grafana-loki:grafana-cloud-logs-api
  name: Grafana Cloud Logs API
  description: Grafana Cloud Logs is the fully managed Grafana Loki service. It serves the same Loki HTTP API on a per-stack
    host of the form logs-prod-<cluster>.grafana.net, authenticated with HTTP Basic where the username is the tenant and the
    password is an access policy token carrying logs:read, logs:write or logs:delete. A free tier allows 50 GB of ingest per
    month with 14 day retention.
  humanURL: https://grafana.com/docs/grafana-cloud/send-data/logs/
  baseURL: https://logs-prod-{cluster}.grafana.net
  tags:
  - Logs
  - Observability
  - Managed Service
  properties:
  - type: Documentation
    url: https://grafana.com/docs/grafana-cloud/send-data/logs/
  - type: APIReference
    url: https://grafana.com/docs/loki/latest/reference/loki-http-api/
  - type: Pricing
    url: https://grafana.com/pricing/
- aid: grafana-loki:grafana-mcp-loki-tools
  name: Grafana MCP Server — Loki tools
  description: Grafana Loki reaches MCP clients through the Grafana Labs MCP servers, which register a Loki tool family (query_loki_logs,
    list_loki_label_names, list_loki_label_values, query_loki_stats, query_loki_patterns, analyze_loki_labels, suggest_loki_alloy_label_config).
    The hosted Grafana Cloud MCP server answers at https://mcp.grafana.com/mcp over streamable HTTP with OAuth 2.1; the open
    source grafana/mcp-grafana server runs locally over stdio, SSE or streamable HTTP.
  humanURL: https://grafana.com/docs/grafana-cloud/ai-tools/mcp-servers/cloud-mcp/
  baseURL: https://mcp.grafana.com/mcp
  tags:
  - MCP
  - Agents
  - Logs
  properties:
  - type: MCPServer
    url: mcp/grafana-loki-mcp.yml
    name: Grafana MCP server (Loki tools)
  - type: ToolCrosswalk
    url: mcp/grafana-loki-tool-crosswalk.yml
  - type: Documentation
    url: https://grafana.com/docs/grafana/latest/developer-resources/mcp/
  - type: GitHubOrganization
    url: https://github.com/grafana/mcp-grafana
common:
- type: Website
  url: https://grafana.com/oss/loki/
- type: DeveloperPortal
  url: https://grafana.com/docs/loki/latest/
- type: Documentation
  url: https://grafana.com/docs/loki/latest/
- type: APIReference
  url: https://grafana.com/docs/loki/latest/reference/loki-http-api/
- type: GettingStarted
  url: https://grafana.com/docs/loki/latest/get-started/
- type: Support
  url: https://community.grafana.com/
- type: Blog
  url: https://grafana.com/blog/
- type: GitHubOrganization
  url: https://github.com/grafana
- type: SourceCode
  url: https://github.com/grafana/loki
- type: Pricing
  url: https://grafana.com/pricing/
- type: SignUp
  url: https://grafana.com/auth/sign-up/create-user
- type: TermsOfService
  url: https://grafana.com/legal/terms/
- type: PrivacyPolicy
  url: https://grafana.com/legal/privacy-policy/
- type: Security
  url: https://grafana.com/security/
  name: Grafana Labs security advisories and vulnerability disclosure
- type: Compliance
  url: https://grafana.com/legal/security-compliance/
  name: 'Grafana Labs security compliance: ISO 27001, SOC 2 Type 2, PCI DSS, GDPR, CSA STAR, FedRAMP High'
- type: TrustCenter
  url: security/grafana-loki-trust-center.yml
- type: StatusPage
  url: https://status.grafana.com/
  name: Grafana Cloud Status
- type: Deprecation
  url: lifecycle/grafana-loki-lifecycle.yml
  name: Loki deprecated endpoints and upgrade guide
- type: Lifecycle
  url: lifecycle/grafana-loki-lifecycle.yml
- type: ChangeLog
  url: changelog/grafana-loki-changelog.yml
- type: Protobuf
  url: grpc/grafana-loki-push.proto
- type: Authentication
  url: authentication/grafana-loki-authentication.yml
- type: OAuthScopes
  url: scopes/grafana-loki-scopes.yml
- type: Conventions
  url: conventions/grafana-loki-conventions.yml
- type: Idempotency
  url: conventions/grafana-loki-conventions.yml
  name: Retry, idempotency and reversibility semantics
- type: ErrorCatalog
  url: errors/grafana-loki-problem-types.yml
- type: RateLimits
  url: rate-limits/grafana-loki-rate-limits.yml
- type: Plans
  url: plans/grafana-loki-plans-pricing.yml
- type: Packages
  url: packages/grafana-loki-packages.yml
- type: SDKs
  url: packages/grafana-loki-packages.yml
  name: First-party libraries and distributions (Go push contract module, Helm charts, images)
- type: CLI
  url: cli/grafana-loki-cli.yml
  name: LogCLI
- type: Sandbox
  url: sandbox/grafana-loki-sandbox.yml
- type: DataModel
  url: data-model/grafana-loki-data-model.yml
- type: Conformance
  url: conformance/grafana-loki-conformance.yml
- type: DomainSecurity
  url: security/grafana-loki-domain-security.yml
- type: VulnerabilityDisclosure
  url: security/grafana-loki-vulnerability-disclosure.yml
- type: WellKnown
  url: well-known/grafana-loki-well-known.yml
- type: LLMsTxt
  url: llms/grafana-loki-llms.txt
  name: grafana.com/llms.txt (Grafana Labs site-wide, saved verbatim)
- type: AgentSkill
  url: skills/_index.yml
  name: Grafana Loki agent skills
- type: AgentSkill
  url: skills/grafana-loki-query-logs.md
  name: Query logs from Grafana Loki
- type: AgentSkill
  url: skills/grafana-loki-push-logs.md
  name: Push logs into Grafana Loki
- type: AgentSkill
  url: skills/grafana-loki-delete-logs.md
  name: Delete logs from Grafana Loki and cancel within the window
- type: AgentSkill
  url: skills/grafana-loki-manage-alerting-rules.md
  name: Manage Loki alerting and recording rules
x-enrichment:
  date: '2026-08-27'
  status: enriched
  artifacts_added: 32
  pass: local-v1