Skip to content

Latest commit

 

History

History
58 lines (41 loc) · 4.03 KB

automation-troubleshooting-hybrid-runbook-worker.md

File metadata and controls

58 lines (41 loc) · 4.03 KB
title description services documentationcenter author manager editor ms.assetid ms.service ms.devlang ms.topic ms.tgt_pltfrm ms.workload ms.date ms.author
Troubleshoot Azure Automation Hybrid Runbook Worker | Microsoft Docs
Describe the symptoms, causes, and resolution for the most common Hybrid Runbook Worker issues in Azure Automation.
automation
eslesar
jwhit
tysonn
02c6606e-8924-4328-a196-45630c2255e9
automation
na
article
na
infrastructure-services
07/25/2017
magoedte

Troubleshooting tips for Hybrid Runbook Worker

This article provides help troubleshooting errors you might experience with Automation Hybrid Runbook Workers and suggests possible solutions to resolve them.

A runbook job terminates with a status of Suspended

Your runbook is suspended shortly after attempting to execute it three times. There are conditions which may interrupt the runbook from completing successfully and the related error message does not include any additional information indicating why. This article provides troubleshooting steps for issues related to the Hybrid Runbook Worker runbook execution failures.

If your Azure issue is not addressed in this article, visit the Azure forums on MSDN and the Stack Overflow. You can post your issue on these forums or to @AzureSupport on Twitter. Also, you can file an Azure support request by selecting Get support on the Azure support site.

Symptom

Runbook execution fails and the error returned is, "The job action 'Activate' cannot be run, because the process stopped unexpectedly. The job action was attempted 3 times."

There are several possible causes for the error:

  1. The hybrid worker is behind a proxy or firewall
  2. The computer the hybrid worker is running on has less than the minimum hardware requirements
  3. The runbooks cannot authenticate with local resources

Cause 1: Hybrid Runbook Worker is behind proxy or firewall

The computer the Hybrid Runbook Worker is running on is behind a firewall or proxy server and outbound network access may not be permitted or configured correctly.

Solution

Verify the computer has outbound access to *.azure-automation.net on port 443.

Cause 2: Computer has less than minimum hardware requirements

Computers running the Hybrid Runbook Worker should meet the minimum hardware requirements before designating it to host this feature. Otherwise, depending on the resource utilization of other background processes and contention caused by runbooks during execution, the computer will become over utilized and cause runbook job delays or timeouts.

Solution

First confirm the computer designated to run the Hybrid Runbook Worker feature meets the minimum hardware requirements. If it does, monitor CPU and memory utilization to determine any correlation between the performance of Hybrid Runbook Worker processes and Windows. If there is memory or CPU pressure, this may indicate the need to upgrade or add additional processors, or increase memory to address the resource bottleneck and resolve the error. Alternatively, select a different compute resource that can support the minimum requirements and scale when workload demands indicate an increase is necessary.

Cause 3: Runbooks cannot authenticate with local resources

Solution

Check the Microsoft-SMA event log for a corresponding event with description Win32 Process Exited with code [4294967295]. The cause of this error is you haven't configured authentication in your runbooks or specified the Run As credentials for the Hybrid worker group. Please review Runbook permissions to confirm you have correctly configured authentication for your runbooks.

Next steps

For help troubleshooting other issues in Automation, see Troubleshooting common Azure Automation issues