Verifying and troubleshooting runner connectivity

After you install a runner, this article helps you confirm it is connected and checking in, read its poll logs, and work through the most common connectivity failures. It is for the technician who has just installed a runner.

We'll cover four main steps:

1. Confirming the runner is online
2. Reading the poll logs
3. Interpreting common failures
4. The gpt-5.4 quota two-pass install

Step 1: Confirming the Runner Is Online

Why are we doing this? This is the check that tells you the install actually worked and the runner is talking to the control plane.

After deployment, the runner should display as online on the Runners page within about two polling intervals (roughly two minutes at the default 60-second cadence). The runner's last-seen time and version update on its first successful poll. If the runner does not appear within about five minutes, check its poll logs.

Step 2: Reading the Poll Logs

Why are we doing this? The poll logs show whether the runner is reaching the control plane and what response it gets, which is where you look when it is not online.

Each runner Function App writes poll activity to Application Insights. Script runners log lines prefixed with PollTimer: while agent runners use AgentPoll: prefixes. On each timer firing, the runner signs a check-in and posts it to the control plane to lease work and report health status. Successful ticks with no work show no-content results; ticks that lease work display the dispatched item. Review these lines to determine whether the runner reaches the control plane and what response it receives.

Step 3: Interpreting Common Failures

Why are we doing this? Most connectivity problems come down to a few specific responses, and knowing them points you straight at the fix.

• 401: The control plane rejected the runner's signature because the secret the runner is signing with does not match the hash stored at registration. Re-check and rotate the runner secret by re-running the installer with the correct value.
• 410: The runner has been revoked. It records a retirement marker, stops polling, and short-circuits on later attempts. Register a new runner and reinstall to restore functionality.
• Egress timeouts: The runner cannot reach the control plane or package store. In restricted environments, confirm the outbound allow-list and review Runner network and egress requirements.

Step 4: The gpt-5.4 Quota Two-Pass Install

Why are we doing this? New subscriptions often lack the AI model quota, and knowing how the installer handles it explains an alert you may see and how to clear it.

New subscriptions lack gpt-5.4 quota, which is checked during deployment preflight. To avoid aborting, the installer deploys in two passes: pass one deploys infrastructure and the Foundry account (no quota needed), and pass two deploys the gpt-5.4 model on a best-effort basis. If quota is missing, pass two prints an action-required alert and exits cleanly, so the runner still deploys and polls normally.

When you see the alert, AI activities will fail until quota is granted. Request gpt-5.4 GlobalStandard quota for the subscription and the Foundry account's region in the Azure portal's Quotas area, then re-run the install command. Pass one becomes a no-op and pass two adds the model.

Note: Request higher quota when enabling the agent runner, since its bundled Foundry draws from the same quota.

Once the runner shows online and any quota alert is cleared, the initial setup is complete and the runner is ready for its first workflow. When you are ready to build automations, see Creating your first workflow in the Designer.

If you are still having trouble, we're here to help! Submit a ticket here for assistance, and don't forget to check our status page to ensure there are no outages in your area.