infrahub-collecting-diagnostics

Collects redacted Infrahub logs, config, and state into a diagnostic bundle for support hand-off.

9|2|Updated Aug 27, 2025
One-click install
npx skills add https://github.com/opsmill/infrahub-solution-ai-dc --skill infrahub-collecting-diagnostics-opsmill
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: infrahub-collecting-diagnostics
Source: https://github.com/opsmill/infrahub-solution-ai-dc/tree/main/.agents/skills/infrahub-collecting-diagnostics
Command: npx skills add https://github.com/opsmill/infrahub-solution-ai-dc --skill infrahub-collecting-diagnostics-opsmill

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? When an Infrahub deployment breaks, support engineers need a consistent set of artifacts — logs, config, version info, branch state — to triage the issue. This Skill automates producing that artifact set as a single redacted diagnostic bundle, so users don't have to manually gather and sanitize dozens of files. ## Core Features & Use Cases - Guided nine-step collection workflow: Captures the problem description, connection info (URL and API token with a privacy guarantee), deployment topology (Docker Compose, Kubernetes, or local dev), and classifies the issue into one of ten categories such as git-sync, upgrade, or performance. - Read-only, infrahubctl-only probing: All instance state queries go through infrahubctl; no mutating commands, no direct database or API probes, and multi-replica task-worker logs are always collected in full. - Two-tier redaction with user review: Tier 1 automatically masks known secrets (tokens, passwords, JWTs), then Tier 2 presents IPs, hostnames, and customer strings for the user to keep or redact before the bundle is finalized. - Deterministic flag checks: Twelve pattern-based checks (e.g., CommitNotFoundError, OOM kills, default security keys) scan collected files and emit hints in flags.yml for the receiving expert. - Use Case: After a Helm upgrade leaves a branch stuck in NEED_UPGRADE_REBASE, run this Skill to gather pod logs, Helm history, and branch state into a tarball ready to hand to OpsMill support. ## Quick Start Ask the assistant to collect an Infrahub diagnostic bundle for the problem you are experiencing, then provide your Infrahub URL and optionally an API token when prompted.

Frequently Asked Questions about infrahub-collecting-diagnostics

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I collect Infrahub logs and diagnostics for support?▼

Run this Skill and describe your problem; it walks you through nine steps to build an infrahub-diagnostics directory containing logs, config, state, and a manifest. It auto-redacts secrets, lets you review what gets masked, and prints a tar command for packaging the bundle.

Is my Infrahub API token safe when collecting diagnostics?▼

The token is used only locally by infrahubctl to query state and is never written to the bundle. It is added to the redactor mask list immediately, and you can decline to share it entirely — the Skill then produces a partial bundle with topology, logs, and file reads only.

Does Infrahub diagnostics collection work on Kubernetes and Docker Compose?▼

Yes, the Skill detects the topology in order: Docker Compose, Kubernetes, then local dev via invoke demo.status, with a manual fallback. Each topology has its own baseline and category-specific command sets using docker compose, kubectl, and helm.

Can the diagnostics Skill restart containers or fix my Infrahub issue?▼

No, the Skill is strictly read-only and never mutates state — no restarts, schema loads, or branch operations. It produces hints via deterministic flag checks, but root-cause diagnosis and remediation are left to the expert receiving the bundle.

Why does the Skill collect logs from every task-worker replica?▼

Multi-worker race conditions, such as CommitNotFoundError appearing on only one replica, hide root cause when a single replica is sampled. Collecting every replica's logs ensures the counter-evidence and the failing worker's traceback are both preserved.

When should I use infrahub-reporting-issues instead of collecting diagnostics?▼

Use infrahub-reporting-issues when you want to file a public GitHub issue rather than prepare a private support hand-off. The diagnostics Skill cross-links to it at the end of its workflow instead of duplicating that routing logic.