Windows および Linux 用の Log Analytics エージェントを管理および管理する

Azure Monitor で Log Analytics Windows または Linux エージェントを最初にデプロイした後、エージェントのライフサイクルの提供終了ステージに達した場合は、エージェントの再構成、アップグレード、またはコンピューターからの削除が必要になる場合があります。 これらの日常的なメンテナンス タスクは、手動または自動化を使用して簡単に管理できるため、運用エラーと経費の両方を削減できます。

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

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

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

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

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

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

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

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

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

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

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

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

2. MMASetup-<platform>.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 Cloud ドロップダウン リストから Azure US Government を選択します。

6. [OK] を選択して変更を保存します。

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

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

PowerShell を使用して Azure Commercial にワークスペースを追加する

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

PowerShell を使用して Azure for 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 エージェント

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が表示された場合は、'\n' EOF のproxy.confを削除してエラーを解決してみてください。

   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>Uninstall>Yes] を選択します。

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

エージェントのダウンロードしたファイルは、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 エージェントのトラブルシューティングを確認してください。