worker-ready-tracing

Trace Windows Taskcluster worker readiness latency from provisioning to workerReady using tc-logview, Papertrail, Splunk, Yardstick, and in-VM logs.

3|Updated Jan 8, 2026
One-click install
npx skills add https://github.com/jwmossmoz/agent-skills --skill worker-ready-tracing
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: worker-ready-tracing
Source: https://github.com/jwmossmoz/agent-skills/tree/main/skills/worker-ready-tracing
Command: npx skills add https://github.com/jwmossmoz/agent-skills --skill worker-ready-tracing

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps engineers measure and diagnose the latency from Taskcluster worker-manager provisioning of a Windows Azure VM to the moment a generic-worker is ready to accept tasks. It surfaces timestamps and markers across host and guest boundaries using tc-logview, paperctl, Splunk Web, Yardstick, and in-VM logs to pinpoint slow steps.

Core Features & Use Cases

  • End-to-end readiness tracing: from VM provisioning to workerReady, including Azure VM writes and in-VM startup phases.
  • Multi-source correlation: correlates tc-logview events, Papertrail WORKER_METRICS, Splunk Azure activity log, and Yardstick pool metrics.
  • In-depth analysis outputs: prints timelines, durations, and boot/recovery cycles to diagnose latency causes on Windows workers.
  • Use Case: Sudden worker provisioning delays can be diagnosed by comparing azure-vm-write and in-VM Puppet/Start-WorkerRunner timings.

Quick Start

Run the helper with a worker-id (VM name) and a time window to generate a lifecycle trace from provisioning to workerReady.

Frequently Asked Questions about worker-ready-tracing

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

FAQPage Schema
How do I trace Windows VM startup latency in Taskcluster workers?

Trace Windows VM startup latency by collecting and aligning markers from worker-manager provisioning through in-VM startup to the first eligible task claim. The Skill uses tc-logview, Papertrail, Splunk, and Yardstick to pinpoint slow steps across host and guest boundaries.

Why does my Azure Windows VM take so long to become ready for Taskcluster tasks?

Azure Windows VM readiness delays can be diagnosed by comparing azure-vm-write timings against in-VM Puppet and Start-WorkerRunner phases. The Skill surfaces timestamps across provisioning and startup to identify which lifecycle step is slow.

How do I correlate Taskcluster worker-manager logs with in-VM Windows startup logs?

Correlate worker-manager logs with in-VM startup logs by collecting WORKER_METRICS from Papertrail, Azure activity logs from Splunk, and pool metrics from Yardstick. The Skill aligns these multi-source markers to produce a unified lifecycle timeline.

Can I use this to measure time from Azure VM provisioning to workerReady?

Yes, you can measure end-to-end readiness latency from Azure VM provisioning to workerReady. The Skill computes durations between lifecycle markers and prints structured timelines showing each phase from VM creation to first task claim.

What do I need to run a worker readiness trace on a Windows Azure VM?

You need a worker-id, which is the Azure VM name, and a time window to generate the lifecycle trace. The Skill then queries tc-logview, Papertrail, Splunk, and in-VM logs to collect and align the relevant readiness markers.

Does this Skill work with generic-worker startup phases on Windows?

Yes, it traces generic-worker startup phases on Windows by parsing in-VM logs and worker-manager events. The Skill identifies boot and recovery cycles to diagnose latency causes specific to Windows Taskcluster workers.