Item

Um Item define uma métrica que será coletada pelo servidor através de um agente ou via SNMP. Ele representa informações como uso de CPU, memória, status de interface, etc.

---

🧩 Estrutura de um Item

Campo	Tipo	Descrição
nome	string	Nome descritivo do item (ex: "Uso de CPU Atual")
key	string	Chave de coleta utilizada pelo agente (ex: load.currentLoad)
tipo	enum	Define como o dado será coletado: agent ou snmp
snmpOid	string?	OID usado na coleta SNMP (obrigatório se o tipo for snmp)

---

🔑 Key (Chave de coleta)

A key define qual informação será coletada no agente. Exemplo:

• load.currentLoad → Carga atual da CPU
• mem.usedPercent → Percentual de memória utilizada
• network.in.bytes → Bytes recebidos em uma interface

As chaves disponíveis dependem do que o agente implementa.

---

⚙️ Tipo do Item

• agent: Coleta local feita pelo agente instalado no servidor monitorado.
• snmp: Coleta remota via protocolo SNMP. Exige o campo snmpOid.

Campo snmpOid

Se o tipo do item for snmp, é obrigatório preencher o OID correspondente. Exemplo:

.1.3.6.1.2.1.2.2.1.10.1

Esse OID representa, por exemplo, a quantidade de bytes recebidos na porta 1 de um switch.

---

🖧 Interface de Rede

Para itens relacionados a rede (tráfego, erros, etc.), o sistema deve permitir que o usuário selecione a interface correta que será monitorada.

As interfaces disponíveis devem ser retornadas pelo agente ou SNMP no momento do registro ou configuração do host.

---

✅ Exemplo de Item

{
  "nome": "Uso de CPU Atual",
  "key": "load.currentLoad",
  "tipo": "agent"
}

{
  "nome": "Tráfego de entrada - Porta 1",
  "key": "network.in.bytes",
  "tipo": "snmp",
  "snmpOid": ".1.3.6.1.2.1.2.2.1.10.1"
}

---

📌 Observações

• O campo snmpOid é obrigatório apenas se o tipo de item for snmp.
• A severidade de alertas deve ser definida nos triggers, não nos itens.
• Cada item pode ser referenciado por triggers para gerar alertas com base em seu valor coletado.

---