Windows および Linux での Log Analytics エージェントの管理とメンテナンス

[アーティクル]
10/15/2024

Azure Monitor で Windows または Linux 用 Log Analytics エージェントを最初にデプロイした後、エージェントを再構成したり、アップグレードしたり、ライフサイクルの提供終了段階に達したものをコンピューターから削除したりする必要があります。これらのルーチンメンテナンスタスクを手動またはオートメーションを介して管理することで、オペレーションエラーと経費の両方を減らすことができます。

重要

レガシの Log Analytics エージェントは、2024 年 8 月 31 日の時点で非推奨となっています。今後 Microsoft は、Log Analytics エージェントに関するすべてのサポートを提供しません。 Azure Monitor にデータを取り込むために Log Analytics エージェントを使用している場合は、Azure Monitor エージェントに移行してください。

エージェントをアップグレードする

デプロイのシナリオと VM が実行されている環境に基づいて、Windows および Linux 用の Log Analytics エージェントを、手動または自動で最新リリースにアップグレードします。

環境	インストール方法	アップグレード方法
Azure VM	Windows/Linux 用の Log Analytics エージェント VM 拡張機能	プロパティ `autoUpgradeMinorVersion` を false に設定することによってオプトアウトするように Azure Resource Manager テンプレートを構成していない限り、VM モデルの変更後、エージェントは自動的にアップグレードされます。ただし、デプロイされると、このプロパティが true に設定されていても、再デプロイされない限り、拡張機能でマイナーバージョンはアップグレードされません。 `enableAutomaticUpgrade` プロパティを使用したデプロイ後の自動更新は、Linux エージェントでのみサポートされます (「Linux エージェントの自動更新を有効にする」を参照してください)。メジャーバージョンのアップグレードは常に手動で行われます (「VirtualMachineExtensionInner.AutoUpgradeMinorVersion プロパティ」を参照してください)。
カスタム Azure VM イメージ	Windows/Linux 用 Log Analytics エージェントの手動インストール	コマンドラインから Windows インストーラーパッケージまたは Linux 自己解凍およびインストール可能シェルスクリプトバンドルを実行して、エージェントの最新バージョンへの VM の更新を実行する必要があります。
Azure 以外の VM	Windows/Linux 用 Log Analytics エージェントの手動インストール	コマンドラインから Windows インストーラーパッケージまたは Linux 自己解凍およびインストール可能シェルスクリプトバンドルを実行して、エージェントの最新バージョンへの VM の更新を実行する必要があります。

Windows エージェントをアップグレードする

Windows VM 上のエージェントを、Log Analytics VM 拡張機能を使用してインストールされない最新バージョンに更新するには、コマンドプロンプト、スクリプト、またはその他の自動ソリューションから実行するか、または MMASetup-<プラットフォーム>.msi セットアップウィザードを使用します。

Windows エージェントの最新バージョンを Log Analytics ワークスペースからダウンロードするには:

Azure portal にサインインします。
Azure Portal で [すべてのサービス] を選択します。リソースの一覧で、「Log Analytics」と入力します。入力を始めると、入力内容に基づいて、一覧がフィルター処理されます。 [Log Analytics ワークスペース] を選択します。
Log Analytics ワークスペースの一覧からワークスペースを選択します。
Log Analytics ワークスペースで、[エージェント] タイルを選択し、[Windows サーバー] を選択します。
[Windows サーバー] 画面の [Windows エージェントのダウンロード] で、Windows オペレーティングシステムのプロセッサアーキテクチャに応じてダウンロードする適切なバージョンを選択します。

Note

Windows 用 Log Analytics エージェントのアップグレードの間は、報告先のワークスペースの構成または再構成はサポートされていません。エージェントを構成するには、「ワークスペースを追加または削除する」で示されているサポートされる方法のいずれかに従います。

セットアップウィザードを使用してアップグレードする

管理者権限を持つアカウントでコンピューターにサインオンします。
MMASetup-<プラットフォーム>.exe を実行して、セットアップウィザードを開始します。
セットアップウィザードの最初のページで、[次へ] を選択します。
[Microsoft Monitoring Agent のセットアップ] ダイアログで、[同意する] を選択してライセンス契約に同意します。
[Microsoft Monitoring Agent のセットアップ] ダイアログで、[アップグレード] を選択します。状態ページに、アップグレードの進行状況が表示されます。
[Microsoft Monitoring Agent の構成が正常に完了しました] ページが表示されたら、[完了] を選択します。

コマンドラインからアップグレードする

管理者権限を持つアカウントでコンピューターにサインオンします。
エージェントインストールファイルを抽出するには、管理者特権でのコマンドプロンプトから MMASetup-<platform>.exe /c を実行します。ファイルの抽出先のパスを指定するように求められます。 MMASetup-<platform>.exe /c /t:<Full Path> 引数を渡すことでパスを指定することもできます。
次のコマンドを実行します。D:\ はアップグレードログファイルの場所です。
```
setup.exe /qn /l*v D:\logs\AgentUpgrade.log AcceptEndUserLicenseAgreement=1
```

Linux エージェントをアップグレードする

以前のバージョン (1.0.0-47 以降) からのアップグレードがサポートされています。 --upgrade コマンドを使用してインストールを実行すると、エージェントのすべてのコンポーネントが最新バージョンにアップグレードされます。

エージェントをアップグレードするには、次のコマンドを実行します。

sudo sh ./omsagent-*.universal.x64.sh --upgrade

Linux エージェントの自動更新を有効にする

エージェントを自動的に更新するには、次のコマンドを使って拡張機能の自動アップグレードを有効にすることをお勧めします。

PowerShell
Azure CLI

Set-AzVMExtension \
  -ResourceGroupName myResourceGroup \
  -VMName myVM \
  -ExtensionName OmsAgentForLinux \
  -ExtensionType OmsAgentForLinux \
  -Publisher Microsoft.EnterpriseCloud.Monitoring \
  -TypeHandlerVersion latestVersion \
  -ProtectedSettingString '{"workspaceKey":"myWorkspaceKey"}' \
  -SettingString '{"workspaceId":"myWorkspaceId","skipDockerProviderInstall": true}' \
  -EnableAutomaticUpgrade $true

az vm extension set \
  --resource-group myResourceGroup \
  --vm-name myVM \
  --name OmsAgentForLinux \
  --publisher Microsoft.EnterpriseCloud.Monitoring \
  --protected-settings '{"workspaceKey":"myWorkspaceKey"}' \
  --settings '{"workspaceId":"myWorkspaceId","skipDockerProviderInstall": true}' \
  --version latestVersion \
  --enable-auto-upgrade true

ワークスペースを追加または削除する

Windows エージェントまたは Linux エージェントを使用してワークスペースを追加または削除します。

Windows エージェント

このセクションの手順は、別のワークスペースに報告したり、その構成からワークスペースを削除したりするために Windows エージェントを再構成する場合だけでなく、複数のワークスペースに報告するようにエージェントを構成する場合にも必要です。 (この方法は通常、マルチホームと呼ばれます)。複数のワークスペースに報告するような Windows エージェントの構成は、エージェントの初期設定後に、このセクションで説明する方法を使用することによってのみ実行できます。

コントロールパネルから設定を更新する

管理者権限を持つアカウントでコンピューターにサインオンします。
[コントロールパネル] を開きます。
[Microsoft Monitoring Agent] を選択した後、[Azure Log Analytics] タブを選択します。
ワークスペースを削除する場合は、これを選択し、[削除] を選択します。エージェントによる報告を停止するその他のワークスペースに対して、この手順を繰り返します。
ワークスペースを追加する場合は、[追加] を選択します。 [Log Analytics ワークスペースの追加] ダイアログで、ワークスペース ID とワークスペースキー (主キー) を貼り付けます。コンピューターが Azure Government クラウド内の Log Analytics ワークスペースに報告する必要がある場合は、 [Azure クラウド] ドロップダウンリストから [Azure US Government] を選択します。
[OK] を選択して変更を保存します。

PowerShell を使用してワークスペースを削除する

$workspaceId = "<Your workspace Id>"
$mma = New-Object -ComObject 'AgentConfigManager.MgmtSvcCfg'
$mma.RemoveCloudWorkspace($workspaceId)
$mma.ReloadConfiguration()

PowerShell を使用して Azure 商用クラウドにワークスペースを追加する

$workspaceId = "<Your workspace Id>"
$workspaceKey = "<Your workspace Key>"
$mma = New-Object -ComObject 'AgentConfigManager.MgmtSvcCfg'
$mma.AddCloudWorkspace($workspaceId, $workspaceKey)
$mma.ReloadConfiguration()

PowerShell を使用してAzure US Government クラウドにワークスペースを追加する

$workspaceId = "<Your workspace Id>"
$workspaceKey = "<Your workspace Key>"
$mma = New-Object -ComObject 'AgentConfigManager.MgmtSvcCfg'
$mma.AddCloudWorkspace($workspaceId, $workspaceKey, 1)
$mma.ReloadConfiguration()

Note

以前、コマンドラインまたはスクリプトを使用してエージェントをインストールまたは構成している場合、EnableAzureOperationalInsights は AddCloudWorkspace と RemoveCloudWorkspace に置き換えられています。

Linux エージェント

次の手順では、Linux エージェントを別のワークスペースに登録する場合、またはその構成からワークスペースを削除する場合に、Linux エージェントを再構成する方法を示します。

エージェントがワークスペースに登録されていることを確認するには、次のコマンドを実行します。

/opt/microsoft/omsagent/bin/omsadmin.sh -l

次の例のような状態が返されるはずです。

Primary Workspace: <workspaceId> Status: Onboarded(OMSAgent Running)

エージェントが実行されていることも状態に示されていることが重要です。そうではないと、エージェントを再構成するための次の手順は正常に完了しません。
エージェントがワークスペースに既に登録されている場合は、次のコマンドを実行して、登録されているワークスペースを削除します。登録されていない場合は、次の手順に進みます。

/opt/microsoft/omsagent/bin/omsadmin.sh -X
別のワークスペースに登録するには、次のコマンドを実行します。

/opt/microsoft/omsagent/bin/omsadmin.sh -w <workspace id> -s <shared key> [-d <top level domain>]
変更が有効になったことを確認するには、次のコマンドを実行します。

/opt/microsoft/omsagent/bin/omsadmin.sh -l

次の例のような状態が返されるはずです。

Primary Workspace: <workspaceId> Status: Onboarded(OMSAgent Running)

変更を有効にするために、エージェントサービスを再起動する必要はありません。

プロキシ設定を更新する

Log Analytics エージェント (MMA) は、システムプロキシ設定を使用しません。その結果、MMA のインストール中にプロキシ設定を渡す必要があります。これらの設定は、VM の MMA 構成 (レジストリ) に保存されます。配置後にプロキシサーバーまたは Log Analytics ゲートウェイ経由で通信するようにエージェントを構成するには、次の方法のいずれかを使用して、このタスクを完了します。

Windows エージェント

Azure Windows エージェントを使用します。

コントロールパネルを使用して設定を更新する

管理者権限を持つアカウントでコンピューターにサインオンします。
[コントロールパネル] を開きます。
[Microsoft Monitoring Agent] を選択し、[プロキシ設定] タブを選択します。
[プロキシサーバーの使用] を選択し、プロキシサーバーまたはゲートウェイの URL とポート番号を指定します。プロキシサーバーまたは Log Analytics ゲートウェイで認証が必要な場合は、認証するためのユーザー名とパスワードを入力して、[OK] を選択します。

PowerShell を使用して設定を更新する

次の PowerShell コード例をコピーし、環境に固有の情報を使用して更新し、PS1 ファイル名拡張子を付けて保存します。 Azure Monitor で Log Analytics ワークスペースに直接接続する各コンピューターでスクリプトを実行します。

param($ProxyDomainName="https://proxy.contoso.com:30443", $cred=(Get-Credential))

# First we get the Health Service configuration object. We need to determine if we
#have the right update rollup with the API we need. If not, no need to run the rest of the script.
$healthServiceSettings = New-Object -ComObject 'AgentConfigManager.MgmtSvcCfg'

$proxyMethod = $healthServiceSettings | Get-Member -Name 'SetProxyInfo'

if (!$proxyMethod)
{
    Write-Output 'Health Service proxy API not present, will not update settings.'
    return
}

Write-Output "Clearing proxy settings."
$healthServiceSettings.SetProxyInfo('', '', '')

$ProxyUserName = $cred.username

Write-Output "Setting proxy to $ProxyDomainName with proxy username $ProxyUserName."
$healthServiceSettings.SetProxyInfo($ProxyDomainName, $ProxyUserName, $cred.GetNetworkCredential().password)

Linux エージェント

Linux コンピューターがプロキシサーバーまたは Log Analytics ゲートウェイ経由で通信する必要がある場合は、次の手順を実行します。プロキシ構成の値の構文は [protocol://][user:password@]proxyhost[:port] です。 proxyhost プロパティは、プロキシサーバーの完全修飾ドメイン名または IP アドレスを受け取ります。

次のコマンドを実行してファイル /etc/opt/microsoft/omsagent/proxy.conf を編集し、値を固有の設定に変更します。

proxyconf="https://proxyuser:proxypassword@proxyserver01:30443"
sudo echo $proxyconf >>/etc/opt/microsoft/omsagent/proxy.conf
sudo chown omsagent:omiusers /etc/opt/microsoft/omsagent/proxy.conf

次のコマンドを実行してエージェントを再起動します。

sudo /opt/microsoft/omsagent/bin/service_control restart [<workspace id>]

ログに "cURL failed to perform on this base url" が表示された場合は、エラーを解決するために proxy.conf の EOF から '\n' を削除してみることができます。

od -c /etc/opt/microsoft/omsagent/proxy.conf
cat /etc/opt/microsoft/omsagent/proxy.conf | tr -d '\n' > /etc/opt/microsoft/omsagent/proxy2.conf
rm /etc/opt/microsoft/omsagent/proxy.conf
mv /etc/opt/microsoft/omsagent/proxy2.conf /etc/opt/microsoft/omsagent/proxy.conf
sudo chown omsagent:omiusers /etc/opt/microsoft/omsagent/proxy.conf
sudo /opt/microsoft/omsagent/bin/service_control restart [<workspace id>]

エージェントをアンインストールする

次の手順のいずれかで、コマンドラインまたはセットアップウィザードを使用して、Windows または Linux エージェントをアンインストールします。

Windows エージェント

Windows エージェントを使用します。

コントロールパネルからアンインストールする

管理者権限を持つアカウントでコンピューターにサインオンします。
コントロールパネルで、[プログラムと機能] を選択します。
[プログラムと機能] で、[Microsoft Monitoring Agent]>[アンインストール]>[はい] を選択します。

Note

MMASetup-\<platform\>.exe をダブルクリックして、エージェントセットアップウィザードを実行することもできます。これは、Azure portal でワークスペースからダウンロードできます。

コマンドラインからアンインストールする

ダウンロードしたエージェントファイルは、IExpress で作成された自己完結型インストールパッケージです。パッケージにはエージェントとサポートファイルのセットアッププログラムが含まれており、次の例に示すようにコマンドラインを使用して正しくアンインストールするためには、それらを抽出する必要があります。

管理者権限を持つアカウントでコンピューターにサインオンします。
管理者特権でのコマンドプロンプトからエージェントインストールファイルを抽出するには、extract MMASetup-<platform>.exe を実行します。ファイルの抽出先のパスを指定するように求められます。 extract MMASetup-<platform>.exe /c:<Path> /t:<Path> 引数を渡すことでパスを指定することもできます。 IExpress がサポートするコマンドラインスイッチの詳細について、IExpress のコマンドラインスイッチに関する記事を参照し、ニーズに合うようにコード例を更新してください。
プロンプトで %WinDir%\System32\msiexec.exe /x <Path>:\MOMAgent.msi /qb と入力します。

Linux エージェント

エージェントを削除するには、Linux コンピューターで次のコマンドを実行します。引数 --purge を指定することにより、エージェントとその構成が完全に削除されます。

wget https://raw.githubusercontent.com/Microsoft/OMS-Agent-for-Linux/master/installer/scripts/onboard_agent.sh && sh onboard_agent.sh --purge

Operations Manager 管理グループに報告するようにエージェントを構成する

Windows エージェントを使用します。

Windows エージェント

System Center Operations Manager 管理グループに報告するように Windows 用 Log Analytics エージェントを構成するには、次の手順を実行します。

Note

現在進行中の Microsoft Operations Management Suite から Azure Monitor への移行の一環として、Windows 用または Linux 用の Operations Management Suite エージェントは、Windows 用 Log Analytics エージェントおよび Linux 用 Log Analytics エージェントと呼ばれるようになります。

管理者権限を持つアカウントでコンピューターにサインオンします。
[コントロールパネル] を開きます。
[Microsoft Monitoring Agent] を選択した後、[Operations Manager] タブを選択します。
Operations Manager サーバーが Active Directory と統合されている場合は、[管理グループの割り当てを AD DS から自動的に更新する] を選択します。
[追加] を選択して、[管理グループを追加する] ダイアログを開きます。
[管理グループ名] フィールドに、管理グループの名前を入力します。
[プライマリ管理サーバー] フィールドに、プライマリ管理サーバーのコンピューター名を入力します。
[管理サーバーポート] フィールドに、TCP ポート番号を入力します。
[エージェントアクションアカウント] で、ローカルシステムアカウントまたはローカルドメインアカウントのいずれかを選択します。
[OK] を選択して、[管理グループの追加] ダイアログを閉じます。次に、[OK] を選択して、[Microsoft Monitoring Agent のプロパティ] ダイアログを閉じます。

Linux エージェント

System Center Operations Manager 管理グループに報告するように Linux 用 Log Analytics エージェントを構成するには、次の手順を実行します。

Note

ファイル /etc/opt/omi/conf/omiserver.conf を編集します。
httpsport= で始まる行にポート 1270 が定義されている (httpsport=1270 など) ことを確認します。
次のコマンドを使用して、OMI サーバーを再起動します。

sudo /opt/omi/bin/service_control restart

よく寄せられる質問

このセクションでは、一般的な質問への回答を示します。

Log Analytics エージェントと Azure Monitor の通信を停止するにはどうすればよいですか?

Log Analytics に直接接続されているエージェントの場合は、[コントロールパネル] を開き、[Microsoft Monitoring Agent] を選択します。 [Azure Log Analytics (OMS)] タブで、一覧に表示されているすべてのワークスペースを削除します。 System Center Operations Manager では、Log Analytics マネージドコンピューターの一覧からコンピューターを削除します。 Operations Manager はエージェントの構成を更新して、Log Analytics に報告しなくなるようにします。

次のステップ

Linux エージェントのインストールまたは管理中に問題が発生した場合は、Linux エージェントのトラブルシューティングに関する記事を参照してください。
Windows エージェントのインストールまたは管理中に問題が発生した場合は、Windows エージェントのトラブルシューティングに関する記事を参照してください。

次の方法で共有

Windows および Linux での Log Analytics エージェントの管理とメンテナンス

エージェントをアップグレードする

Windows エージェントをアップグレードする

セットアップウィザードを使用してアップグレードする

コマンドラインからアップグレードする

Linux エージェントをアップグレードする

Linux エージェントの自動更新を有効にする

ワークスペースを追加または削除する

Windows エージェント

コントロールパネルから設定を更新する

PowerShell を使用してワークスペースを削除する

PowerShell を使用して Azure 商用クラウドにワークスペースを追加する

PowerShell を使用してAzure US Government クラウドにワークスペースを追加する

Linux エージェント

プロキシ設定を更新する

Windows エージェント

コントロールパネルを使用して設定を更新する

PowerShell を使用して設定を更新する

Linux エージェント

エージェントをアンインストールする

Windows エージェント

コントロールパネルからアンインストールする

コマンドラインからアンインストールする

Linux エージェント

Operations Manager 管理グループに報告するようにエージェントを構成する

Windows エージェント

Linux エージェント

よく寄せられる質問

Log Analytics エージェントと Azure Monitor の通信を停止するにはどうすればよいですか?

次のステップ

フィードバック

その他のリソース

次の方法で共有

Windows および Linux での Log Analytics エージェントの管理とメンテナンス

エージェントをアップグレードする

Windows エージェントをアップグレードする

セットアップ ウィザードを使用してアップグレードする

コマンド ラインからアップグレードする

Linux エージェントをアップグレードする

Linux エージェントの自動更新を有効にする

ワークスペースを追加または削除する

Windows エージェント

コントロール パネルから設定を更新する

PowerShell を使用してワークスペースを削除する

PowerShell を使用して Azure 商用クラウドにワークスペースを追加する

PowerShell を使用してAzure US Government クラウドにワークスペースを追加する

Linux エージェント

プロキシ設定を更新する

Windows エージェント

コントロール パネルを使用して設定を更新する

PowerShell を使用して設定を更新する

Linux エージェント

エージェントをアンインストールする

Windows エージェント

コントロール パネルからアンインストールする

コマンドラインからアンインストールする

Linux エージェント

Operations Manager 管理グループに報告するようにエージェントを構成する

Windows エージェント

Linux エージェント

よく寄せられる質問

Log Analytics エージェントと Azure Monitor の通信を停止するにはどうすればよいですか?

次のステップ

フィードバック

その他のリソース

セットアップウィザードを使用してアップグレードする

コマンドラインからアップグレードする

コントロールパネルから設定を更新する

コントロールパネルを使用して設定を更新する

コントロールパネルからアンインストールする