Log Analytics で Linux エージェント上の CollectD からデータを収集するCollect data from CollectD on Linux agents in Log Analytics

CollectD は、アプリケーションおよびシステム レベルの情報から定期的にパフォーマンス メトリックを収集するオープン ソースの Linux デーモンです。CollectD is an open source Linux daemon that periodically collects performance metrics from applications and system level information. アプリケーションの例には、Java 仮想マシン (JVM)、MySQL Server、および Nginx が含まれます。Example applications include the Java Virtual Machine (JVM), MySQL Server, and Nginx. この記事では、Log Analytics での CollectD からのパフォーマンス データの収集に関する情報を提供します。This article provides information on collecting performance data from CollectD in Log Analytics.

使用可能なプラグインの完全な一覧は、「プラグインの表」にあります。A full list of available plugins can be found at Table of Plugins.

CollectD の概要

次の CollectD 構成は、CollectD データを Linux 用 Log Analytics エージェントにルーティングするために、Linux 用 Log Analytics エージェントに含まれています。The following CollectD configuration is included in the Log Analytics agent for Linux to route CollectD data to the Log Analytics agent for Linux.

注意

現在 Microsoft Operations Management Suite (OMS) から Azure Monitor への移行作業が進行していますが、その一環として、OMS エージェント for Windows と OMS エージェント for Linux は、それぞれ Log Analytics エージェント for Windows および Log Analytics エージェント for Linux という名称になります。As part of the ongoing transition from Microsoft Operations Management Suite (OMS) to Azure Monitor, the OMS Agent for Windows or Linux will be referred to as the Log Analytics agent for Windows and Log Analytics agent for Linux.

LoadPlugin write_http

<Plugin write_http>
     <Node "oms">
     URL "127.0.0.1:26000/oms.collectd"
     Format "JSON"
     StoreRates true
     </Node>
</Plugin>

さらに、5.5 より前の CollectD のバージョンを使用している場合は、代わりに次の構成を使用します。Additionally, if using an versions of collectD before 5.5 use the following configuration instead.

LoadPlugin write_http

<Plugin write_http>
   <URL "127.0.0.1:26000/oms.collectd">
    Format "JSON"
     StoreRates true
   </URL>
</Plugin>

CollectD 構成では、既定の write_http プラグインを使用して、パフォーマンス メトリック データをポート 26000 経由で Linux 用 Log Analytics エージェントに送信します。The CollectD configuration uses the defaultwrite_http plugin to send performance metric data over port 26000 to Log Analytics agent for Linux.

注意

このポートは、必要に応じてカスタム定義のポートに構成できます。This port can be configured to a custom-defined port if needed.

また、Linux 用 Log Analytics エージェントは、CollectD メトリックのためにポート 26000 をリッスンし、それらを Log Analytics スキーマ メトリックに変換します。The Log Analytics agent for Linux also listens on port 26000 for CollectD metrics and then converts them to Log Analytics schema metrics. Linux 用 Log Analytics エージェントの構成 collectd.conf を次に示します。The following is the Log Analytics agent for Linux configuration collectd.conf.

<source>
  type http
  port 26000
  bind 127.0.0.1
</source>

<filter oms.collectd>
  type filter_collectd
</filter>

サポートされているバージョンVersions supported

  • Log Analytics は現在、CollectD バージョン 4.8 以降をサポートしています。Log Analytics currently supports CollectD version 4.8 and above.
  • CollectD メトリックの収集には Linux 用 Log Analytics エージェント v1.1.0-217 以降が必要です。Log Analytics agent for Linux v1.1.0-217 or above is required for CollectD metric collection.

構成Configuration

Log Analytics での CollectD データの収集を構成するための基本的な手順を次に示します。The following are basic steps to configure collection of CollectD data in Log Analytics.

  1. write_http プラグインを使用してデータを Linux 用 Log Analytics エージェントに送信するように CollectD を構成します。Configure CollectD to send data to the Log Analytics agent for Linux using the write_http plugin.
  2. 適切なポート上で CollectD データをリッスンするように Linux 用 Log Analytics エージェントを構成します。Configure the Log Analytics agent for Linux to listen for the CollectD data on the appropriate port.
  3. CollectD と Linux 用 Log Analytics エージェントを再起動します。Restart CollectD and Log Analytics agent for Linux.

データを転送するように CollectD を構成するConfigure CollectD to forward data

  1. CollectD データを Linux 用 Log Analytics エージェントにルーティングするには、CollectD の構成ディレクトリに oms.conf を追加する必要があります。To route CollectD data to the Log Analytics agent for Linux, oms.conf needs to be added to CollectD's configuration directory. このファイルの移動先は、使用しているマシンの Linux ディストリビューションによって異なります。The destination of this file depends on the Linux distro of your machine.

    CollectD config ディレクトリが /etc/collectd.d/ に配置されている場合:If your CollectD config directory is located in /etc/collectd.d/:

     sudo cp /etc/opt/microsoft/omsagent/sysconf/omsagent.d/oms.conf /etc/collectd.d/oms.conf
    

    CollectD config ディレクトリが /etc/collectd/collectd.conf.d/ に配置されている場合:If your CollectD config directory is located in /etc/collectd/collectd.conf.d/:

     sudo cp /etc/opt/microsoft/omsagent/sysconf/omsagent.d/oms.conf /etc/collectd/collectd.conf.d/oms.conf
    

    注意

    5.5 より前の CollectD バージョンでは、上に示すように oms.conf 内のタグを変更する必要があります。For CollectD versions before 5.5 you will have to modify the tags in oms.conf as shown above.

  2. collectd.conf を目的のワークスペースの omsagent 構成ディレクトリにコピーします。Copy collectd.conf to the desired workspace's omsagent configuration directory.

     sudo cp /etc/opt/microsoft/omsagent/sysconf/omsagent.d/collectd.conf /etc/opt/microsoft/omsagent/<workspace id>/conf/omsagent.d/
     sudo chown omsagent:omiusers /etc/opt/microsoft/omsagent/<workspace id>/conf/omsagent.d/collectd.conf
    
  3. 次のコマンドを使用して、CollectD と Linux 用 Log Analytics エージェントを再起動します。Restart CollectD and Log Analytics agent for Linux with the following commands.

    sudo service collectd restart sudo /opt/microsoft/omsagent/bin/service_control restartsudo service collectd restart sudo /opt/microsoft/omsagent/bin/service_control restart

CollectD メトリックから Log Analytics スキーマへの変換CollectD metrics to Log Analytics schema conversion

既に Linux 用 Log Analytics エージェントによって収集されたインフラストラクチャ メトリックと、CollectD によって収集された新しいメトリックの間で使い慣れたモデルを維持するために、次のスキーマ マッピングが使用されます。To maintain a familiar model between infrastructure metrics already collected by Log Analytics agent for Linux and the new metrics collected by CollectD the following schema mapping is used:

CollectD メトリックのフィールドCollectD Metric field Log Analytics のフィールドLog Analytics field
hosthost ComputerComputer
プラグインplugin なしNone
plugin_instanceplugin_instance インスタンス名Instance Name
plugin_instancenull である場合、InstanceName="_Total"If plugin_instance is null then InstanceName="_Total"
typetype ObjectNameObjectName
type_instancetype_instance CounterNameCounterName
type_instancenull である場合、CounterName=blankIf type_instance is null then CounterName=blank
dsnames[]dsnames[] CounterNameCounterName
dstypesdstypes なしNone
values[]values[] CounterValueCounterValue

次の手順Next steps

  • ログ検索 について学習し、データ ソースとソリューションから収集されたデータを分析します。Learn about log searches to analyze the data collected from data sources and solutions.
  • カスタム フィールド を使用して、syslog レコードのデータを個別のフィールドに解析します。Use Custom Fields to parse data from syslog records into individual fields.