k8s-loki-troubleshooting SKILL.md skillA
k8s-loki-troubleshooting from k8s-servant/k8s-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add k8s-servant/k8s-skills/k8s-loki-troubleshooting@git:20261025.3daa848Pins git:20261025.3daa848 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- k8s-servant/k8s-skills
- Path
skills/k8s-loki-troubleshooting/SKILL.md- Versions recorded
- 1
- Latest version
- git:20261025.3daa848, committed Oct 25, 2026
- Size
- 10,577 bytes
- Repository stars
- 35
- License
- Apache-2.0
Use when Grafana Loki on Kubernetes rejects, drops or cannot query logs: clients getting 400, 401 or 429 from /loki/api/v1/push, "write operation failed", "has timestamp too old", "entry too far behind", "Per stream rate limit exceeded", "ingestion rate limit exceeded", "maximum active stream limit exceeded", "no org id" (missing X-Scope-OrgID tenant), Loki crashing at start with "validating config" or "invalid schema config", "failed to flush chunks", ring or memberlist errors…
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
# Loki troubleshooting Find out why Loki does not accept, keep or return logs, and propose a fix. **Read first, ask before changing.** Run the investigation commands freely. Run a command under an "Ask first" line only after the user approves that exact command; if your credentials do not allow it, give it to the user to run. Never run a "Proposed fix"; hand it to the user. Clients (Promtail, Grafana Alloy, Fluent Bit, the OpenTelemetry Collector) push log lines to `/loki/api/v1/push`. The **distributor** validates each line (labels, size, age) and applies the tenant's ingestion rate; the **ingester** applies per-stream limits and writes chunks to storage; queriers answer LogQL queries. In monolithic mode one pod (`-target=all`) runs every part; in microservices mode each part is its own workload. Loki answers a refused push with **400** (invalid, not retried), **429** (rate limit, retried) or **401** (no tenant), and logs refused pushes as `msg="write operation failed" details="<reason>"`, except 401s, which it does not log. The commands use placeholders: `my-namespace`, `my-loki` (the Loki workload, its Service …
Read the whole file at its exact version.
How to install
mdr add k8s-servant/k8s-skills/k8s-loki-troubleshooting@sha256:26bba186377c11b1The line at the top of this page pins the label git:20261025.3daa848, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
[](https://markdownregistry.com/a/art_aetsivwgqjfioggr)
0 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 1 version of this file, committed on Oct 25, 2026.
Audit of the latest version
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (10577 bytes)
- pass: No zero-width or bidi control characters
- pass: No instruction hidden inside an HTML comment
- pass: No link to an exfiltration or paste host
- pass: No credential-shaped string
- pass: No instruction to send local credentials anywhere
- pass: No text hidden with inline styles
- pass: No prompt-injection phrasing
- pass: No curl or wget piped into a shell
- pass: No recursive delete of root, home or parent
- pass: No instruction to read or print local credentials
- pass: No base64 blob over 200 characters
- pass: No link to a raw IP address
- pass: No script tag
Source
k8s-servant/k8s-skills · 35 stars · license Apache-2.0 · pushed 2026-10-31 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_aetsivwgqjfioggr GET https://markdownregistry.com/api/v1/resolve?ref=k8s-servant/k8s-skills/k8s-loki-troubleshooting GET https://markdownregistry.com/api/v1/blob/26bba186377c11b13fedd8996c92c47506b63c07697961fc65d4f4c95fd23f32
Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.