Você pode executar scripts personalizados na VM do endpoint 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. Se a saída não for um valor inteiro único, um erro será exibido na interface do usuário.
  • O script personalizado usa o plug-in exec do Telegraf para executar scripts no sistema operacional de uma VM de endpoint. Nos sistemas operacionais Linux, um usuário especial chamado arcuser com privilégios específicos é criado para instalar o agente do Telegraf. Como resultado, o plug-in exec executa os scripts usando esse usuário arcuser. Certifique-se de que o arcuser possa executar os scripts que usam o script personalizado (o arcuser deve ter permissões para executar o script). Por exemplo, o arcuser criado automaticamente pelo proxy de nuvem não tem privilégios para executar scripts armazenados no diretório /root.
  • Em sistemas operacionais Windows, um usuário do sistema é usado para instalar o agente do Telegraf. Como resultado, o plug-in exec executa os scripts usando esse usuário do sistema. Certifique-se de que o usuário do sistema tenha privilégios e possa executar o script personalizado.
  • O script deve ser colocado na pasta /opt/vmware.
  • A variável de ambiente PATH deve ser definida para que os scripts do PowerShell sejam executados no sistema operacional Windows se o usuário tiver usado o prefixo powershell -File. Por exemplo, "%SYSTEMROOT%\System32\WindowsPowerShell\v1.0\" na variável de ambiente PATH variable.

Como executar scripts personalizados

  • Na guia Gerenciar agentes do Telegraf (Manage Telegraf Agents), filtre por Status do agente (Agent Status) > Agente em execução (Agent Running).
  • Expanda a seta suspensa na VM de endpoint na qual o agente está instalado. Você verá a seção Monitoramento personalizado (Custom Monitoring).
  • Na opção Script personalizado (Custom Script), clique nas reticências verticais e, em seguida, clique em Adicionar (Add).
  • Na caixa de diálogo Gerenciar serviço personalizado, você pode adicionar e configurar os serviços Windows a serem monitorados.

Configurações da instância

Opção Descrição
Status Ative a execução do script personalizado.
Nome de exibição Adicione um nome adequado para o script. O * é um caractere inválido e não deve ser usado no nome.
Caminho do arquivo Insira o caminho para o arquivo de script na VM do endpoint.

Exemplo:

Para VMs de endpoint do Linux: 
 /opt/vmware/scripts/customscript.py
Para VMs de endpoint Windows: 
c:\scripts\customscript.ps1
Prefixo Digite um prefixo, se necessário.

Exemplo:

Para VMs de endpoint Linux: python2.7, /bin/bash ou perl, etc.

Para VMs de endpoint Windows: powershell -File
Args Liste os argumentos no script.
Tempo limite Insira um tempo limite de execução do script na VM do endpoint.

Depois que você salvar o script, ele aparecerá em Script personalizado (Custom Script). Você pode editar ou excluir scripts clicando nas opções Editar (Edit) ou Excluir (Delete) nas reticências verticais no script personalizado que você adicionou. Depois que os scripts forem adicionados e salvos, clique na seta suspensa em Script Personalizado (Custom Script) para visualizar a lista de scripts e seus status.

Observação:
  • O script personalizado deve gerar todos os erros no formato ERROR|<Error_message> para que a propagação do erro funcione. Se o script não gerar um erro no formato fornecido, VMware Aria Operations exibirá uma mensagem de erro Unable to parse the error message. Please check the endpoint na interface do usuário. Isso ocorre por design, até que o proxy de nuvem propague a mensagem de erro exata.
  • O script bash deve começar com shebang (#!/bin/bash).

Guia Todas as Métricas

Quando os dados forem coletados com êxito, você poderá visualizar o script como uma métrica para a VM do endpoint, na guia Todas as métricas (All Metrics). As métricas de script são criadas em um objeto chamado Script Personalizado, que é um único objeto por VM de endpoint. Todas as métricas dos scripts para a VM de endpoint são colocadas nesse objeto Script Personalizado que contém todos os scripts personalizados que você criou. Você pode visualizar a saída para a métrica específica. O nome da métrica na pasta Scripts é o nome para exibição que o usuário especifica ao criar a configuração do script. Por exemplo, se você definir o nome de exibição como Script Python, uma métrica será criada com o nome Script Python (Python script) se os dados forem coletados com êxito.