Scripts personalizados em servidores físicos

Você pode executar scripts personalizados em servidores físicos e coletar dados personalizados que podem ser consumidos como uma métrica.

Pré-requisitos

• Todos os scripts executados usando o script personalizado devem gerar um único valor inteiro.
• O script personalizado usa o plug-in exec do Telegraf para executar scripts no sistema operacional de uma VM de endpoint. Os scripts são executados pelo usuário que instalou o agente Telegraf em um sistema operacional. Certifique-se de que o usuário possa executar o script personalizado.

Procedimento

1. Atualize a configuração do Telegraf no servidor físico de destino após executar o script de exemplo. Adicione o seguinte no arquivo http.conf.
   Observação: Atualize as informações em "<>" com precisão.

   [[inputs.exec]]
   
   name_prefix = "executescript."
   name_override = "output"
   commands = ["<prefix> <script path which should be run> <argument>"]
   data_format = "value"
   data_type = "integer"
   timeout = "300s"
   
   [inputs.exec.tags]
   file_path = "script path which should be run"
   script_name = "<custom_script_name> on <hostname>"

   Exemplos (Examples)

   • Por exemplo, no caso de um Windows Server, adicione powershell -File como um prefixo na frente do script. O caminho do script que deve ser executado é o script personalizado que você deseja executar no servidor físico. WIN-3VI8MSB5B5D é o valor da propriedade hostname mencionado no arquivo http.conf. Memory.ps1 em WIN-3VI8MSB5B5D é o nome da métrica que será coletado no objeto Script Personalizado (Custom Script). Aqui está o exemplo:

     [[inputs.exec]]
     
     name_prefix = "executescript."
     name_override = "output"
     commands = ["powershell -File C:\\\\opt\\\\Scripts\\\\Memory.ps1"]
     data_format = "value"
     data_type = "integer"
     timeout = "300s"
     
     [inputs.exec.tags]
     file_path = "C:\\opt\\Scripts\\Memory.ps1"
     script_name = "Memory.ps1 on WIN-3VI8MSB5B5D"

   • Por exemplo, no caso de um servidor Linux, você pode adicionar python2.7, /bin/bash ou perl, etc. como possíveis prefixos para o roteiro. O caminho do script que deve ser executado é o script personalizado que você deseja executar no servidor físico. OEL7-OpenSourceTelegraf é o valor da propriedade hostname mencionado no arquivo http.conf. argument.py em OEL7-OpenSourceTelegraf é o nome da métrica que será coletado no objeto Script Personalizado (Custom Script). Aqui está o exemplo:

     [[inputs.exec]]
     
     name_prefix = "executescript."
     commands = ["python2.7 /opt/scripts/python/argument.py 100"]
     data_format = "value"
     data_type = "integer"
     timeout = "300s"
     
     [inputs.exec.tags]
     file_path = "/opt/scripts/python/argument.py"
     script_name = "argument.py on OEL7-OpenSourceTelegraf"

   Observação: Não altere nenhuma outra configuração do Telegraf, pois isso pode levar a um comportamento indesejável.
2. Reinicie o Telegraf e aguarde 10 minutos para obter os dados.

O que Fazer Depois

Você pode visualizar as métricas selecionando o objeto relevante na guia Métricas (Metrics) da interface do usuário do VMware Aria Operations:

1. No painel esquerdo, navegue até Ambiente (Environment) > Grupos personalizados (Custom Groups).
2. Clique no objeto Operating System World no painel direito.
3. Navegue até a guia Métricas (Metrics) e selecione o objeto de SO correspondente.
4. Em Objeto do SO (OS object), você encontrará o objeto Script Personalizado (Custom Script).