Raccogliere dati da CollectD su agenti Linux in Log AnalyticsCollect data from CollectD on Linux agents in Log Analytics

CollectD è un daemon Linux open source che, a intervalli regolari, raccoglie metriche sulle prestazioni dalle applicazioni e informazioni a livello di sistema.CollectD is an open source Linux daemon that periodically collects performance metrics from applications and system level information. Applicazioni di esempio includono Java Virtual Machine (JVM), MySQL Server e Nginx.Example applications include the Java Virtual Machine (JVM), MySQL Server, and Nginx. Questo articolo fornisce informazioni sulla raccolta di dati sulle prestazioni da CollectD in Log Analytics.This article provides information on collecting performance data from CollectD in Log Analytics.

Un elenco completo dei plug-in disponibili è contenuto nella Tabella dei plug-in.A full list of available plugins can be found at Table of Plugins.

Panoramica di CollectD

Nell'agente OMS per Linux è inclusa la configurazione di CollectD seguente per indirizzare dati CollectD all'agente OMS per Linux.The following CollectD configuration is included in the OMS Agent for Linux to route CollectD data to the OMS 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>

Se si usa una versione di CollectD precedente a 5.5, adottare invece la configurazione seguente.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>

La configurazione di CollectD usa il plug-in predefinito write_http per inviare dati delle metriche sulle prestazioni all'agente OMS per Linux tramite la porta 26000.The CollectD configuration uses the defaultwrite_http plugin to send performance metric data over port 26000 to OMS Agent for Linux.

Nota

Se necessario, questa porta può essere configurata su una porta personalizzata.This port can be configured to a custom-defined port if needed.

L'agente OMS per Linux resta in ascolto delle metriche di CollectD sulla porta 26000 e le converte anche in metriche per lo schema OMS.The OMS Agent for Linux also listens on port 26000 for CollectD metrics and then converts them to OMS schema metrics. Di seguito è illustrata la configurazione dell'agente OMS per Linux collectd.conf.The following is the OMS Agent for Linux configuration collectd.conf.

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

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

Versioni supportateVersions supported

  • Log Analytics supporta attualmente CollectD versione 4.8 e versioni successive.Log Analytics currently supports CollectD version 4.8 and above.
  • Per la raccolta di metriche CollectD è necessario l'agente OMS per Linux v1.1.0-217 o versione successiva.OMS Agent for Linux v1.1.0-217 or above is required for CollectD metric collection.

ConfigurazioneConfiguration

Di seguito è riportata la procedura di base per configurare la raccolta di dati CollectD in Log Analytics.The following are basic steps to configure collection of CollectD data in Log Analytics.

  1. Configurare CollectD per l'invio di dati all'agente OMS per Linux con il plug-in write_http.Configure CollectD to send data to the OMS Agent for Linux using the write_http plugin.
  2. Configurare l'agente OMS per Linux restare in ascolto dei dati di CollectD sulla porta appropriata.Configure the OMS Agent for Linux to listen for the CollectD data on the appropriate port.
  3. Riavviare CollectD e l'agente OMS per Linux.Restart CollectD and OMS Agent for Linux.

Configurare CollectD per l'inoltro di datiConfigure CollectD to forward data

  1. Per indirizzare dati di CollectD all'agente OMS per Linux, è necessario che oms.conf sia stato aggiunto alla directory di configurazione di CollectD.To route CollectD data to the OMS Agent for Linux, oms.conf needs to be added to CollectD's configuration directory. La destinazione di questo file dipende dalla distribuzione di Linux presente sul computer.The destination of this file depends on the Linux distro of your machine.

    Se la directory di configurazione di CollectD si trova in /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
    

    Se la directory di configurazione di CollectD si trova in /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
    

    Nota

    Per versioni di CollectD antecedenti a 5.5, è necessario modificare i tag in oms.conf, come illustrato in precedenza.For CollectD versions before 5.5 you will have to modify the tags in oms.conf as shown above.

  2. Copiare collectd.conf nella directory di configurazione di omsagent dell'area di lavoro desiderata.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. Riavviare CollectD e l'agente OMS per Linux con i comandi seguenti.Restart CollectD and OMS 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

Conversione dello schema di metriche di CollectD nello schema di Log AnalyticsCollectD metrics to Log Analytics schema conversion

Per mantenere un modello comune tra le metriche dell'infrastruttura già raccolte dall'agente OMS per Linux e le nuove metriche raccolte da CollectD, viene usato lo schema di mapping seguente:To maintain a familiar model between infrastructure metrics already collected by OMS Agent for Linux and the new metrics collected by CollectD the following schema mapping is used:

Campo metrica CollectDCollectD Metric field Campo Log AnalyticsLog Analytics field
hosthost ComputerComputer
pluginplugin NessunoNone
plugin_instanceplugin_instance Nome dell'istanzaInstance Name
Se plugin_instance è null, InstanceName="_Total"If plugin_instance is null then InstanceName="_Total"
typetype ObjectNameObjectName
type_instancetype_instance CounterNameCounterName
Se type_instance è null, CounterName=blankIf type_instance is null then CounterName=blank
dsnames[]dsnames[] CounterNameCounterName
dstypesdstypes NessunoNone
values[]values[] CounterValueCounterValue

Passaggi successiviNext steps

  • Informazioni sulle ricerche nei log per analizzare i dati raccolti dalle origini dati e dalle soluzioni.Learn about log searches to analyze the data collected from data sources and solutions.
  • Usare campi personalizzati per analizzare i dati dei record Syslog nei singoli campi.Use Custom Fields to parse data from syslog records into individual fields.