Recolher origens de dados JSON personalizadas com o agente do Log Analytics para Linux no Azure Monitor

Artigo
06/02/2023

Nota

Como parte da transição em curso do Microsoft Operations Management Suite para o Azure Monitor, o Agente Operations Management Suite para Windows ou Linux será referido como o agente Log Analytics para Windows e agente Log Analytics para Linux.

As origens de dados JSON personalizadas podem ser recolhidas no Azure Monitor com o agente do Log Analytics para Linux. Estas origens de dados personalizadas podem ser scripts simples que devolvem JSON, como curl ou um dos mais de 300 plug-ins da FluentD. Este artigo descreve a configuração necessária para esta recolha de dados.

Nota

O agente do Log Analytics para Linux v1.1.0-217+ é necessário para Dados JSON Personalizados. Este fluxo de coleção só funciona com MMA. Considere mudar para o agente AMA e utilizar as funcionalidades de coleção adicionais disponíveis

Configuração

Configurar o plug-in de entrada

Para recolher dados JSON no Azure Monitor, adicione oms.api. ao início de uma etiqueta FluentD num plug-in de entrada.

Por exemplo, segue-se um ficheiro exec-json.conf de configuração separado no /etc/opt/microsoft/omsagent/<workspace id>/conf/omsagent.d/. Isto utiliza o plug-in exec FluentD para executar um comando curl a cada 30 segundos. O resultado deste comando é recolhido pelo plug-in de saída JSON.

<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>

O ficheiro de configuração adicionado /etc/opt/microsoft/omsagent/<workspace id>/conf/omsagent.d/ em exigirá que a respetiva propriedade seja alterada com o seguinte comando.

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

Configurar o plug-in de saída

Adicione a seguinte configuração do plug-in de saída à configuração principal no /etc/opt/microsoft/omsagent/<workspace id>/conf/omsagent.conf ou como um ficheiro de configuração separado colocado no /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>

Reiniciar o agente do Log Analytics para Linux

Reinicie o agente do Log Analytics para o serviço Linux com o seguinte comando.

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

Saída

Os dados serão recolhidos no Azure Monitor com um tipo de registo de <FLUENTD_TAG>_CL.

Por exemplo, a etiqueta tag oms.api.tomcat personalizada no Azure Monitor com um tipo de registo de tomcat_CL. Pode obter todos os registos deste tipo com a seguinte consulta de registo.

Type=tomcat_CL

As origens de dados JSON aninhadas são suportadas, mas são indexadas com base no campo principal. Por exemplo, os seguintes dados JSON são devolvidos de uma consulta de registo como tag_s : "[{ "a":"1", "b":"2" }].

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

Passos seguintes

Saiba mais sobre as consultas de registo para analisar os dados recolhidos a partir de origens de dados e soluções.

Share via