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

Log Analytics 用の Windows または Linux エージェントを最初に配置した後、エージェントを再構成したり、ライフ サイクルの提供終了段階に達したエージェントをコンピューターから削除したりする必要があります。After initial deployment of the Windows or Linux agent for Log Analytics, you may need to reconfigure the agent, or remove it from the computer if 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.

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

Windows エージェントWindows agent

コントロール パネルから設定を更新する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 (OMS)] タブをクリックします。Select Microsoft Monitoring Agent and then click the Azure Log Analytics (OMS) 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 want 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. 別のワークスペースに登録するには、/opt/microsoft/omsagent/bin/omsadmin.sh -w <workspace id> -s <shared key> [-d <top level domain>] コマンドを実行しますTo register with a different workspace, run the command /opt/microsoft/omsagent/bin/omsadmin.sh -w <workspace id> -s <shared key> [-d <top level domain>]

  4. 変更が有効になったことを確認するには、次のコマンドを実行します。To verify your changes took affect, run the 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

配置後にプロキシ サーバーまたは OMS ゲートウェイ経由で通信するようにエージェントを構成するには、次の方法のいずれかを使用して、このタスクを完了します。To configure the agent to communicate to the service through a proxy server or OMS 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. プロキシ サーバーまたは OMS ゲートウェイで認証が必要な場合は、認証するためのユーザー名とパスワードを入力し、[OK] をクリックします。If your proxy server or OMS 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. Log Analytics サービスに直接接続する各コンピューターでスクリプトを実行します。Run the script on each computer that connects directly to the Log Analytics service.

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 コンピューターがプロキシ サーバーまたは OMS ゲートウェイ経由で Log Analytics と通信する必要がある場合は、次の手順を実行します。Perform the following steps if your Linux computers need to communicate through a proxy server or OMS Gateway to Log Analytics. プロキシ構成の値には次の構文があります。[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-.exe をダブルクリックして、エージェント セットアップ ウィザードを実行することもできます。このファイルは、Azure ポータルでワークスペースからダウンロードできます。The Agent Setup Wizard can also be run by double-clicking MMASetup-.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 swtiches 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 管理グループに報告するように OMS Agent for Windows を構成するには、次の手順を実行します。Perform the following steps to configure the OMS Agent for Windows to report to a System Center Operations Manager management group.

  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 管理グループにレポートするように OMS Agent for Linux を構成するには、次の手順を実行します。Perform the following steps to configure the OMS Agent for Linux to report to a System Center Operations Manager management group.

  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

エージェントのインストールまたは管理中に問題が発生した場合は、Linux エージェントのトラブルシューティングに関する記事を参照してください。Review Troubleshooting the Linux agent if you encounter issues while installing or managing the agent.