firehydrant-integration

Query FireHydrant incidents, timelines, services, and compute MTTR analytics via API scripts.

656|82|Updated Jan 20, 2026
One-click install
npx skills add https://github.com/incidentfox/incidentfox --skill firehydrant-integration
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: firehydrant-integration
Source: https://github.com/incidentfox/incidentfox/tree/main/sre-agent/.claude/skills/incident-firehydrant
Command: npx skills add https://github.com/incidentfox/incidentfox --skill firehydrant-integration

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires httpx, and includes scripts (resource) components.

What problem does it solve?

On-call engineers and SREs need quick access to FireHydrant incident data for investigations, retrospectives, and reliability reporting, but manually navigating the FireHydrant UI or writing ad-hoc API calls is slow and repetitive.

Core Features & Use Cases

  • Incident Listing & Filtering: List incidents by status, severity, environment, or date range with pagination handled automatically.
  • Incident Detail & Timeline Retrieval: Fetch full incident details including milestones, role assignments, impacted services, and chronological event timelines.
  • Reliability Analytics: Calculate MTTR (average, median, P95) and analyze alert patterns to detect noisy or flapping incidents and off-hours fire rates.
  • Service Catalog Access: List services and environments with ownership, tier, and active incident counts for impact analysis.
  • Use Case: During a post-incident review, ask for the MTTR of SEV1 incidents over the last 90 days and get a breakdown by severity and service without writing any API code.

Quick Start

Ask the agent to list all open FireHydrant incidents and calculate the MTTR for the last 30 days.

Frequently Asked Questions about firehydrant-integration

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

FAQPage Schema
How do I list FireHydrant incidents from the command line?

Run the list_incidents.py script with optional filters like --status, --severity, or --environment-id. It paginates through the FireHydrant API and prints incident names, statuses, severities, and affected services, with a --json flag for structured output.

How to calculate MTTR for FireHydrant incidents?

Use calculate_mttr.py with optional --severity, --service-id, and --days filters. It computes average, median, and P95 resolution times in minutes by comparing incident start times to resolved milestone timestamps.

Does the FireHydrant integration require an API key?

Credentials are injected automatically by a proxy layer, so you do not need to set FIREHYDRANT_API_KEY manually. The client also supports SANDBOX_JWT or tenant and team ID headers as fallback authentication methods.

Can I detect noisy or flapping alerts in FireHydrant?

Yes, get_alert_analytics.py groups incidents by name over a date range and classifies them as noisy (more than 10 fires) or flapping (frequent with fast auto-resolution). It also reports off-hours fire rates and per-service breakdowns.

Why does a FireHydrant script fail with an error?

Failures typically come from API errors raised by httpx when the request returns a non-success status, or from missing authentication headers. Check that the proxy environment variables are configured and that the incident ID or date range is valid.