Windows および Linux での Log Analytics エージェントの管理とメンテナンスManaging and maintaining the Log Analytics agent for Windows and Linux

Azure Monitor で Windows または Linux 用 Log Analytics エージェントを最初に配置した後、エージェントを再構成したり、アップグレードしたり、ライフサイクルの提供終了段階に達したエージェントをコンピューターから削除したりする必要があります。After initial deployment of the Log Analytics Windows or Linux agent in Azure Monitor, you may need to reconfigure the agent, upgrade it, or remove it from the computer if it has reached the retirement stage in its lifecycle. これらのルーチン メンテナンス タスクを手動またはオートメーションを介して管理することで、オペレーション エラーと経費の両方を減らすことができます。You can easily manage these routine maintenance tasks manually or through automation, which reduces both operational error and expenses.

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

Windows および Linux 用 Log Analytics エージェントは、配置のシナリオおよび VM が実行されている環境に応じて、手動または自動で最新リリースにアップグレードできます。The Log Analytics agent for Windows and Linux can be upgraded to the latest release manually or automatically depending on the deployment scenario and environment the VM is running in. エージェントをアップグレードするには、次の方法を使用できます。The following methods can be used to upgrade the agent.

環境Environment インストール方法Installation Method アップグレード方法Upgrade method
Azure VMAzure VM Windows/Linux 用の Log Analytics エージェント VM 拡張機能Log Analytics agent VM extension for Windows/Linux プロパティ autoUpgradeMinorVersionfalse に設定することによってオプトアウトするよう Azure Resource Manager テンプレートを構成していない限り、エージェントは既定で自動的にアップグレードされます。Agent is automatically upgraded by default unless you configured your Azure Resource Manager template to opt out by setting the property autoUpgradeMinorVersion to false.
カスタム Azure VM イメージCustom Azure VM images Windows/Linux 用 Log Analytics エージェントの手動インストールManual install of Log Analytics agent for Windows/Linux コマンド ラインから Windows インストーラー パッケージまたは Linux 自己解凍およびインストール可能シェル スクリプト バンドルを実行して、エージェントの最新バージョンへの VM の更新を実行する必要があります。Updating VMs to the newest version of the agent needs to be performed from the command line running the Windows installer package or Linux self-extracting and installable shell script bundle.
Azure 以外の VMNon-Azure VMs Windows/Linux 用 Log Analytics エージェントの手動インストールManual install of Log Analytics agent for Windows/Linux コマンド ラインから Windows インストーラー パッケージまたは Linux 自己解凍およびインストール可能シェル スクリプト バンドルを実行して、エージェントの最新バージョンへの VM の更新を実行する必要があります。Updating VMs to the newest version of the agent needs to be performed from the command line running the Windows installer package or Linux self-extracting and installable shell script bundle.

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

Windows VM 上のエージェントを、Log Analytics VM 拡張機能を使用してインストールされない最新バージョンに更新するには、コマンド プロンプト、スクリプト、またはその他の自動ソリューションから実行するか、または MMASetup-<プラットフォーム>.msi セットアップ ウィザードを使用して実行します。To update the agent on a Windows VM to the latest version not installed using the Log Analytics VM extension, you either run from the Command Prompt, script or other automation solution, or by using the MMASetup-<platform>.msi Setup Wizard.

Windows エージェントの最新バージョンは、次の手順を実行することによって、Log Analytics ワークスペースからダウンロードできます。You can download the latest version of the Windows agent from your Log Analytics workspace, by performing the following steps.

  1. Azure Portal にサインインします。Sign in to the Azure portal.

  2. Azure Portal で、 [すべてのサービス] をクリックします。In the Azure portal, click All services. リソースの一覧で、「Log Analytics」と入力します。In the list of resources, type Log Analytics. 入力を始めると、入力内容に基づいて、一覧がフィルター処理されます。As you begin typing, the list filters based on your input. [Log Analytics ワークスペース] を選択します。Select Log Analytics workspaces.

  3. Log Analytics ワークスペースの一覧からワークスペースを選択します。In your list of Log Analytics workspaces, select the workspace.

  4. Log Analytics ワークスペースで、 [詳細設定][接続されたソース][Windows サーバー] の順に選択します。In your Log Analytics workspace, select Advanced settings, then select Connected Sources, and finally Windows Servers.

  5. [Windows サーバー] ページからの適切な [Windows エージェントのダウンロード] を選択して、Windows オペレーティング システムのプロセッサ アーキテクチャに応じてダウンロードします。From the Windows Servers page, select the appropriate Download Windows Agent version to download depending on the processor architecture of the Windows operating system.

注意

Windows 用 Log Analytics エージェントのアップグレードの間は、レポート先のワークスペースの構成または再構成はサポートされていません。During the upgrade of the Log Analytics agent for Windows, it does not support configuring or reconfiguring a workspace to report to. エージェントを構成するには、「ワークスペースの追加または削除」で示されているサポートされる方法のいずれかに従う必要があります。To configure the agent, you need to follow one of the supported methods listed under Adding or removing a workspace.

セットアップ ウィザードを使用してアップグレードするにはTo upgrade using the Setup Wizard

  1. 管理者権限を持つアカウントでコンピューターにサインオンします。Sign on to the computer with an account that has administrative rights.

  2. MMASetup-<プラットフォーム>.exe を実行して、セットアップ ウィザードを開始します。Execute MMASetup-<platform>.exe to start the Setup Wizard.

  3. セットアップ ウィザードの最初のページで、 [次へ] をクリックします。On the first page of the Setup Wizard, click Next.

  4. [Microsoft Monitoring Agent のセットアップ] ダイアログ ボックスで、 [同意する] をクリックしてライセンス契約に同意します。In the Microsoft Monitoring Agent Setup dialog box, click I agree to accept the license agreement.

  5. [Microsoft Monitoring Agent のセットアップ] ダイアログ ボックスで、 [アップグレード] をクリックします。In the Microsoft Monitoring Agent Setup dialog box, click Upgrade. 状態ページに、アップグレードの進行状況が表示されます。The status page displays the progress of the upgrade.

  6. [Microsoft Monitoring Agent の構成が正常に完了しました。]When the Microsoft Monitoring Agent configuration completed successfully. ページが表示されたら、 [完了] をクリックします。page appears, click Finish.

コマンド ラインからアップグレードするにはTo upgrade from the command line

  1. 管理者権限を持つアカウントでコンピューターにサインオンします。Sign on to the computer with an account that has administrative rights.

  2. 管理者特権でのコマンド プロンプトからエージェント インストール ファイルを抽出するには、MMASetup-<platform>.exe /c を実行します。ファイルの抽出先のパスを指定するように求められます。To extract the agent installation files, from an elevated command prompt run MMASetup-<platform>.exe /c and it will prompt you for the path to extract files to. MMASetup-<platform>.exe /c /t:<Full Path> 引数を渡すことでパスを指定することもできます。Alternatively, you can specify the path by passing the arguments MMASetup-<platform>.exe /c /t:<Full Path>.

  3. 次のコマンドを実行します。D:\ はアップグレード ログ ファイルの場所です。Run the following command, where D:\ is the location for the upgrade log file.

    setup.exe /qn /l*v D:\logs\AgentUpgrade.log AcceptEndUserLicenseAgreement=1
    

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

以前のバージョン (1.0.0-47 以降) からのアップグレードがサポートされています。Upgrade from prior versions (>1.0.0-47) is supported. --upgrade コマンドを使用してインストールを実行すると、エージェントのすべてのコンポーネントが最新バージョンにアップグレードされます。Performing the installation with the --upgrade command will upgrade all components of the agent to the latest version.

エージェントをアップグレードするには、次のコマンドを実行します。Run the following command to upgrade the agent.

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

ワークスペースの追加または削除Adding or removing a workspace

Windows エージェントWindows agent

このセクションの手順は、別のワークスペースに報告したり、その構成からワークスペースを削除したりするために Windows エージェントを再構成する場合だけでなく、複数のワークスペースに報告するようにエージェントを構成する場合にも (通常、マルチホームと呼ばれます) 必要です。The steps in this section are necessary when you want to not only reconfigure the Windows agent to report to a different workspace or to remove a workspace from its configuration, but also when you want to configure the agent to report to more than one workspace (commonly referred to as multi-homing). 複数のワークスペースに報告するよう Windows エージェントを構成することは、エージェントの初期セットアップ後に、以下で説明する方法を使うことによってのみ、実行できます。Configuring the Windows agent to report to multiple workspaces can only be performed after initial setup of the agent and using the methods described below.

コントロール パネルから設定を更新するUpdate settings from Control Panel

  1. 管理者権限を持つアカウントでコンピューターにサインオンします。Sign on to the computer with an account that has administrative rights.

  2. [コントロール パネル] を開きます。Open Control Panel.

  3. [Microsoft Monitoring Agent] を選択した後、 [Azure Log Analytics] タブをクリックします。Select Microsoft Monitoring Agent and then click the Azure Log Analytics tab.

  4. ワークスペースを削除する場合は、削除するワークスペースを選択し、 [削除] をクリックします。If removing a workspace, select it and then click Remove. エージェントによる報告を停止するその他のワークスペースに対して、この手順を繰り返します。Repeat this step for any other workspace you want the agent to stop reporting to.

  5. ワークスペースを追加する場合は、 [追加] をクリックし、 [Log Analytics ワークスペースの追加] ダイアログ ボックスにワークスペース ID とワークスペース キー (主キー) を貼り付けます。If adding a workspace, click Add and on the Add a Log Analytics Workspace dialog box, paste the Workspace ID and Workspace Key (Primary Key). コンピューターが Azure Government クラウド内の Log Analytics ワークスペースに報告する必要がある場合は、[Azure クラウド] ドロップダウン リストから [Azure US Government] を選択します。If the computer should report to a Log Analytics workspace in Azure Government cloud, select Azure US Government from the Azure Cloud drop-down list.

  6. [OK] をクリックして変更を保存します。Click OK to save your changes.

PowerShell を使用してワークスペースを削除するRemove a workspace using PowerShell

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

PowerShell を使用して Azure 商用クラウドにワークスペースを追加するAdd a workspace in Azure commercial using PowerShell

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

PowerShell を使用してAzure US Government クラウドにワークスペースを追加するAdd a workspace in Azure for US Government using PowerShell

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

注意

以前、コマンド ラインまたはスクリプトを使用してエージェントをインストールまたは構成している場合、EnableAzureOperationalInsightsAddCloudWorkspaceRemoveCloudWorkspace に置き換えられています。If you've used the command line or script previously to install or configure the agent, EnableAzureOperationalInsights was replaced by AddCloudWorkspace and RemoveCloudWorkspace.

Linux エージェントLinux agent

次の手順では、Linux エージェントを別のワークスペースに登録する場合、またはその構成からワークスペースを削除する場合に、Linux エージェントを再構成する方法を示します。The following steps demonstrate how to reconfigure the Linux agent if you decide to register it with a different workspace or to remove a workspace from its configuration.

  1. ワークスペースに登録されていることを確認するには、次のコマンドを実行します。To verify it is registered to a workspace, run the following command:

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

    次の例のような状態が返されるはずです。It should return a status similar to the following example:

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

    状態はエージェントが実行されていることも示すので重要です。実行していないと、エージェントを再構成する次の手順は正常に完了しません。It is important that the status also shows the agent is running, otherwise the following steps to reconfigure the agent will not complete successfully.

  2. ワークスペースに既に登録されている場合は、次のコマンドを実行して、登録されているワークスペースを削除します。If it is already registered with a workspace, remove the registered workspace by running the following command. 登録されていない場合は、次の手順に進みます。Otherwise if it is not registered, proceed to the next step.

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

  3. 別のワークスペースに登録するには、次のコマンドを実行します。To register with a different workspace, run the following command:

    /opt/microsoft/omsagent/bin/omsadmin.sh -w <workspace id> -s <shared key> [-d <top level domain>]

  4. 変更が有効になったことを確認するには、次のコマンドを実行します。To verify your changes took effect, run the following command:

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

    次の例のような状態が返されるはずです。It should return a status similar to the following example:

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

変更を有効にするために、エージェント サービスを再起動する必要はありません。The agent service does not need to be restarted in order for the changes to take effect.

プロキシ設定を更新するUpdate proxy settings

配置後にプロキシ サーバーまたは Log Analytics ゲートウェイ経由で通信するようにエージェントを構成するには、次の方法のいずれかを使用して、このタスクを完了します。To configure the agent to communicate to the service through a proxy server or Log Analytics gateway after deployment, use one of the following methods to complete this task.

Windows エージェントWindows agent

コントロール パネルを使用して設定を更新するUpdate settings using Control Panel

  1. 管理者権限を持つアカウントでコンピューターにサインオンします。Sign on to the computer with an account that has administrative rights.

  2. [コントロール パネル] を開きます。Open Control Panel.

  3. [Microsoft Monitoring Agent] を選択した後、 [プロキシ設定] タブをクリックします。Select Microsoft Monitoring Agent and then click the Proxy Settings tab.

  4. [プロキシ サーバーの使用] をクリックし、プロキシ サーバーまたはゲートウェイの URL とポート番号を指定します。Click Use a proxy server and provide the URL and port number of the proxy server or gateway. プロキシ サーバーまたは Log Analytics ゲートウェイで認証が必要な場合は、認証するためのユーザー名とパスワードを入力し、 [OK] をクリックします。If your proxy server or Log Analytics gateway requires authentication, type the username and password to authenticate and then click OK.

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

次の PowerShell コード例をコピーし、環境に固有の情報を使用して更新し、PS1 ファイル名拡張子を付けて保存します。Copy the following sample PowerShell code, update it with information specific to your environment, and save it with a PS1 file name extension. Azure Monitor で Log Analytics ワークスペースに直接接続する各コンピューターでスクリプトを実行します。Run the script on each computer that connects directly to the Log Analytics workspace in Azure Monitor.

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 agent

Linux コンピューターがプロキシ サーバーまたは Log Analytics ゲートウェイ経由で通信する必要がある場合は、次の手順を実行します。Perform the following steps if your Linux computers need to communicate through a proxy server or Log Analytics gateway. プロキシ構成の値には次の構文があります。[protocol://][user:password@]proxyhost[:port]The proxy configuration value has the following syntax [protocol://][user:password@]proxyhost[:port]. proxyhost プロパティは、プロキシ サーバーの完全修飾ドメイン名または IP アドレスを受け取ります。The proxyhost property accepts a fully qualified domain name or IP address of the proxy server.

  1. 次のコマンドを実行してファイル /etc/opt/microsoft/omsagent/proxy.conf を編集し、値を固有の設定に変更します。Edit the file /etc/opt/microsoft/omsagent/proxy.conf by running the following commands and change the values to your specific settings.

    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
    
  2. 次のコマンドを実行してエージェントを再起動します。Restart the agent by running the following command:

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

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

次の手順のいずれかで、コマンドラインまたはセットアップ ウィザードを使用して、Windows または Linux エージェントをアンインストールします。Use one of the following procedures to uninstall the Windows or Linux agent using the command line or setup wizard.

Windows エージェントWindows agent

コントロール パネルからアンインストールするUninstall from Control Panel

  1. 管理者権限を持つアカウントでコンピューターにサインオンします。Sign on to the computer with an account that has administrative rights.

  2. コントロール パネルを開き、 [プログラムと機能] をクリックします。In Control Panel, click Programs and Features.

  3. [プログラムと機能] で、 [Microsoft Monitoring Agent] をクリックし、 [アンインストール] をクリックし、 [はい] をクリックします。In Programs and Features, click Microsoft Monitoring Agent, click Uninstall, and then click Yes.

注意

MMASetup-<platform>.exe をダブルクリックして、エージェント セットアップ ウィザードを実行することもできます。このファイルは、Azure portal でワークスペースからダウンロードできます。The Agent Setup Wizard can also be run by double-clicking MMASetup-<platform>.exe, which is available for download from a workspace in the Azure portal.

コマンドラインからアンインストールするUninstall from the command line

ダウンロードしたエージェント ファイルは、IExpress で作成された自己完結型インストール パッケージです。The downloaded file for the agent is a self-contained installation package created with IExpress. パッケージにはエージェントとサポート ファイルのセットアップ プログラムが含まれており、次の例に示すようにコマンドラインを使用して正しくアンインストールするためには、それらを抽出する必要があります。The setup program for the agent and supporting files are contained in the package and need to be extracted in order to properly uninstall using the command line shown in the following example.

  1. 管理者権限を持つアカウントでコンピューターにサインオンします。Sign on to the computer with an account that has administrative rights.

  2. 管理者特権でのコマンド プロンプトからエージェント インストール ファイルを抽出するには、extract MMASetup-<platform>.exe を実行します。ファイルの抽出先のパスを指定するように求められます。To extract the agent installation files, from an elevated command prompt run extract MMASetup-<platform>.exe and it will prompt you for the path to extract files to. extract MMASetup-<platform>.exe /c:<Path> /t:<Path> 引数を渡すことでパスを指定することもできます。Alternatively, you can specify the path by passing the arguments extract MMASetup-<platform>.exe /c:<Path> /t:<Path>. IExpress がサポートするコマンドライン スイッチの詳細について、IExpress のコマンド ライン スイッチに関する記事を参照し、ニーズに合うようにコード例を更新してください。For more information on the command-line switches supported by IExpress, see Command-line switches for IExpress and then update the example to suit your needs.

  3. プロンプトで、%WinDir%\System32\msiexec.exe /x <Path>:\MOMAgent.msi /qb を入力します。At the prompt, type %WinDir%\System32\msiexec.exe /x <Path>:\MOMAgent.msi /qb.

Linux エージェントLinux agent

エージェントを削除するには、Linux コンピューターで次のコマンドを実行します。To remove the agent, run the following command on the Linux computer. 引数 --purge を指定することにより、エージェントとその構成が完全に削除されます。The --purge argument completely removes the agent and its configuration.

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

Operations Manager 管理グループに報告するようにエージェントを構成するConfigure agent to report to an Operations Manager management group

Windows エージェントWindows agent

System Center Operations Manager 管理グループに報告するように Windows 用 Log Analytics エージェントを構成するには、次の手順を実行します。Perform the following steps to configure the Log Analytics agent for Windows to report to a System Center Operations Manager management group.

注意

現在進行中の Microsoft Operations Management Suite から Azure Monitor への移行の一環として、Windows 用または Linux 用の Operations Management Suite エージェントは、Windows 用 Log Analytics エージェントおよび Linux 用 Log Analytics エージェントと呼ばれるようになります。As part of the ongoing transition from Microsoft Operations Management Suite to Azure Monitor, the Operations Management Suite Agent for Windows or Linux will be referred to as the Log Analytics agent for Windows and Log Analytics agent for Linux.

  1. 管理者権限を持つアカウントでコンピューターにサインオンします。Sign on to the computer with an account that has administrative rights.

  2. [コントロール パネル] を開きます。Open Control Panel.

  3. Microsoft Monitoring Agent をクリックした後、 [Operations Manager] タブをクリックします。Click Microsoft Monitoring Agent and then click the Operations Manager tab.

  4. Operations Manager サーバーが Active Directory と統合されている場合は、 [管理グループの割り当てを AD DS から自動的に更新する] をクリックします。If your Operations Manager servers have integration with Active Directory, click Automatically update management group assignments from AD DS.

  5. [追加] をクリックして、 [管理グループを追加する] ダイアログ ボックスを開きます。Click Add to open the Add a Management Group dialog box.

  6. [管理グループ名] フィールドに、管理グループの名前を入力します。In Management group name field, type the name of your management group.

  7. [プライマリ管理サーバー] フィールドに、プライマリ管理サーバーのコンピューター名を入力します。In the Primary management server field, type the computer name of the primary management server.

  8. [管理サーバー ポート] フィールドに、TCP ポート番号を入力します。In the Management server port field, type the TCP port number.

  9. [エージェント アクション アカウント] で、ローカル システム アカウントまたはローカル ドメイン アカウントのいずれかを選択します。Under Agent Action Account, choose either the Local System account or a local domain account.

  10. [OK] をクリックして [管理グループを追加する] ダイアログ ボックスを閉じ、さらに [OK] をクリックして [Microsoft Monitoring Agent のプロパティ] ダイアログ ボックスを閉じます。Click OK to close the Add a Management Group dialog box and then click OK to close the Microsoft Monitoring Agent Properties dialog box.

Linux エージェントLinux agent

System Center Operations Manager 管理グループに報告するように Linux 用 Log Analytics エージェントを構成するには、次の手順を実行します。Perform the following steps to configure the Log Analytics agent for Linux to report to a System Center Operations Manager management group.

注意

現在進行中の Microsoft Operations Management Suite から Azure Monitor への移行の一環として、Windows 用または Linux 用の Operations Management Suite エージェントは、Windows 用 Log Analytics エージェントおよび Linux 用 Log Analytics エージェントと呼ばれるようになります。As part of the ongoing transition from Microsoft Operations Management Suite to Azure Monitor, the Operations Management Suite Agent for Windows or Linux will be referred to as the Log Analytics agent for Windows and Log Analytics agent for Linux.

  1. /etc/opt/omi/conf/omiserver.confEdit the file /etc/opt/omi/conf/omiserver.conf

  2. httpsport= で始まる行にポート 1270 が定義されていることを確認しますEnsure that the line beginning with httpsport= defines the port 1270. (例: httpsport=1270)。Such as: httpsport=1270

  3. sudo /opt/omi/bin/service_control restart で OMI サーバーを再起動します。Restart the OMI server: sudo /opt/omi/bin/service_control restart

次の手順Next steps