Run a Diagnostic Playbook

Run any of the 7 built-in diagnostic playbooks against a ticket's linked device, straight from the ticket detail page.

Overview

Diagnostic playbooks are pre-built scripts that collect live data from a device through the Plenix Agent β€” disk usage, running services, recent errors, pending updates, network connectivity, printer queues, and top resource consumers. They're read-only: nothing on the device is changed, only inspected.

Before you begin

  • The device must have the Plenix Agent installed and online β€” diagnostics cannot run against agentless or offline devices
  • The ticket must have a device linked to it

Running a playbook

  1. Open the ticket and look at the Linked Device panel in the right-hand sidebar β€” it shows the device name and a green/grey dot for online/offline status.

  2. Under Run Diagnostics, click any of the 7 playbook buttons:

    PlaybookWhat it collects
    Disk UsageDrive space summary and the 10 largest folders on C:\
    Service StatusAutomatic-start services that have stopped, plus app crashes in the last 24h
    Event Log ErrorsSystem and Application error events from the last 24h
    Pending UpdatesPending reboot flags and count of pending Windows updates
    Network ConnectivityDefault gateway ping, DNS resolution, and public latency
    Printer QueueStatus and queued job count for every printer on the device
    Resource ConsumersTop 10 processes by CPU and by memory
  3. The button shows a spinner while the playbook runs. Within a few seconds you'll see a result message below the buttons.

Reading the result

  • "Completed β€” view run in Autonomy" β€” the playbook ran immediately and succeeded (this is the default for all 7 built-ins, since they're risk-tier read)
  • "Queued for approval β€” check Autonomy Approvals" β€” an admin has changed this playbook's policy mode to Suggest/Approve; see Approve or Reject Pending Actions
  • "Failed to start β€” check Autonomy Approvals" β€” the request was rejected (e.g. a rate cap was hit) or the agent didn't respond

Viewing full output

Every playbook run is recorded as an Action Run with a full transcript of each step and its output. If the run needed approval, open Autonomy β†’ Approvals and click View intended action to see it (also visible there after approval/rejection). Diagnostic output that ran via AI Triage also appears directly in the ticket's [AI Triage] internal note.

Where to go next

Was this article helpful?