---
title: Hyper-V
slug: aiops/hyper-v
docTags: 
createdAt: 2025-06-08T03:38:05.880Z
---

Esta configuração permite a coleta de dados do Hyper-V a partir do **sphere-agent** com a utilização de um script PowerShell específico.

1. Acesso ao servidor Hyper-V onde o **sphere-agent** está instalado.
2. Permissão para adicionar scripts ao diretório do **sphere-agent**.
3. Faça o download do script PowerShell que será usado para a coleta de dados:
   - [Export-HyperVToTelegraf.ps1](https://repo.simonops.com/repo/scripts/Export-HyperVToTelegraf.ps1)
   - O arquivo deve ser colocado na pasta do sphere-agent:
     - C:/ProgramData/65A/sphere-agent
4. Acesse a interface de gerenciamento do **sphere-agent** através do console **Atmos** -> **Infraestrutura **->** Detalhamento do IC **->** Configuração do agent **e adicione a seguinte configuração para habilitar a coleta do script PowerShell no Telegraf:

:::BlockQuote
\[\[inputs.exec]]
  commands = \["powershell -File C:/ProgramData/65A/sphere-agent/Export-HyperVToTelegraf.ps1"]
  interval = "15m"
  timeout = "120s"
  data\_format = "influx"
:::

- **\[\[inputs.exec]]**: Este é o plugin do Telegraf que executa comandos ou scripts externos.
- **commands**: O comando que será executado pelo Telegraf. Neste caso, estamos chamando o PowerShell para executar o script **Export-HyperVToTelegraf.ps1**.
- **interval**: Define o intervalo de tempo entre as execuções do script. No exemplo, o script será executado a cada 15 minutos (15m).
- **timeout**: Tempo máximo de execução permitido para o script. Caso o script demore mais de 120 segundos (120s), a execução será encerrada.
- **data\_format**: Define o formato dos dados de saída que o Telegraf espera. Neste caso, o formato utilizado será **InfluxDB** (influx), o que permite que as métricas sejam enviadas diretamente para uma base de dados InfluxDB.

Após realizar os procedimentos, preencha os **Detalhes da Descoberta** selecionando como **Host de Origem **o IC utilizado na configuração.