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

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

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

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

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

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

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

1. Azure portal にサインインします。

2. Azure Portal で [すべてのサービス] を選択します。 リソースの一覧で、「Log Analytics」と入力します。 入力を始めると、入力内容に基づいて、一覧がフィルター処理されます。 [Log Analytics ワークスペース] を選択します。

3. Log Analytics ワークスペースの一覧からワークスペースを選択します。

4. Log Analytics ワークスペースで、[エージェント] タイルを選択し、[Windows サーバー] を選択します。

5. [Windows サーバー] 画面の [Windows エージェントのダウンロード] で、Windows オペレーティング システムのプロセッサ アーキテクチャに応じてダウンロードする適切なバージョンを選択します。

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

1. 管理者権限を持つアカウントでコンピューターにサインオンします。

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

3. セットアップ ウィザードの最初のページで、[次へ] を選択します。

4. [Microsoft Monitoring Agent のセットアップ] ダイアログで、[同意する] を選択してライセンス契約に同意します。

5. [Microsoft Monitoring Agent のセットアップ] ダイアログで、[アップグレード] を選択します。 状態ページに、アップグレードの進行状況が表示されます。

6. [Microsoft Monitoring Agent の構成が正常に完了しました] ページが表示されたら、[完了] を選択します。

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

1. 管理者権限を持つアカウントでコンピューターにサインオンします。

2. エージェント インストール ファイルを抽出するには、管理者特権でのコマンド プロンプトから MMASetup-<platform>.exe /c を実行します。ファイルの抽出先のパスを指定するように求められます。 MMASetup-<platform>.exe /c /t:<Full Path> 引数を渡すことでパスを指定することもできます。

3. 次のコマンドを実行します。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 エージェントの自動更新を有効にする

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

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 エージェントの構成は、エージェントの初期設定後に、このセクションで説明する方法を使用することによってのみ実行できます。

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

1. 管理者権限を持つアカウントでコンピューターにサインオンします。

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

3. [Microsoft Monitoring Agent] を選択した後、[Azure Log Analytics] タブを選択します。

4. ワークスペースを削除する場合は、これを選択し、[削除] を選択します。 エージェントによる報告を停止するその他のワークスペースに対して、この手順を繰り返します。

5. ワークスペースを追加する場合は、[追加] を選択します。 [Log Analytics ワークスペースの追加] ダイアログで、ワークスペース ID とワークスペース キー (主キー) を貼り付けます。 コンピューターが Azure Government クラウド内の Log Analytics ワークスペースに報告する必要がある場合は、 [Azure クラウド] ドロップダウン リストから [Azure US Government] を選択します。

6. [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()

Linux エージェント

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

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

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

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

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

   エージェントが実行されていることも状態に示されていることが重要です。 そうではないと、エージェントを再構成するための次の手順は正常に完了しません。

2. エージェントがワークスペースに既に登録されている場合は、次のコマンドを実行して、登録されているワークスペースを削除します。 登録されていない場合は、次の手順に進みます。

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

3. 別のワークスペースに登録するには、次のコマンドを実行します。

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

4. 変更が有効になったことを確認するには、次のコマンドを実行します。

   /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 エージェントを使用します。

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

1. 管理者権限を持つアカウントでコンピューターにサインオンします。

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

3. [Microsoft Monitoring Agent] を選択し、[プロキシ設定] タブを選択します。

4. [プロキシ サーバーの使用] を選択し、プロキシ サーバーまたはゲートウェイの 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 アドレスを受け取ります。

1. 次のコマンドを実行してファイル /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
   

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

   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 エージェントを使用します。

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

1. 管理者権限を持つアカウントでコンピューターにサインオンします。

2. コントロール パネルで、[プログラムと機能] を選択します。

3. [プログラムと機能] で、[Microsoft Monitoring Agent]>[アンインストール]>[はい] を選択します。

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

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

1. 管理者権限を持つアカウントでコンピューターにサインオンします。

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

3. プロンプトで %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 エージェントを構成するには、次の手順を実行します。

1. 管理者権限を持つアカウントでコンピューターにサインオンします。

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

3. [Microsoft Monitoring Agent] を選択した後、[Operations Manager] タブを選択します。

4. Operations Manager サーバーが Active Directory と統合されている場合は、[管理グループの割り当てを AD DS から自動的に更新する] を選択します。

5. [追加] を選択して、[管理グループを追加する] ダイアログを開きます。

6. [管理グループ名] フィールドに、管理グループの名前を入力します。

7. [プライマリ管理サーバー] フィールドに、プライマリ管理サーバーのコンピューター名を入力します。

8. [管理サーバー ポート] フィールドに、TCP ポート番号を入力します。

9. [エージェント アクション アカウント] で、ローカル システム アカウントまたはローカル ドメイン アカウントのいずれかを選択します。

10. [OK] を選択して、[管理グループの追加] ダイアログを閉じます。 次に、[OK] を選択して、[Microsoft Monitoring Agent のプロパティ] ダイアログを閉じます。

Linux エージェント

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

1. ファイル /etc/opt/omi/conf/omiserver.conf を編集します。

2. httpsport= で始まる行にポート 1270 が定義されている (httpsport=1270 など) ことを確認します。

3. 次のコマンドを使用して、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 エージェントのトラブルシューティングに関する記事を参照してください。