실행 메타데이터에서 GitHub Actions 대기열 대기 핫스팟을 식별하고 시각화하여 개발 병합이 지연되기 전에 CI 병목 현상을 해결합니다.
설치 및 다운로드
1. ClawHub CLI
레지스트리에서 스킬을 바로 설치하는 가장 빠른 방법입니다.
npx clawhub@latest install github-actions-queue-latency-audit
2. 수동 설치
스킬 폴더를 다음 위치 중 하나로 복사하세요
~/.openclaw/skills/ <project>/skills/ 우선순위: 워크스페이스 > 로컬 > 번들
3. 프롬프트 설치
이 프롬프트를 OpenClaw에 복사하면 자동으로 설치됩니다.
Clawhub를 사용해서 github-actions-queue-latency-audit 설치를 도와줘. Clawhub가 설치되어 있지 않다면 먼저 설치해 줘 (npm i -g clawhub).
다운로드를 원하시나요?
ZIP 아카이브 형태의 원본 스킬 파일을 받으세요.
GitHub Actions 대기열 지연 시간 감사란 무엇인가요?
GitHub Actions 대기열 지연 시간 감사(Queue Latency Audit) 스킬은 CI/CD 오버헤드를 정량화해야 하는 DevOps 엔지니어와 개발자를 위해 설계된 강력한 진단 유틸리티입니다. 내보낸 워크플로 실행 데이터를 분석하여 작업이 대기열에서 대기하는 시간과 실제 실행 시간을 정확하게 계산합니다. 이러한 가시성은 Runner 부족, 잘못 예약된 작업 또는 인프라 확장 문제를 식별하는 데 중요합니다.
Openclaw Skills 생태계의 일부인 이 도구는 팀이 CI 속도 저하에 대한 막연한 추측에서 벗어나 데이터 기반의 성능 튜닝을 수행할 수 있도록 합니다. 대기열 대기 평균 및 피크에 대한 명확한 지표를 제공하여 Runner 전략을 최적화하고 풀 리퀘스트 피드백 대기 시간을 단축하여 개발자 경험을 개선할 수 있습니다.
GitHub Actions 대기열 지연 시간 감사 활용 사례
- 작업이 대기열에서 장시간 대기하게 만드는 Runner 용량 부족 감지.
- 대규모 모노레포 또는 복잡한 멀티 리포지토리 워크플로 패밀리의 성능 감사.
- Runner 업그레이드 또는 구성 변경이 전체 CI 처리량에 미치는 영향 검증.
- 대기열 지연 시간이 사전 정의된 서비스 수준 목표(SLO)를 초과할 때 실패하는 자동화된 CI 체크 구현.
GitHub Actions 대기열 지연 시간 감사 작동 원리
- gh CLI 도구를 사용하여 GitHub에서 실행 메타데이터를 수집하고 JSON 파일로 저장합니다.
- 스킬은 glob 패턴을 사용하여 지정된 디렉토리에서 이러한 JSON 아티팩트를 스캔합니다.
- 모든 작업 인스턴스에 대해 생성, 시작 및 완료 시간을 포함한 중요한 타임스탬프를 추출합니다.
- 수학적 처리를 통해 대기열 대기 시간(startedAt - createdAt)과 실행 시간(completedAt - startedAt)을 계산합니다.
- 데이터를 리포지토리, 워크플로 및 작업 이름별로 집계하고 그룹화하여 반복되는 핫스팟을 식별합니다.
- 도구는 경고 또는 위험 임계값을 초과하는 작업을 강조하는 순위 보고서를 생성합니다.
GitHub Actions 대기열 지연 시간 감사 설정 가이드
이 스킬을 사용하려면 bash와 python3가 설치되어 있어야 합니다. 먼저 워크플로 실행 데이터를 수집하세요.
gh run view <run-id> --json databaseId,workflowName,headBranch,headSha,url,repository,jobs > artifacts/github-actions/run-<run-id>.json
그런 다음 원하는 구성으로 감사 스크립트를 실행합니다.
RUN_GLOB='artifacts/github-actions/*.json' \
TOP_N=20 \
QUEUE_WARN_SECONDS=120 \
bash skills/github-actions-queue-latency-audit/scripts/queue-latency-audit.sh
GitHub Actions 대기열 지연 시간 감사 데이터 스키마 및 분류 체계
이 스킬은 GitHub Actions 실행 메타데이터를 처리하고 체계적인 분석 보고서를 생성합니다.
| 데이터 포인트 | 설명 |
|---|---|
| 대기열 대기 | startedAt - createdAt으로 계산 |
| 런타임 | completedAt - startedAt으로 계산 |
| 그룹화 | 리포지토리 + 워크플로 + 작업 이름별 집계 |
| 임계값 | 환경 변수를 통해 구성 가능 (경고/위험) |
JSON 형식으로 출력할 때 스킬은 루트 요약 객체, 그룹화된 핫스팟 목록 및 위험 경고를 트리거한 특정 작업 인스턴스 목록을 제공합니다.
GitHub Actions 대기열 지연 시간 감사 고급 기능
- 특정 팀이나 프로젝트를 격리하기 위해 리포지토리, 워크플로 및 작업에 대한 정규식 기반 필터링.
- FAIL_ON_CRITICAL 모드: 작업이 지연 시간 제한을 초과할 경우 0이 아닌 상태 코드로 종료.
- 사용자 지정 대시보드 또는 모니터링 스택에 쉽게 통합할 수 있는 기계 판독 가능 JSON 출력 모드.
- 장기적인 추세를 찾기 위해 수백 개의 파일을 글로빙할 수 있는 다중 실행 분석 기능.
- 절대적으로 최악인 이상값 또는 가장 높은 평균 대기 시간에 집중할 수 있는 사용자 지정 가능한 순위 로직.
SKILL.md
로드 중
관련 Openclaw 스킬
GitHub Actions PR 게이트 상태 감사
풀 리퀘스트 및 병합 대기열 게이트에 사용되는 신뢰할 수 없는 GitHub Actions 워크플로우를 점수화하고 표시하는 진단 도구입니다.
GitHub Actions 권한 범위 감사
최소 권한 액세스를 적용하기 위해 권한이 과도하게 부여된 GitHub Actions 워크플로 토큰을 탐지하고 감사하는 보안 중심 도구입니다.
GitHub Actions OIDC 강화 감사
OIDC 오설정 및 위험한 클라우드 인증 패턴을 식별하는 GitHub Actions용 보안 감사 도구입니다.
GitHub Actions 머지 큐 상태 감사
실패율, 큐 지연 시간 및 stale-success 리스크 점수 산출을 사용하여 GitHub 머지 큐 워크플로우를 감사하는 진단 도구입니다.
GitHub Actions 복구 지연 감사
GitHub Actions 워크플로가 장애로부터 얼마나 빨리 복구되는지 측정하고 지속적인 CI 병목 현상을 식별하는 진단 도구입니다.
GitHub Actions 재실행 효율성 감사
GitHub Actions 재실행의 효과를 측정하고 낭비되는 CI 리소스를 식별하기 위한 성능 감사 도구입니다.
GitHub Actions 재실행 낭비 감사
워크플로우 재실행 및 불안정성 데이터를 분석하여 낭비된 GitHub Actions 사용 시간을 정량화하는 기술 감사 도구입니다.
추천*
