Automation でエージェントベースの Hybrid Runbook Worker の問題をトラブルシューティングする

[アーティクル]
09/17/2023

重要

Azure Automation エージェントベースのユーザー Hybrid Runbook Worker (Windows と Linux) は 2024 年 8 月 31 日に廃止され、その日以降はサポートされません。 2024 年 8 月 31 日より前に、既存のエージェントベースのユーザー Hybrid Runbook Worker の、拡張機能ベースの Worker への移行を、完了する必要があります。さらに、2023 年 11 月 1 日からは、新しいエージェントベースのハイブリッド worker を作成できなくなります。詳細情報

この記事では、Azure Automation エージェントベースの Hybrid Runbook Worker に関する問題のトラブルシューティングと解決に関する情報を提供します。拡張機能ベースのワーカーのトラブルシューティングについては、Automation での拡張機能ベースの Hybrid Runbook Worker の問題のトラブルシューティングに関するページを参照してください。一般情報については、「Hybrid Runbook Worker overview (Hybrid Runbook Worker の概要)」をご覧ください。

全般

Hybrid Runbook Worker はエージェントに依存して Azure Automation アカウントと通信し、ワーカーの登録、Runbook ジョブの受信、および状態の報告を行います。 Windows の場合、このエージェントは Windows 用 Log Analytics エージェントです。 Linux の場合は、Linux 用 Log Analytics エージェントです。

Hybrid Worker の使用中に Az モジュールを更新できない

問題

Hybrid Runbook Worker ジョブは、Az モジュールをインポートできなかったため失敗しました。

解決方法

回避策として、次の手順を実行できます:

フォルダー : C:\Program Files\Microsoft Monitoring Agent\Agent\AzureAutomation\7.3.1722.0\HybridAgent に移動します
Orchestrator.Sandbox.exe.config という名前のファイルを編集します
<assemblyBinding> タグ内に次の行を追加します:

<dependentAssembly>
  <assemblyIdentity name="Newtonsoft.Json" publicKeyToken="30ad4fe6b2a6aeed" culture="neutral" />
  <bindingRedirect oldVersion="0.0.0.0-13.0.0.0" newVersion="13.0.0.0" />
</dependentAssembly>

Note

この回避策では、ソリューションの適用を有効にするかまたはパッチを適用して MMA/サーバーを再起動すると、ファイルが元のファイルに置き換えられます。どちらのシナリオでも、内容を置き換えることをお勧めします。

シナリオ: Runbook の実行が失敗する

問題

Runbook の実行が失敗し、次のエラーメッセージを受け取ります。

The job action 'Activate' cannot be run, because the process stopped unexpectedly. The job action was attempted three times.

Runbook は 3 回実行を試みると、短時間中断されます。 Runbook の完了を妨げる可能性がある状況が存在します。関連するエラーメッセージに追加情報が含まれていない場合があります。

原因

以下の原因が考えられます。

Runbook がローカルリソースで認証できない。
Hybrid Worker がプロキシまたはファイアウォールの内側にある。
Hybrid Runbook Worker を実行するように構成されているコンピューターが、ハードウェアの最小要件を満たしていない。

解決方法

コンピューターがポート 443 で .azure-automation.net に発信アクセスできることを確認します。

Hybrid Runbook Worker を実行するコンピューターは、この機能をホストするようにワーカーを構成する前に、ハードウェアの最小要件を満たしている必要があります。 Runbook とそれらが使用するバックグラウンドプロセスによってシステムが過剰に使用され、それが原因で Runbook ジョブの遅延やタイムアウトが発生する可能性があります。

Hybrid Runbook Worker の機能を実行するコンピューターが最小ハードウェア要件を満たしていることを確認します。満たしている場合は、CPU とメモリの使用を監視して、Hybrid Runbook Worker プロセスのパフォーマンスと Windows の間の相関関係を調べます。メモリまたは CPU の負荷は、リソースのアップグレードが必要であることを示している可能性があります。また、最小要件をサポートする別のコンピューティングリソースを選択し、ワークロードの需要によって増加が必要であることが示された時点でスケーリングすることもできます。

Microsoft-SMA のイベントログで、Win32 Process Exited with code [4294967295] という説明のある、対応するイベントを調べます。このエラーの原因は、Runbook で認証が構成されていないか、または Hybrid Runbook Worker グループの実行資格情報が指定されていないことです。「Hybrid Runbook Worker での Runbook の実行」で Runbook のアクセス許可を調べ直して、Runbook の認証を正しく構成したことを確認します。

シナリオ: ゲートウェイエラーで Runbook が失敗する

問題

Log Analytics ゲートウェイサーバー経由での通信時に Hybrid Runbook Worker ジョブが更新に失敗し、"Spool operation id does not exist (spool ID): see attachment for job details and exact exception messages." という内容のエラーが返されました。

解決方法

Log Analytics ゲートウェイサーバーがオンラインであること、また、Hybrid Runbook Worker ロールのホストとなるマシンからアクセスできることを確認します。トラブルシューティングの補足情報については、Log Analytics ゲートウェイのトラブルシューティングに関するページを参照してください。

シナリオ: スケジュールされたジョブの開始時にハイブリッド Worker が使用できなかったので、ジョブの開始に失敗しました

問題

ジョブがハイブリッド Worker で開始できず、次のエラーが表示されます:

スケジュールされたジョブの開始時にハイブリッドワーカーを使用できなかったので、ハイブリッドワーカーは最後に mm/dd/yyyy でアクティブになりました。

原因

このエラーは、次の理由で発生する可能性があります:

そのマシンはもう存在しません。
マシンの電源が切れているので、アクセスできません。
マシンにネットワーク接続の問題があります。
Hybrid Runbook Worker 拡張機能がコンピューターからアンインストールされました。

解決方法

マシンが存在し、Hybrid Runbook Worker 拡張機能がインストールされていることを確認します。 Hybrid Worker は正常であり、ハートビートを提供する必要があります。このジョブを実行しようとした Hybrid Runbook Worker グループの Worker で Microsoft-SMA イベントログを確認して、ネットワークの問題のトラブルシューティングを行います。
Hybrid Worker からの ping の数を提供し、ping 関連の問題を確認するのに役立つ HybridWorkerPing メトリックを監視することもできます。

シナリオ: ジョブが Hybrid Worker のジョブ制限を超えたため中断されました

問題

ジョブが中断され、次のエラーメッセージが表示されます:

ジョブが Hybrid Worker のジョブ制限を超えたため、中断されました。この問題を解決するには、Hybrid Worker グループに Hybrid Worker をさらに追加します。

原因

ジョブは、次のいずれかの理由により中断される可能性があります:

グループ内のアクティブな各ハイブリッド worker は、30 秒ごとにジョブをポーリングして、使用可能なジョブがあるかどうかを確認します。 Worker は、先着順でジョブを選択します。ジョブがプッシュされたタイミングに応じて、Hybrid Worker グループ内の Hybrid Worker が最初に Automation サービスに ping を実行します。通常、1 つのハイブリッド worker で取得できるジョブは、ping ごと (つまり、30秒ごと) に 4 つです。ジョブのプッシュ率が 30 秒あたり 4 より高く、他の Worker がジョブを取得しなかった場合、ジョブが中断される可能性があります。
Hybrid Worker は、30 秒ごとに予想どおりにポーリングされない場合があります。これは、ワーカーが正常でない場合、またはネットワークの問題がある場合に発生する可能性があります。

解決方法

Hybrid Worker のジョブ制限が 30 秒あたり 4 つのジョブを超える場合は、Hybrid Worker グループにさらに Hybrid Worker を追加して、高可用性と負荷分散を実現できます。また、30 秒あたり 4 つのジョブの制限を超えないようにジョブをスケジュールすることもできます。ジョブキューの処理時間は、Hybrid Worker のハードウェアプロファイルと負荷によって異なります。 Hybrid Worker が正常であり、ハートビートを提供していることを確認します。
このジョブを実行しようとした Hybrid Runbook Worker グループの Worker で Microsoft-SMA イベントログを確認して、ネットワークの問題のトラブルシューティングを行います。
Hybrid Worker からの ping の数を提供する HybridWorkerPing メトリックを監視することもでき、ping 関連の問題を確認するのに役立ちます。

シナリオ: Hybrid Runbook Worker のイベント 15011

問題

Hybrid Runbook Worker で、クエリ結果が有効でないことを示すイベント 15011 が受信されます。ワーカーで SignalR サーバーとの接続を開こうとするときに、次のエラーが表示されます。

[AccountId={c7d22bd3-47b2-4144-bf88-97940102f6ca}] [Uri=https://cc-jobruntimedata-prod-su1.azure-automation.net/notifications/hub][Exception=System.TimeoutException: Transport timed out trying to connect at System.Runtime.ExceptionServices.ExceptionDispatchInfo.Throw() at System.Runtime.CompilerServices.TaskAwaiter.HandleNonSuccessAndDebuggerNotification(Task task) at JobRuntimeData.NotificationsClient.JobRuntimeDataServiceSignalRClient.<Start>d__45.MoveNext()

原因

Hybrid Runbook Worker が、Update Management など、機能の自動デプロイ用に正しく構成されていません。このデプロイには、VM を Log Analytics ワークスペースに接続する部分が含まれています。 PowerShell スクリプトにより、指定された名前のサブスクリプション内でワークスペースが検索されます。このケースでは、Log Analytics ワークスペースは別のサブスクリプションにあります。スクリプトでワークスペースが見つからず、作成が試みられますが、その名前は既に使用されています。結果として、デプロイが失敗します。

解像度

この問題を解決するには、2 つの方法があります。

別のサブスクリプション内で Log Analytics ワークスペースを検索するよう、PowerShell スクリプトを変更します。今後、多くの Hybrid Runbook Worker マシンをデプロイする予定である場合は、これが適切な解決策です。
Orchestrator サンドボックスで実行するようにワーカーマシンを手動で構成します。次に、Azure Automation アカウントで作成された Runbook をワーカーで実行して、機能をテストします。

シナリオ: ハイブリッド worker グループから Microsoft Azure VM が自動的に削除される

問題

ワーカーマシンが長時間オフになっている場合、Hybrid Runbook Worker または VM が表示されません。

原因

Hybrid Runbook Worker マシンで、Azure Automation に対する ping が 30 日以上行われていません。その結果、Automation によって Hybrid Runbook Worker グループまたはシステムワーカーグループが削除されました。

解決方法

ワーカーマシンを起動し、Azure Automation に再登録します。 Runbook 環境をインストールして Azure Automation に接続する方法の手順については、「Windows Hybrid Runbook Worker をデプロイする」を参照してください。

シナリオ: Hybrid Runbook Worker の証明書ストアに証明書が見つかりませんでした

問題

Hybrid Runbook Worker で実行される Runbook が次のエラーメッセージで失敗します。

Connect-AzAccount : No certificate was found in the certificate store with thumbprint 0000000000000000000000000000000000000000 At line:3 char:1 + Connect-AzAccount -ServicePrincipal -Tenant $Conn.TenantID -Appl ... + ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + CategoryInfo : CloseError: (:) [Connect-AzAccount],ArgumentException + FullyQualifiedErrorId : Microsoft.Azure.Commands.Profile.ConnectAzAccountCommand

原因

このエラーは、Hybrid Runbook Worker 上で実行される Runbook 内で実行アカウントを使用しようとしたが、その実行アカウントの証明書が存在しない場合に発生します。 Hybrid Runbook Workers には、既定では証明書資産はローカルにありません。実行アカウントでは、この資産が適切に動作していることが要求されます。

解決方法

お使いの Hybrid Runbook Worker が Azure VM である場合は、代わりに、マネージド ID による Runbook 認証を使用できます。このシナリオでは、実行アカウントの代わりに Azure VM のマネージド ID を使用して Azure リソースへの認証を可能にすることで、認証を簡素化します。 Hybrid Runbook Worker がオンプレミスのコンピューターである場合は、実行アカウント証明書をコンピューターにインストールする必要があります。証明書をインストールする方法については、「Hybrid Runbook Worker での Runbook の実行」で、PowerShell Runbook の Export-RunAsCertificateToHybridWorker を実行するための手順を参照してください。

シナリオ: Hybrid Runbook Worker の登録中のエラー 403

問題

ワーカーの初期登録フェーズが失敗し、次のエラー (403) が表示されます。

Forbidden: You don't have permission to access / on this server.

原因

以下の問題が原因となっている可能性があります。

エージェントの設定で、ワークスペース ID かワークスペースキー (プライマリ) に入力ミスがあります。
Hybrid Runbook Worker で構成をダウンロードできず、それがアカウントリンクエラーの原因となっています。 Azure では、マシンで機能を有効にしたときに、Log Analytics ワークスペースと Automation アカウントをリンクするために特定のリージョンのみがサポートされます。コンピューターで、誤った日付または時刻が設定されている可能性もあります。時刻が現在の時刻の 15 分後または前である場合、機能のデプロイは失敗します。
Log Analytics Gateway が Hybrid Runbook Worker をサポートするように構成されていません。

解決方法

ワークスペース ID またはキーの入力ミス

エージェントのワークスペース ID またはワークスペースキーに入力ミスがあったかどうかを確認するには、Windows エージェントの場合は Windows エージェントでのワークスペースの追加または削除に関する記事を、Linux エージェントの場合は Linux エージェントでのワークスペースの追加または削除に関する記事を参照してください。 Azure portal から完全な文字列を選択し、注意深くコピーと貼り付けを行うようにします。

構成がダウンロードされていない

Log Analytics ワークスペースと Automation アカウントは、リンクされたリージョン内にある必要があります。これは、Update Management によって使用されるSystem Hybrid Runbook Worker に推奨されるソリューションです。サポートされているリージョンの一覧については、Azure Automation と Log Analytics ワークスペースのマッピングに関する記事を参照してください。

コンピューターの日付やタイムゾーンの更新が必要な場合もあります。カスタムの時間範囲を選択する場合は、その範囲が UTC であることを確認してください。これは、ローカルタイムゾーンとは異なる場合があります。

Log Analytics ゲートウェイが構成されていません

ここに記載されている手順に従って、Hybrid Runbook Worker エンドポイントを Log Analytics Gateway に追加します。

シナリオ: Hybrid Runbook Worker で Set-AzStorageBlobContent が失敗する

問題

Runbook が Set-AzStorageBlobContent の実行を試みたときに失敗し、次のエラーメッセージが表示されます。

Set-AzStorageBlobContent : Failed to open file xxxxxxxxxxxxxxxx: Illegal characters in path

原因

このエラーは、UNC パスを追加する [System.IO.Path]::GetFullPath() の呼び出しの長いファイル名の動作が原因で発生します。

解決方法

回避策として、次の内容を含む OrchestratorSandbox.exe.config という名前の構成ファイルを作成できます。

<configuration>
  <runtime>
    <AppContextSwitchOverrides value="Switch.System.IO.UseLegacyPathHandling=false" />
  </runtime>
</configuration>

このファイルを実行可能ファイル OrchestratorSandbox.exe と同じフォルダーに配置します。たとえば、にします。

%ProgramFiles%\Microsoft Monitoring Agent\Agent\AzureAutomation\7.3.702.0\HybridAgent

Note

エージェントをアップグレードすると、この構成ファイルは削除されるため、再作成する必要があります。

Linux

Linux Hybrid Runbook Worker は、Linux 用 Log Analytics エージェントを使用することにより、Automation アカウントと通信してワーカーの登録、Runbook ジョブの受信、状態の報告を行います。ワーカーの登録に失敗した場合に考えられるエラーの原因を次に示します。

シナリオ: Linux Hybrid Runbook Worker が Runbook に署名するときにパスワードの入力を求めるプロンプトを受け取る

問題

Linux Hybrid Runbook Worker で sudo コマンドを実行すると、パスワードの入力を求める想定外のプロンプトが表示されます。

原因

Linux 用 Log Analytics エージェントの nxautomationuser アカウントが sudoers ファイルで正しく構成されていません。 Hybrid Runbook Worker では、Linux Runbook Worker で Runbook に署名できるように、アカウントのアクセス許可やその他のデータが適切に構成されている必要があります。

解決方法

マシン上で、Hybrid Runbook Worker に GnuPG (GPG) の実行可能ファイルがあることを確認します。
sudoers ファイルで nxautomationuser アカウントの構成を確認します。「Hybrid Runbook Worker での Runbook の実行」を参照してください

シナリオ: Linux 用 Log Analytics エージェントが実行されていない

問題

Linux 用 Log Analytics エージェントが実行されていません。

原因

エージェントが実行されていない場合、Linux Hybrid Runbook Worker は Azure Automation と通信できません。さまざまな理由で、エージェントが実行されていない可能性があります。

解決方法

ps -ef | grep python コマンドを入力して、このエージェントが実行されていることを確認します。次のような出力が表示されます。 Python では、nxautomation ユーザーアカウントを使用して処理が行われます。 Azure Automation 機能が有効になっていない場合、次のどのプロセスも実行されていません。

nxautom+   8567      1  0 14:45 ?        00:00:00 python /opt/microsoft/omsconfig/modules/nxOMSAutomationWorker/DSCResources/MSFT_nxOMSAutomationWorkerResource/automationworker/worker/main.py /var/opt/microsoft/omsagent/state/automationworker/oms.conf rworkspace:<workspaceId> <Linux hybrid worker version>
nxautom+   8593      1  0 14:45 ?        00:00:02 python /opt/microsoft/omsconfig/modules/nxOMSAutomationWorker/DSCResources/MSFT_nxOMSAutomationWorkerResource/automationworker/worker/hybridworker.py /var/opt/microsoft/omsagent/state/automationworker/worker.conf managed rworkspace:<workspaceId> rversion:<Linux hybrid worker version>
nxautom+   8595      1  0 14:45 ?        00:00:02 python /opt/microsoft/omsconfig/modules/nxOMSAutomationWorker/DSCResources/MSFT_nxOMSAutomationWorkerResource/automationworker/worker/hybridworker.py /var/opt/microsoft/omsagent/<workspaceId>/state/automationworker/diy/worker.conf managed rworkspace:<workspaceId> rversion:<Linux hybrid worker version>

次の一覧は、Linux Hybrid Runbook Worker のために開始されるプロセスを示します。これらはすべて /var/opt/microsoft/omsagent/state/automationworker/ ディレクトリに配置されています。

oms.conf: ワーカーマネージャープロセス。これは、DSC から直接開始されます。
worker.conf: 自動登録ハイブリッドワーカープロセス。 worker マネージャーによって開始されます。このプロセスは Update Management によって使用され、ユーザーに透過的です。マシンで Update Management が有効になっていない場合、このプロセスは存在しません。
diy/worker.conf - DIY ハイブリッドワーカープロセスです。 DIY ハイブリッドワーカープロセスは、Hybrid Runbook Worker でユーザーの Runbook を実行するために使用されます。キーの詳細での自動登録ハイブリッドワーカープロセスとの唯一の違いは、異なる構成を使用していることです。 Azure Automation が無効であり、DIY Linux ハイブリッド worker が登録されていない場合、このプロセスは存在しません。

エージェントが実行されていない場合、次のコマンドを実行してサービスを開始します。sudo /opt/microsoft/omsagent/bin/service_control restart

シナリオ: 指定されたクラスが存在しない

/var/opt/microsoft/omsconfig/omsconfig.log 内エラーメッセージ The specified class does not exist.. がある場合は、Linux 用の Log Analytics エージェントを更新する必要があります。次のコマンドを実行してエージェントを再インストールしてください。

wget https://raw.githubusercontent.com/Microsoft/OMS-Agent-for-Linux/master/installer/scripts/onboard_agent.sh && sh onboard_agent.sh -w <WorkspaceID> -s <WorkspaceKey>

Windows

Windows Hybrid Runbook Worker は、Windows 用 Log Analytics エージェントを使用することにより、Automation アカウントと通信してワーカーの登録、Runbook ジョブの受信、状態の報告を行います。このセクションには、ワーカーの登録に失敗した場合の考えられる理由をいくつか示しています。

シナリオ: Windows 用 Log Analytics エージェントが実行されていない

問題

healthservice が Hybrid Runbook Worker マシンで実行されていません。

原因

Windows サービス用の Log Analytics が実行されていない場合、Hybrid Runbook Worker は Azure Automation と通信できません。

解決方法

PowerShell で次のコマンドを入力して、このエージェントが実行されていることを確認します: Get-Service healthservice。サービスが停止している場合は、PowerShell で次のコマンドを入力してサービスを開始します: Start-Service healthservice。

シナリオ: Operations Manager ログのイベント 4502

問題

[アプリケーションとサービスログ] の [Operations Manager] イベントログに、イベント 4502 と、Microsoft.EnterpriseManagement.HealthService.AzureAutomation.HybridAgent を含むイベントメッセージがあります。また、次の説明も含まれています。
The certificate presented by the service \<wsid\>.oms.opinsights.azure.com was not issued by a certificate authority used for Microsoft services. Please contact your network administrator to see if they are running a proxy that intercepts TLS/SSL communication.

原因

この問題は、プロキシまたはネットワークのファイアウォールが Microsoft Azure への通信をブロックしていることが原因で発生する可能性があります。コンピューターがポート 443 で .azure-automation.net に発信アクセスできることを確認します。

解決方法

ログは、各ハイブリッド worker の C:\ProgramData\Microsoft\System Center\Orchestrator\7.2\SMA\Sandboxes にローカルに格納されます。警告やエラーイベントが、アプリケーションとサービスログ\Microsoft-SMA\Operations とアプリケーションとサービスログ\Operations Manager イベントログにあるかどうかを確認できます。これらのログは、Azure Automation に対するロールの有効化に影響する接続や他の種類の問題、または通常の操作中に発生した問題を示しています。 Log Analytics エージェントに関する問題のトラブルシューティングの詳細については、Log Analytics Windows エージェントの問題のトラブルシューティングに関するページを参照してください。

ハイブリッド worker により、クラウドで実行されている Runbook ジョブが出力とメッセージを送信するのと同じ方法で、Runbook の出力とメッセージが Azure Automation に送信されます。詳細ストリームと進行状況ストリームは、Runbook の場合と同じように有効にすることができます。

シナリオ: Orchestrator.Sandbox.exe がプロキシ経由で Microsoft 365 に接続できない

問題

Windows Hybrid Runbook Worker で実行されるスクリプトを、想定どおりに Orchestrator サンドボックスの Microsoft 365 に接続できません。スクリプトでは、接続に Connect-MgGraph を使用しています。

Orchestrator.Sandbox.exe.config を調整してプロキシとバイパスリストを設定しても、サンドボックスに正常に接続されません。プロキシとバイパスリストの設定が同じ Powershell_ise.exe.config ファイルは、想定したとおり機能しているようです。 Service Management Automation (SMA) ログや PowerShell ログでは、プロキシに関する情報は提供されません。

原因

サーバー上の Active Directory フェデレーションサービス (AD FS) への接続でプロキシをバイパスすることはできません。 PowerShell サンドボックスはログインしたユーザーとして実行されることに注意してください。ただし、Orchestrator サンドボックスは大幅にカスタマイズされており、Orchestrator.Sandbox.exe.config ファイルの設定は無視されることがあります。それにはマシンまたは Log Analytics エージェントのプロキシ設定を処理するための特殊なコードが含まれていますが、それら以外のカスタムプロキシ設定は処理されません。

解決方法

Orchestrator サンドボックスの問題を解決するには、PowerShell コマンドレットではなく Microsoft Entra モジュールを使用するようにスクリプトを移行します。詳細については、「Orchestrator から Azure Automation (ベータ版) へ移行する」を参照してください。

引き続きモジュールのコマンドレットを使用する場合は、Invoke-Command を使用するようにスクリプトを変更します。 ComputerName パラメーターと Credential パラメーターの値を指定します。

$Credential = Get-AutomationPSCredential -Name MyProxyAccessibleCredential
Invoke-Command -ComputerName $env:COMPUTERNAME -Credential $Credential
{ Connect-MgGraph … }

このコード変更によって、指定された資格情報のコンテキストで、まったく新しい PowerShell セッションが開始されます。これで、アクティブユーザーを認証しているプロキシサーバー経由でトラフィックを送信できるはずです。

Note

この解決策を使用すると、サンドボックス構成ファイルを操作する必要がなくなります。スクリプトを使用して構成ファイルを正常に動作させることができた場合でも、Hybrid Runbook Worker エージェントが更新されるたびにそのファイルは消去されます。

シナリオ: Hybrid Runbook Worker がレポートしない

問題

Hybrid Runbook Worker マシンは実行されていますが、ワークスペース内のマシンのハートビートデータが表示されません。

次のクエリの例は、ワークスペース内のマシンとそれらの最後のハートビートを示しています:

Heartbeat
| summarize arg_max(TimeGenerated, *) by Computer

原因

この問題は、Hybrid Runbook Worker 上のキャッシュの破損が原因である可能性があります。

解決方法

この問題を解決するには、Hybrid Runbook Worker にサインインし、次のスクリプトを実行します。このスクリプトは、Windows 用 Log Analytics エージェントを停止し、そのキャッシュを削除して、サービスを再起動します。この操作により、Hybrid Runbook Worker の構成が Azure Automation から強制的に再ダウンロードされます。

Stop-Service -Name HealthService

Remove-Item -Path 'C:\Program Files\Microsoft Monitoring Agent\Agent\Health Service State' -Recurse

Start-Service -Name HealthService

シナリオ: Windows Hybrid Runbook Worker を追加できない

問題

Add-HybridRunbookWorker コマンドレットを使用して Hybrid Runbook Worker の追加を試みると、次のメッセージが表示されます。

Machine is already registered

原因

この問題は、マシンが既に別の Automation アカウントに登録されている場合や、マシンから Hybrid Runbook Worker を削除した後にそれを再度追加しようとした場合に発生する可能性があります。

解決方法

この問題を解決するには、次のレジストリキーを削除し、HealthService を再起動して、もう一度 Add-HybridRunbookWorker コマンドレットを試します。

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\HybridRunbookWorker

シナリオ: Linux Hybrid Runbook Worker を追加できない

問題

sudo python /opt/microsoft/omsconfig/.../onboarding.py --register Python スクリプトを使用して Hybrid Runbook Worker の追加を試みると、次のメッセージが表示されます。

Unable to register, an existing worker was found. Please deregister any existing worker and try again.

さらに、sudo python /opt/microsoft/omsconfig/.../onboarding.py --deregister Python スクリプトを使用して Hybrid Runbook Worker の登録を解除しようとした場合:

Failed to deregister worker. [response_status=404]

原因

この問題は、マシンが既に別の Automation アカウントに登録されている場合、Azure ハイブリッド Worker グループが削除されている場合、またはマシンから Hybrid Runbook Worker を削除した後で再度追加しようとした場合に発生する可能性があります。

解決方法

この問題を解決するには、次の手順を実行します。

sudo sh onboard_agent.sh --purge エージェントを削除します。

これらのコマンドを実行します。

sudo mv -f /home/nxautomation/state/worker.conf /home/nxautomation/state/worker.conf_old
sudo mv -f /home/nxautomation/state/worker_diy.crt /home/nxautomation/state/worker_diy.crt_old
sudo mv -f /home/nxautomation/state/worker_diy.key /home/nxautomation/state/worker_diy.key_old

sudo sh onboard_agent.sh -w <workspace id> -s <workspace key> -d opinsights.azure.com エージェントを再びオンボードします。
/opt/microsoft/omsconfig/modules/nxOMSAutomationWorker フォルダーが設定されるのを待ちます。
sudo python /opt/microsoft/omsconfig/.../onboarding.py --register Python スクリプトをもう一度試してください。

次のステップ

発生している問題がここで見つからないか、またはその問題を解決できない場合は、次のいずれかのチャネルで追加のサポートを受けてみてください。

Azure フォーラムを通じて Azure エキスパートから回答を得ることができます。
@AzureSupport (カスタマーエクスペリエンスを向上させるための Microsoft Azure の公式アカウント) に連絡する。 Azure サポートにより、Azure コミュニティの回答、サポート、エキスパートと結び付けられます。
Azure サポートインシデントを送信する。 Azure サポートのサイトに移動して、[サポートの要求] を選択します。

Automation でエージェント ベースの Hybrid Runbook Worker の問題をトラブルシューティングする

全般

Hybrid Worker の使用中に Az モジュールを更新できない

問題

解決方法

シナリオ: Runbook の実行が失敗する

問題

原因

解決方法

シナリオ: ゲートウェイ エラーで Runbook が失敗する

問題

解決方法

シナリオ: スケジュールされたジョブの開始時にハイブリッド Worker が使用できなかったので、ジョブの開始に失敗しました

問題

原因

解決方法

シナリオ: ジョブが Hybrid Worker のジョブ制限を超えたため中断されました

問題

原因

解決方法

シナリオ: Hybrid Runbook Worker のイベント 15011

問題

原因

解像度

シナリオ: ハイブリッド worker グループから Microsoft Azure VM が自動的に削除される

問題

原因

解決方法

シナリオ: Hybrid Runbook Worker の証明書ストアに証明書が見つかりませんでした

問題

原因

解決方法

シナリオ: Hybrid Runbook Worker の登録中のエラー 403

問題

原因

解決方法

ワークスペース ID またはキーの入力ミス

構成がダウンロードされていない

Log Analytics ゲートウェイが構成されていません

シナリオ: Hybrid Runbook Worker で Set-AzStorageBlobContent が失敗する

問題

原因

解決方法

Linux

シナリオ: Linux Hybrid Runbook Worker が Runbook に署名するときにパスワードの入力を求めるプロンプトを受け取る

問題

原因

解決方法

シナリオ: Linux 用 Log Analytics エージェントが実行されていない

問題

原因

解決方法

シナリオ: 指定されたクラスが存在しない

Windows

シナリオ: Windows 用 Log Analytics エージェントが実行されていない

問題

原因

解決方法

シナリオ: Operations Manager ログのイベント 4502

問題

原因

解決方法

シナリオ: Orchestrator.Sandbox.exe がプロキシ経由で Microsoft 365 に接続できない

問題

原因

解決方法

シナリオ: Hybrid Runbook Worker がレポートしない

問題

原因

解決方法

シナリオ: Windows Hybrid Runbook Worker を追加できない

問題

原因

解決方法

シナリオ: Linux Hybrid Runbook Worker を追加できない

問題

原因

解決方法

次のステップ

その他のリソース

Automation でエージェントベースの Hybrid Runbook Worker の問題をトラブルシューティングする

シナリオ: ゲートウェイエラーで Runbook が失敗する