Windows コンピューターを Azure の Log Analytics サービスに接続するConnect Windows computers to the Log Analytics service in Azure

Log Analytics を使用して、ローカル データ センターやその他のクラウド環境内にある仮想マシンや物理コンピューターを監視、および管理するには、Microsoft Monitoring Agent (MMA) をデプロイし、1 つ以上の Log Analytics ワークスペースにレポートを送信するように構成する必要があります。In order to monitor and manage virtual machines or physical computers in your local datacenter or other cloud environment with Log Analytics, you need to deploy the Microsoft Monitoring Agent (MMA) and configure it to report to one or more Log Analytics workspaces. エージェントでは、Azure Automation 用の Hybrid Runbook Worker ロールもサポートされます。The agent also supports the Hybrid Runbook Worker role for Azure Automation.

監視対象の Windows コンピューターでは、エージェントは Microsoft Monitoring Agent サービスとしてリストされます。On a monitored Windows computer, the agent is listed as the Microsoft Monitoring Agent service. Microsoft Monitoring Agent サービスは、ログ ファイル、Windows イベント ログ、パフォーマンス データ、およびその他のテレメトリからイベントを収集します。The Microsoft Monitoring Agent service collects events from log files and Windows event log, performance data, and other telemetry. エージェントは、レポート送信先の Log Analytics サービスと通信できないときにも常時実行され、収集したデータを監視対象コンピューターのディスク キューに配置します。Even when the agent is unable to communicate with the Log Analytics service it reports to, the agent continues to run and queues the collected data on the disk of the monitored computer. 接続が復元されると、Microsoft Monitoring Agent サービスは収集したデータをサービスに送信します。When the connection is restored, the Microsoft Monitoring Agent service sends collected data to the service.

エージェントは、次のいずれかの方法を使用してインストールされます。The agent may be installed by using one of the following methods. 多くの場合は、これらのメソッドを必要に応じて組み合わせて使用し、さまざまなコンピューターをインストールします。Most installations use a combination of these methods to install different sets of computers, as appropriate. 各メソッドの使い方の詳細については、記事の後半で説明します。Details on using each method are provided later in the article.

  • 手動インストール。Manual installation. セットアップ ウィザード、コマンドライン、または既存のソフトウェア配布ツールを使用して、コンピューター上でセットアップを手動で実行します。Setup is manually run on the computer using the setup wizard, from the command line, or deployed using an existing software distribution tool.
  • Azure Automation Desired State Configuration (DSC)。Azure Automation Desired State Configuration (DSC). Azure Automation 内の DSC と、環境内に既にデプロイされている Windows コンピューター用のスクリプトを使用します。Using DSC in Azure Automation with a script for Windows computers already deployed in your environment.
  • PowerShell スクリプト。PowerShell script.
  • Azure Stack 内のオンプレミスで Windows を実行している仮想マシン用の、Resource Manager テンプレート。Resource Manager template for virtual machines running Windows on-premises in Azure Stack.

サポートされている構成を確認するには、「サポートされている Windows オペレーティング システム」と「ネットワーク ファイアウォールの構成」をご覧ください。To understand the supported configuration, review supported Windows operating systems and network firewall configuration.

ワークスペース ID とキーを取得するObtain workspace ID and key

Microsoft Monitoring Agent for Windows をインストールする前に、Log Analytics ワークスペースのワークスペース ID とキーが必要です。Before installing the Microsoft Monitoring Agent for Windows, you need the workspace ID and key for your Log Analytics workspace. この情報は、各インストール方法を通じたセットアップ時に、エージェントを適切に構成し、そのエージェントが Azure の商用クラウドや米国政府機関向けクラウド内にある Log Analytics と正常に通信できるようにするために必要です。This information is required during setup from each installation method to properly configure the agent and ensure it can successfully communicate with Log Analytics in Azure commercial and US Government cloud.

  1. 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.
  2. Log Analytics ワークスペースの一覧で、エージェントのレポート送信先にするワークスペースを選択します。In your list of Log Analytics workspaces, select the workspace you intend on configuring the agent to report to.
  3. [詳細設定] を選択します。Select Advanced settings.

    Log Analytics の詳細設定Log Analytics Advance Settings

  4. [接続されたソース][Windows サーバー] の順に選択します。Select Connected Sources, and then select Windows Servers.
  5. ワークスペース ID主キーをコピーして、好みのエディターに貼り付けます。Copy and paste into your favorite editor, the Workspace ID and Primary Key.

セットアップ ウィザードを使用してエージェントをインストールするInstall the agent using setup wizard

次の手順では、コンピューター上の Microsoft Monitoring Agent 用のセットアップ ウィザードを使用して、Azure クラウドと Azure Government クラウド内にある Log Analytics 用のエージェントをインストールし、構成します。The following steps install and configure the agent for Log Analytics in Azure and Azure Government cloud by using the setup wizard for the Microsoft Monitoring Agent on your computer.

  1. Log Analyics ワークスペースで、先の手順で移動した [Windows サーバー] ページの [Windows エージェントのダウンロード] から、Windows オペレーティング システムのプロセッサ アーキテクチャに応じた適切なバージョンを選択します。In your Log Analyics workspace, from the Windows Servers page you navigated to earlier, select the appropriate Download Windows Agent version to download depending on the processor architecture of the Windows operating system.
  2. セットアップを実行して、コンピューターにエージェントをインストールします。Run Setup to install the agent on your computer.
  3. [ようこそ] ページで [次へ] をクリックします。On the Welcome page, click Next.
  4. [ライセンス条項] ページの記述内容を確認し、[同意する] をクリックします。On the License Terms page, read the license and then click I Agree.
  5. [インストール先フォルダー] ページで、既定のインストール フォルダーを変更するか、変更せずに [次へ] をクリックします。On the Destination Folder page, change or keep the default installation folder and then click Next.
  6. [エージェントのセットアップ オプション] ページで、エージェントを接続する Azure Log Analytics をクリックし、[次へ] をクリックします。On the Agent Setup Options page, choose to connect the agent to Azure Log Analytics and then click Next.
  7. [Azure Log Analytics] ページで、次の手順を実行します。On the Azure Log Analytics page, perform the following:
    1. [ワークスペース ID][ワークスペース キー (主キー)] に、先ほどコピーした値を貼り付けます。Paste the Workspace ID and Workspace Key (Primary Key) that you copied earlier. コンピューターが 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.
    2. コンピューターがプロキシ サーバーを介して Log Analytics サービスと通信する必要がある場合は、[詳細] をクリックし、プロキシ サーバーの URL とポート番号を指定します。If the computer needs to communicate through a proxy server to the Log Analytics service, click Advanced and provide the URL and port number of the proxy server. プロキシ サーバーで認証が必要な場合には、プロキシ サーバーにアクセスするためのユーザー名とパスワードを入力し、[次へ] をクリックします。If your proxy server requires authentication, type the username and password to authenticate with the proxy server and then click Next.
  8. 必要な構成設定をしたら、[次へ] をクリックします。Click Next once you have completed providing the necessary configuration settings.

    ワークスペース ID と主キーの貼り付けpaste Workspace ID and Primary Key

  9. [インストールの準備完了] ページで、設定内容を確認し、[インストール] をクリックします。On the Ready to Install page, review your choices and then click Install.
  10. [構成は正常に終了しました] ページで [完了] をクリックします。On the Configuration completed successfully page, click Finish.

完了すると、コントロール パネルMicrosoft Monitoring Agent が表示されます。When complete, the Microsoft Monitoring Agent appears in Control Panel. Log Analytics にレポートが送信されていることを確認する方法については、「Log Analytics へのエージェント接続を確認する」をご覧ください。To confirm it is reporting to Log Analytics, review Verify agent connectivity to Log Analytics.

コマンド ラインを使用してエージェントをインストールするInstall the agent using the command line

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

注意

エージェントをアップグレードするには、Log Analytics スクリプト API を使用する必要があります。If you want to upgrade an agent, you need to use the Log Analytics scripting API. 詳しくは、「Windows および Linux での Log Analytics エージェントの管理とメンテナンス」をご覧ください。See the topic Managing and maintaining the Log Analytics agent for Windows and Linux for further information.

次の表は、エージェントのセットアップ (Automation DSC を使用してデプロイする場合を含む) でサポートされる、Log Analytics パラメーターを示したものです。The following table highlights the specific Log Analytics parameters supported by setup for the agent, including when deployed using Automation DSC.

MMA 固有のオプションMMA-specific options メモNotes
NOAPM=1NOAPM=1 省略可能なパラメーター。Optional parameter. .NET アプリケーション パフォーマンス監視なしでエージェントをインストールします。Installs the agent without .NET Application Performance Monitoring.
ADD_OPINSIGHTS_WORKSPACEADD_OPINSIGHTS_WORKSPACE 1 = ワークスペースに報告するようにエージェントを構成します1 = Configure the agent to report to a workspace
OPINSIGHTS_WORKSPACE_IDOPINSIGHTS_WORKSPACE_ID 追加するワークスペースのワークスペース ID (guid)Workspace Id (guid) for the workspace to add
OPINSIGHTS_WORKSPACE_KEYOPINSIGHTS_WORKSPACE_KEY ワークスペースで最初に認証するために使用するワークスペース キーWorkspace key used to initially authenticate with the workspace
OPINSIGHTS_WORKSPACE_AZURE_CLOUD_TYPEOPINSIGHTS_WORKSPACE_AZURE_CLOUD_TYPE ワークスペースが配置されるクラウド環境を指定しますSpecify the cloud environment where the workspace is located
0 = Azure 商用クラウド (既定値)0 = Azure commercial cloud (default)
1 = Azure Government1 = Azure Government
OPINSIGHTS_PROXY_URLOPINSIGHTS_PROXY_URL プロキシで使用される URIURI for the proxy to use
OPINSIGHTS_PROXY_USERNAMEOPINSIGHTS_PROXY_USERNAME 認証済みのプロキシにアクセスするためのユーザー名Username to access an authenticated proxy
OPINSIGHTS_PROXY_PASSWORDOPINSIGHTS_PROXY_PASSWORD 認証済みのプロキシにアクセスするためのパスワードPassword to access an authenticated proxy
  1. 管理者特権でのコマンド プロンプトからエージェント インストール ファイルを抽出するには、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:<Path> 引数を渡すことでパスを指定することもできます。Alternatively, you can specify the path by passing the arguments MMASetup-<platform>.exe /c /t:<Path>.
  2. エージェントをサイレント モードでインストールし、Azure の商用クラウド内のワークスペースにレポートを送信するように構成するには、セットアップ ファイルを抽出したフォルダーから、次のコマンドを入力します。To silently install the agent and configure it to report to a workspace in Azure commercial cloud, from the folder you extracted the setup files to type:

    setup.exe /qn NOAPM=1 ADD_OPINSIGHTS_WORKSPACE=1 OPINSIGHTS_WORKSPACE_AZURE_CLOUD_TYPE=0 OPINSIGHTS_WORKSPACE_ID=<your workspace id> OPINSIGHTS_WORKSPACE_KEY=<your workspace key> AcceptEndUserLicenseAgreement=1
    

    Azure の米国政府機関向けクラウドをエージェントのレポート送信先として構成するには、次のコマンドを入力します。or to configure the agent to report to Azure US Government cloud, type:

    setup.exe /qn NOAPM=1 ADD_OPINSIGHTS_WORKSPACE=1 OPINSIGHTS_WORKSPACE_AZURE_CLOUD_TYPE=1 OPINSIGHTS_WORKSPACE_ID=<your workspace id> OPINSIGHTS_WORKSPACE_KEY=<your workspace key> AcceptEndUserLicenseAgreement=1
    

Azure Automation の DSC を使用してエージェントをインストールするInstall the agent using DSC in Azure Automation

次のサンプル スクリプトを使用して、Azure Automation の DSC を使用するエージェントをインストールできます。You can use the following script example to install the agent using Azure Automation DSC. Automation アカウントがない場合は、「Azure Automation の概要」を参照して、Automation DSC を使用する前に必要な Automation アカウントを作成するための要件と手順を確認してください。If you do not have an Automation account, see Get started with Azure Automation to understand requirements and steps for creating an Automation account required before using Automation DSC. Automation DSC のことをよく知らない場合は、「Azure Automation DSC の使用」をご覧ください。If you are not familiar with Automation DSC, review Getting started with Automation DSC.

次のサンプルは、URI 値によって識別される 64 ビット エージェントをインストールします。The following example installs the 64-bit agent, identified by the URI value. URI 値を置き換えることで、32 ビット バージョンを使用することもできます。You can also use the 32-bit version by replacing the URI value. 両方のバージョンの URI は次のとおりです。The URIs for both versions are:

注意

この手順とサンプル スクリプトでは、Windows コンピューターに既にデプロイされているエージェントのアップグレードはサポートされていません。This procedure and script example does not support upgrading the agent already deployed to a Windows computer.

32 ビット バージョンと 64 ビット バージョンのエージェント パッケージには、それぞれ異なる製品コードがあり、リリースされる新バージョンにも、それぞれ一意の値が指定されます。The 32-bit and 64-bit versions of the agent package have different product codes and new versions released also have a unique value. 製品コードは、アプリケーションや製品の主要な識別情報となる GUID であり、Windows インストーラーの ProductCode プロパティによって表されます。The product code is a GUID that is the principal identification of an application or product and is represented by the Windows Installer ProductCode property. MMAgent.ps1 スクリプトの ProductId 値は、32 ビットまたは 64 ビットのエージェント インストーラー パッケージの製品コードと一致する必要があります。The ProductId value in the MMAgent.ps1 script has to match the product code from the 32-bit or 64-bit agent installer package.

製品コードをエージェント インストール パッケージから直接取得するには、Windows ソフトウェア開発キットのコンポーネントである Windows SDK Components for Windows Installer Developers (Windows インストーラー開発者向け Windows SDK コンポーネント) に含まれている、Orca.exe を使用するか、Microsoft Valuable Professional (MVP) によって記述されたサンプル スクリプトに従った、PowerShell を使用できます。To retrieve the product code from the agent install package directly, you can use Orca.exe from the Windows SDK Components for Windows Installer Developers that is a component of the Windows Software Development Kit or using PowerShell following an example script written by a Microsoft Valuable Professional (MVP). どちらの方法でも、まず、MMASetup インストール パッケージから MOMagent.msi ファイルを抽出する必要があります。For either approach, you first need to extract the MOMagent.msi file from the MMASetup installation package. これについては、前のセクション「コマンド ラインを使用してエージェントをインストールする」の最初の手順で説明しています。This is shown earlier in the first step under the section Install the agent using the command line.

  1. http://www.powershellgallery.com/packages/xPSDesiredStateConfiguration から Azure Automation に xPSDesiredStateConfiguration DSC モジュールをインポートします。Import the xPSDesiredStateConfiguration DSC Module from http://www.powershellgallery.com/packages/xPSDesiredStateConfiguration into Azure Automation.
  2. OPSINSIGHTS_WS_IDOPSINSIGHTS_WS_KEY に対して Azure Automation 変数アセットを作成します。Create Azure Automation variable assets for OPSINSIGHTS_WS_ID and OPSINSIGHTS_WS_KEY. OPSINSIGHTS_WS_ID を Log Analytics ワークスペース ID に設定し、OPSINSIGHTS_WS_KEY をワークスペースの主キーに設定します。Set OPSINSIGHTS_WS_ID to your Log Analytics workspace ID and set OPSINSIGHTS_WS_KEY to the primary key of your workspace.
  3. スクリプトをコピーし、MMAgent.ps1 として保存します。Copy the script and save it as MMAgent.ps1.

    Configuration MMAgent
    {
        $OIPackageLocalPath = "C:\Deploy\MMASetup-AMD64.exe"
        $OPSINSIGHTS_WS_ID = Get-AutomationVariable -Name "OPSINSIGHTS_WS_ID"
        $OPSINSIGHTS_WS_KEY = Get-AutomationVariable -Name "OPSINSIGHTS_WS_KEY"
    
        Import-DscResource -ModuleName xPSDesiredStateConfiguration
        Import-DscResource -ModuleName PSDesiredStateConfiguration
    
        Node OMSnode {
            Service OIService
            {
                Name = "HealthService"
                State = "Running"
                DependsOn = "[Package]OI"
            }
    
            xRemoteFile OIPackage {
                Uri = "https://go.microsoft.com/fwlink/?LinkId=828603"
                DestinationPath = $OIPackageLocalPath
            }
    
            Package OI {
                Ensure = "Present"
                Path  = $OIPackageLocalPath
                Name = "Microsoft Monitoring Agent"
                ProductId = "8A7F2C51-4C7D-4BFD-9014-91D11F24AAE2"
                Arguments = '/C:"setup.exe /qn NOAPM=1 ADD_OPINSIGHTS_WORKSPACE=1 OPINSIGHTS_WORKSPACE_ID=' + $OPSINSIGHTS_WS_ID + ' OPINSIGHTS_WORKSPACE_KEY=' + $OPSINSIGHTS_WS_KEY + ' AcceptEndUserLicenseAgreement=1"'
                DependsOn = "[xRemoteFile]OIPackage"
            }
        }
    }
    
  4. スクリプトの ProductId 値を更新します。先ほど提示した方法を使用して最新バージョンのエージェント インストール パッケージから抽出した製品コードに置き換えてください。Update the ProductId value in the script with the product code extracted from the latest version of the agent install package using the methods recommended earlier.

  5. Automation アカウントに MMAgent.ps1 構成スクリプトをインポートします。Import the MMAgent.ps1 configuration script into your Automation account.
  6. 構成に、Windows コンピューターまたはノードに割り当てます。Assign a Windows computer or node to the configuration. 15 分以内に、ノードはその構成を確認し、エージェントがノードにプッシュされます。Within 15 minutes, the node checks its configuration and the agent is pushed to the node.

Log Analytics へのエージェント接続を確認するVerify agent connectivity to Log Analytics

エージェントのインストールが完了した後、エージェントが正常に接続され、レポートが送信されていることを確認するには、次の 2 つの方法があります。Once installation of the agent is complete, verifying it is successfully connected and reporting can be accomplished in two ways.

[コントロール パネル] 内のコンピューターから、[Microsoft Monitoring Agent] という項目を見つけます。From the computer in Control Panel, find the item Microsoft Monitoring Agent. これを選択すると、[Azure Log Analytics] タブに、Microsoft Monitoring Agent が Microsoft Operations Management Suite サービスに正常に接続していることを示すメッセージが表示されます。Select it and on the Azure Log Analytics tab, the agent should display a message stating: The Microsoft Monitoring Agent has successfully connected to the Microsoft Operations Management Suite service.

Log Analytics への MMA 接続の状態MMA connection status to Log Analytics

また、Azure ポータルで簡単なログ検索を行うこともできます。You can also perform a simple log search in the Azure portal.

  1. 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.
  2. Log Analytics ワークスペース ページで、ターゲット ワークスペースを選択して [ログ検索] タイルを選択します。On the Log Analytics workspace page, select the target workspace and then select the Log Search tile.
  3. [ログ検索] ウィンドウのクエリ フィールドで、次のように入力します。On the Log Search pane, in the query field type:

    search * 
    | where Type == "Heartbeat" 
    | where Category == "Direct Agent" 
    | where TimeGenerated > ago(30m)  
    

検索結果には、コンピューターのハートビート レコードが表示されます。これにより、エージェントがサービスに接続され、レポートが送信されていることが示されます。In the search results returned, you should see heartbeat records for the computer indicating it is connected and reporting to the service.

次の手順Next steps

マシンへのデプロイ ライフ サイクル中にエージェントを管理する方法については、「Windows および Linux での Log Analytics エージェントの管理とメンテナンス」をご覧ください。Review Managing and maintaining the Log Analytics agent for Windows and Linux to learn about how to manage the agent during its deployment lifecycle on your machines.