# Pipeline Failure Report Template

**Report ID:** {{REPORT_ID}}  
**Generated:** {{GENERATED_DATE}}  
**Pipeline:** {{PIPELINE_URL}}  
**Branch:** {{BRANCH_NAME}}  
**Commit:** {{COMMIT_SHA}}

## Executive Summary

**Failure Type:** {{FAILURE_TYPE}}  
**Impact Level:** {{IMPACT_LEVEL}}  
**Resolution Status:** {{RESOLUTION_STATUS}}  
**Estimated Fix Time:** {{ESTIMATED_FIX_TIME}}

## Failure Details

### Pipeline Overview

- **Status:** {{PIPELINE_STATUS}}
- **Duration:** {{PIPELINE_DURATION}}
- **Started:** {{START_TIME}}
- **Failed:** {{FAILURE_TIME}}
- **Triggered By:** {{TRIGGERED_BY}}

### Failed Jobs

{{#FAILED_JOBS}}

#### {{JOB_NAME}}

- **Stage:** {{STAGE_NAME}}
- **Status:** {{JOB_STATUS}}
- **Duration:** {{JOB_DURATION}}
- **Exit Code:** {{EXIT_CODE}}
- **Error Summary:** {{ERROR_SUMMARY}}

**Error Details:**

```
{{ERROR_DETAILS}}
```

**Log Excerpt:**

```
{{LOG_EXCERPT}}
```

{{/FAILED_JOBS}}

## Root Cause Analysis

### Primary Cause

{{PRIMARY_CAUSE}}

### Contributing Factors

{{#CONTRIBUTING_FACTORS}}

- {{FACTOR}}
  {{/CONTRIBUTING_FACTORS}}

### Environmental Context

- **Runner:** {{RUNNER_INFO}}
- **Environment:** {{ENVIRONMENT_NAME}}
- **Dependencies:** {{DEPENDENCY_VERSIONS}}
- **Resource Usage:** {{RESOURCE_USAGE}}

## Impact Assessment

### Affected Systems

{{#AFFECTED_SYSTEMS}}

- **System:** {{SYSTEM_NAME}}
- **Impact:** {{IMPACT_DESCRIPTION}}
- **Severity:** {{SEVERITY_LEVEL}}
  {{/AFFECTED_SYSTEMS}}

### Team Impact

- **Blocked Developers:** {{BLOCKED_DEVELOPERS}}
- **Affected Features:** {{AFFECTED_FEATURES}}
- **Business Impact:** {{BUSINESS_IMPACT}}

## Resolution Plan

### Immediate Actions

{{#IMMEDIATE_ACTIONS}}

1. {{ACTION_DESCRIPTION}}
   - **Owner:** {{ACTION_OWNER}}
   - **ETA:** {{ACTION_ETA}}
   - **Status:** {{ACTION_STATUS}}
     {{/IMMEDIATE_ACTIONS}}

### Long-term Improvements

{{#LONG_TERM_IMPROVEMENTS}}

1. {{IMPROVEMENT_DESCRIPTION}}
   - **Priority:** {{IMPROVEMENT_PRIORITY}}
   - **Effort:** {{IMPROVEMENT_EFFORT}}
   - **Timeline:** {{IMPROVEMENT_TIMELINE}}
     {{/LONG_TERM_IMPROVEMENTS}}

## Prevention Measures

### Configuration Changes

{{#CONFIG_CHANGES}}

- **File:** {{CONFIG_FILE}}
- **Change:** {{CHANGE_DESCRIPTION}}
- **Rationale:** {{CHANGE_RATIONALE}}
  {{/CONFIG_CHANGES}}

### Monitoring Enhancements

{{#MONITORING_ENHANCEMENTS}}

- **Metric:** {{METRIC_NAME}}
- **Threshold:** {{THRESHOLD_VALUE}}
- **Alert:** {{ALERT_CONFIGURATION}}
  {{/MONITORING_ENHANCEMENTS}}

### Process Improvements

{{#PROCESS_IMPROVEMENTS}}

- {{PROCESS_CHANGE}}
  {{/PROCESS_IMPROVEMENTS}}

## Integration Status

### JIRA Integration

{{#JIRA_INTEGRATION}}

- **Issue:** [{{JIRA_KEY}}]({{JIRA_URL}})
- **Status:** {{JIRA_STATUS}}
- **Assignee:** {{JIRA_ASSIGNEE}}
- **Priority:** {{JIRA_PRIORITY}}
  {{/JIRA_INTEGRATION}}

### Parallel Development Impact

{{#PARALLEL_DEV_IMPACT}}

- **Affected Branches:** {{AFFECTED_BRANCHES}}
- **Coordination Status:** {{COORDINATION_STATUS}}
- **Merge Readiness:** {{MERGE_READINESS}}
  {{/PARALLEL_DEV_IMPACT}}

## Historical Context

### Similar Failures

{{#SIMILAR_FAILURES}}

- **Date:** {{FAILURE_DATE}}
- **Pipeline:** [{{PIPELINE_ID}}]({{PIPELINE_URL}})
- **Resolution:** {{RESOLUTION_SUMMARY}}
- **Pattern:** {{FAILURE_PATTERN}}
  {{/SIMILAR_FAILURES}}

### Trend Analysis

- **Failure Frequency:** {{FAILURE_FREQUENCY}}
- **MTTR Trend:** {{MTTR_TREND}}
- **Success Rate Impact:** {{SUCCESS_RATE_IMPACT}}

## Lessons Learned

### What Worked Well

{{#WHAT_WORKED}}

- {{POSITIVE_OUTCOME}}
  {{/WHAT_WORKED}}

### Areas for Improvement

{{#IMPROVEMENT_AREAS}}

- {{IMPROVEMENT_AREA}}
  {{/IMPROVEMENT_AREAS}}

### Knowledge Sharing

- **Documentation Updated:** {{DOCS_UPDATED}}
- **Team Training:** {{TRAINING_NEEDED}}
- **Runbook Changes:** {{RUNBOOK_UPDATES}}

## Validation and Testing

### Resolution Validation

{{#VALIDATION_STEPS}}

1. {{VALIDATION_STEP}}
   - **Result:** {{VALIDATION_RESULT}}
   - **Evidence:** {{VALIDATION_EVIDENCE}}
     {{/VALIDATION_STEPS}}

### Regression Testing

- **Test Suite:** {{TEST_SUITE_NAME}}
- **Coverage:** {{TEST_COVERAGE}}
- **Results:** {{TEST_RESULTS}}

## Sign-off

- **Technical Lead:** {{TECH_LEAD_APPROVAL}}
- **Product Owner:** {{PO_APPROVAL}}
- **DevOps:** {{DEVOPS_APPROVAL}}

## Appendix

### Related Documentation

{{#RELATED_DOCS}}

- [{{DOC_TITLE}}]({{DOC_URL}})
  {{/RELATED_DOCS}}

### Useful Commands

{{#USEFUL_COMMANDS}}

```bash
# {{COMMAND_DESCRIPTION}}
{{COMMAND}}
```

{{/USEFUL_COMMANDS}}

### Contact Information

- **On-call Engineer:** {{ONCALL_ENGINEER}}
- **Team Lead:** {{TEAM_LEAD}}
- **Escalation:** {{ESCALATION_CONTACT}}

---

_This report was generated using the GitLab CI/CD Automation expansion pack._  
_For questions or updates, contact the DevOps team._