Prow Job Analyze Resource

Parse Prow CI audit and pod logs to generate interactive HTML resource timelines.

112|305|Updated Oct 10, 2025
One-click install
npx skills add https://github.com/openshift-eng/ai-helpers --skill prow-job-analyze-resource
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Prow Job Analyze Resource
Source: https://github.com/openshift-eng/ai-helpers/tree/main/plugins/prow-job/skills/prow-job-analyze-resource
Command: npx skills add https://github.com/openshift-eng/ai-helpers --skill prow-job-analyze-resource

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Understanding the dynamic lifecycle of Kubernetes resources during CI test runs is challenging. This skill automates the extraction and visualization of resource-specific events from Prow CI job artifacts, providing an interactive timeline for debugging.

Core Features & Use Cases

  • Automated Log Parsing: Downloads and parses audit logs and pod logs from Google Cloud Storage.
  • Interactive HTML Timeline: Generates a visual, chronological timeline of resource events with filtering and search capabilities.
  • Glog Severity Detection: Automatically detects and highlights log levels (info, warn, error) from glog-formatted pod logs.
  • Flexible Resource Matching: Supports powerful regex patterns to search for single or multiple resources by name, kind, and namespace.
  • Use Case: When a Kubernetes resource behaves unexpectedly in a Prow CI job, provide the job URL and the resource name (e.g., pod/my-app). This skill will generate an interactive HTML report showing all related events, helping you trace its lifecycle and identify issues.

Quick Start

Example: Analyze a specific pod's lifecycle

User: "Analyze pod/etcd-0 in this Prow job: https://gcsweb-ci.apps.ci.l2s4.p1.openshiftapps.com/gcs/test-platform-results/pr-logs/pull/30393/pull-ci-openshift-origin-main-okd-scos-e2e-aws-ovn/1978913325970362368/"

Frequently Asked Questions about Prow Job Analyze Resource

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

FAQPage Schema
How do I debug Kubernetes resource failures in Prow CI jobs?

Debug Kubernetes resource failures by analyzing Prow CI job artifacts to trace resource lifecycles. This skill downloads audit and pod logs from Google Cloud Storage, parses timestamps and events, and generates an interactive HTML timeline showing what happened to your resource from creation to termination, helping you identify when and why it failed.

Can I visualize Kubernetes resource timelines from Prow job logs?

Yes. This skill creates interactive HTML timelines that visualize Kubernetes resource lifecycles during Prow CI runs. It parses audit logs and pod logs, extracts resource-specific events with timestamps and severity levels, and presents them in a searchable, filterable report with expandable details for each event.

How do I extract and parse audit logs from Prow CI artifacts?

This skill automates extraction by downloading structured audit logs (JSONL format) and unstructured pod logs from Google Cloud Storage using regex-based resource patterns. It parses both formats to extract timestamps, severity levels, and resource events, then consolidates them into a single interactive HTML report for analysis.

What log formats does Prow resource analysis support?

This skill supports structured audit logs in JSONL format and unstructured glog-formatted pod logs. It automatically detects glog severity levels (info, warn, error) and parses timestamps from both formats, then correlates events across formats to build a complete resource lifecycle timeline.

Can I search and filter Kubernetes resource events by name, kind, or namespace?

Yes. This skill supports flexible regex patterns to match single or multiple resources by name, kind, and namespace. The generated HTML report includes search and filtering capabilities, allowing you to narrow results and focus on specific resource types or namespaces within your Prow job.

What do I need to provide to analyze a resource in a Prow job?

Provide the Prow job URL and the resource identifier (e.g., pod/etcd-0, namespace/default). This skill accesses the job artifacts stored in Google Cloud Storage, downloads relevant audit and pod logs, applies your resource pattern, and generates an interactive timeline report without additional setup required.