Raccolta di origini dati JSON personalizzate con l'agente OMS per Linux in Log AnalyticsCollecting custom JSON data sources with the OMS Agent for Linux in Log Analytics

È possibile raccogliere origini dati JSON personalizzate in Log Analytics tramite l'agente OMS per Linux.Custom JSON data sources can be collected into Log Analytics using the OMS Agent for Linux. Queste origini dati personalizzate possono essere semplici script che restituiscono JSON, ad esempio curl, o uno degli oltre 300 plug-in di FluentD.These custom data sources can be simple scripts returning JSON such as curl or one of FluentD's 300+ plugins. Questo articolo descrive la configurazione necessaria per questa raccolta di dati.This article describes the configuration required for this data collection.

Nota

Per i dati JSON personalizzati è necessario l'agente OMS per Linux v1.1.0-217+OMS Agent for Linux v1.1.0-217+ is required for Custom JSON Data

ConfigurazioneConfiguration

Configurare il plug-in di inputConfigure input plugin

Per raccogliere dati JSON in Log Analytics, aggiungere oms.api. all'inizio di un tag FluentD in un plug-in di input.To collect JSON data in Log Analytics, add oms.api. to the start of a FluentD tag in an input plugin.

Di seguito, ad esempio, è riportato un file di configurazione separato exec-json.conf in /etc/opt/microsoft/omsagent/<workspace id>/conf/omsagent.d/.For example, following is a separate configuration file exec-json.conf in /etc/opt/microsoft/omsagent/<workspace id>/conf/omsagent.d/. Viene usato il plug-in FluentD exec per eseguire un comando curl ogni 30 secondi.This uses the FluentD plugin exec to run a curl command every 30 seconds. L'output di questo comando viene raccolto dal plug-in di output JSON.The output from this command is collected by the JSON output plugin.

<source>
  type exec
  command 'curl localhost/json.output'
  format json
  tag oms.api.httpresponse
  run_interval 30s
</source>

<match oms.api.httpresponse>
  type out_oms_api
  log_level info

  buffer_chunk_limit 5m
  buffer_type file
  buffer_path /var/opt/microsoft/omsagent/<workspace id>/state/out_oms_api_httpresponse*.buffer
  buffer_queue_limit 10
  flush_interval 20s
  retry_limit 10
  retry_wait 30s
</match>

Per il file di configurazione aggiunto in /etc/opt/microsoft/omsagent/<workspace id>/conf/omsagent.d/ sarà necessario modificare la proprietà con il comando seguente.The configuration file added under /etc/opt/microsoft/omsagent/<workspace id>/conf/omsagent.d/ will require to have its ownership changed with the following command.

sudo chown omsagent:omiusers /etc/opt/microsoft/omsagent/conf/omsagent.d/exec-json.conf

Configurare il plug-in di outputConfigure output plugin

Aggiungere la configurazione del plug-in di output seguente alla configurazione principale presente in /etc/opt/microsoft/omsagent/<workspace id>/conf/omsagent.conf o come un file di configurazione separato inserito in /etc/opt/microsoft/omsagent/<workspace id>/conf/omsagent.d/Add the following output plugin configuration to the main configuration in /etc/opt/microsoft/omsagent/<workspace id>/conf/omsagent.conf or as a separate configuration file placed in /etc/opt/microsoft/omsagent/<workspace id>/conf/omsagent.d/

<match oms.api.**>
  type out_oms_api
  log_level info

  buffer_chunk_limit 5m
  buffer_type file
  buffer_path /var/opt/microsoft/omsagent/<workspace id>/state/out_oms_api*.buffer
  buffer_queue_limit 10
  flush_interval 20s
  retry_limit 10
  retry_wait 30s
</match>

Riavviare l'agente OMS per LinuxRestart OMS Agent for Linux

Riavviare l'agente OMS per il servizio Linux con il comando seguente.Restart the OMS Agent for Linux service with the following command.

sudo /opt/microsoft/omsagent/bin/service_control restart 

OutputOutput

I dati verranno raccolti in Log Analytics con un record di tipo <FLUENTD_TAG>_CL.The data will be collected in Log Analytics with a record type of <FLUENTD_TAG>_CL.

Il tag personalizzato tag oms.api.tomcat in Log Analytics, ad esempio, viene raccolto con un record di tipo tomcat_CL.For example, the custom tag tag oms.api.tomcat in Log Analytics with a record type of tomcat_CL. È possibile recuperare tutti i record di questo tipo con la ricerca log seguente.You could retrieve all records of this type with the following log search.

Type=tomcat_CL

Sono supportate anche origini dati JSON annidate, che tuttavia vengono indicizzate in base al campo padre.Nested JSON data sources are supported, but are indexed based off of parent field. I dati JSON seguenti, ad esempio, vengono restituiti da una ricerca di Log Analytics come tag_s : "[{ "a":"1", "b":"2" }].For example, the following JSON data is returned from a Log Analytics search as tag_s : "[{ "a":"1", "b":"2" }].

{
    "tag": [{
        "a":"1",
        "b":"2"
    }]
}

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.