Skip to content

Commit 20cbb5e

Browse files
committed
added info on job suspension 2
1 parent 2043a89 commit 20cbb5e

File tree

1 file changed

+39
-1
lines changed

1 file changed

+39
-1
lines changed

articles/automation/troubleshoot/hybrid-runbook-worker.md

Lines changed: 39 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: Troubleshoot agent-based Hybrid Runbook Worker issues in Azure Automation
33
description: This article tells how to troubleshoot and resolve issues that arise with Azure Automation agent-based Hybrid Runbook Workers.
44
services: automation
5-
ms.date: 03/15/2023
5+
ms.date: 04/26/2023
66
ms.topic: troubleshooting
77
---
88

@@ -55,6 +55,44 @@ The Hybrid Runbook Worker jobs failed to refresh when communicating through a Lo
5555

5656
Verify the Log Analytics Gateway server is online and is accessible from the machine hosting the Hybrid Runbook Worker role. For additional troubleshooting information, see [Troubleshoot Log Analytics Gateway](../../azure-monitor/agents/gateway.md#troubleshooting).
5757

58+
59+
### Scenario: Job failed to start as the Hybrid Worker was not available when the scheduled job started
60+
61+
#### Issue
62+
Job fails to start on a Hybrid Worker and you see the following error:
63+
*Failed to start, as hybrid worker was not available when scheduled job started, the hybrid worker was last active at mm/dd/yyyy*
64+
65+
#### Cause
66+
This error can occur due to the following reasons:
67+
- The machines doesn't exist anymore.
68+
- The machine is turned off and is unreachable.
69+
- The machine has a network connectivity issue.
70+
- The Hybrid Runbook Worker extension has been uninstalled from the machine.
71+
72+
#### Resolution
73+
Ensure that the machine exists, and Hybrid Runbook Worker extension is installed on it. The Hybrid Worker should be healthy and should give a heartbeat. Troubleshoot any network issues by checking the Microsoft-SMA event logs on the Workers in the Hybrid Runbook Worker Group that tried to run this job. You can also monitor [HybridWorkerPing](../../azure-monitor/essentials/metrics-supported.md#microsoftautomationautomationaccounts) metric that provides the number of pings from a Hybrid Worker and can help to check ping-related issues.
74+
75+
### Scenario: Job was suspended as it exceeded the job limit for a Hybrid Worker
76+
77+
#### Issue
78+
Job gets suspended with the following error message:
79+
*Job was suspended as it exceeded the job limit for a Hybrid Worker. Add more Hybrid Workers to the Hybrid Worker group to overcome this issue.*
80+
81+
#### Cause
82+
Jobs might get suspended due to any of the following reasons:
83+
- Each active Hybrid Worker in the group will poll for jobs every 30 seconds to see if any jobs are available. The Worker picks jobs on a first-come, first-serve basis. Depending on when a job was pushed, whichever Hybrid Worker within the Hybrid Worker Group pings the Automation service first picks up the job. A single hybrid worker can generally pick up four jobs per ping (that is, every 30 seconds). If your rate of pushing jobs is higher than four per 30 seconds and no other Worker picks up the job, the job might get suspended.
84+
- Hybrid Worker might not be polling as expected every 30 seconds. This could happen if the Worker is not healthy or there are network issues.
85+
86+
#### Resolution
87+
- If the job limit for a Hybrid Worker exceeds four jobs per 30 seconds, you can add more Hybrid Workers to the Hybrid Worker group for high availability and load balancing. You can also schedule jobs so they do not exceed the limit of four jobs per 30 seconds. The processing time of the jobs queue depends on the Hybrid worker hardware profile and load. Ensure that the Hybrid Worker is healthy and gives a heartbeat.
88+
- Troubleshoot any network issues by checking the Microsoft-SMA event logs on the Workers in the Hybrid Runbook Worker Group that tried to run this job.
89+
- You can also monitor the [HybridWorkerPing](../../azure-monitor/essentials/metrics-supported.md#microsoftautomationautomationaccounts) metric that provides the number of pings from a Hybrid Worker and can help to check ping-related issues.
90+
91+
92+
93+
94+
95+
5896
### <a name="cannot-connect-signalr"></a>Scenario: Event 15011 in the Hybrid Runbook Worker
5997

6098
#### Issue

0 commit comments

Comments
 (0)