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

[アーティクル]
07/07/2022

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

重要

レガシ Log Analytics エージェントは、2024 年 8 月までに非推奨になります。データの取り込みを続行するには、2024 年 8 月より前に必ず Azure Monitor エージェントに移行してください。

エージェントのアップグレード

Windows および Linux 用 Log Analytics エージェントは、配置のシナリオおよび VM が実行されている環境に応じて、手動または自動で最新リリースにアップグレードできます。エージェントをアップグレードするには、次の方法を使用できます。

環境	インストール方法	アップグレード方法
Azure VM	Windows/Linux 用の Log Analytics エージェント VM 拡張機能	プロパティ autoUpgradeMinorVersion を false に設定することによってオプトアウトするように Azure Resource Manager テンプレートを構成していない限り、VM モデルの変更後、エージェントは自動的にアップグレードされます。ただし、デプロイされると、このプロパティが true に設定されていても、再デプロイされない限り、拡張機能でマイナーバージョンのアップグレードは行われません。メジャーバージョンのアップグレードは常に手動です。 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

ワークスペースの追加または削除

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 エージェント

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

管理者権限を持つアカウントでコンピューターにサインオンします。
[コントロールパネル] を開きます。
[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>]

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

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

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 エージェント

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)。
sudo /opt/omi/bin/service_control restart で OMI サーバーを再起動します。

次のステップ

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

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

エージェントのアップグレード

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

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

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

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

ワークスペースの追加または削除

Windows エージェント

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

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

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

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

Linux エージェント

プロキシ設定を更新する

Windows エージェント

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

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

Linux エージェント

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

Windows エージェント

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

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

Linux エージェント

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

Windows エージェント

Linux エージェント

次のステップ

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

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

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

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

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