Hello everyone!
Atualizado 07/03/2019 incluindo suporte para zabbix versão 4.0
Firstly, I want to point out that the documentation regarding SNMP Unifi Ubiquiti is very difficult to find and regarding zabbix, the documentation is pretty confusing. I had to make use of several tools out of the objective of the task and many attempts and errors until arriving at a really functional zabbix template.
The SNMP support on Ubiquiti UNIFI devices with old firmware is non-existent, incomplete or incompatible with this template. Because Unifi made some changes to the Ubiquiti SNMP OIDs. So here are some prerequisites to venture into this game:
1 - The controller software must be the latest with SNMP support. I suggest starting with version 5.9.29.
2 - The firmware of the WIFI device must be equal to or greater than version 3.9.x. The locations of OIDs are not the same in older versions. The oldest version I tested that did not work was the 3.7.58.6385. So if your firmware version is higher than this, you can test it, but I can not guarantee it will work.
3 - The Zabbix server must have the following MIBs installed:
FROGFOOT-RESOURCES-MIB, IANAifType-MIB, IF-MIB, SNMP-FRAMEWORK-MIB, SNMPv2-CONF, SNMPv2-MIB, SNMPv2-SMI, SNMPv2-TC, UBNT-MIB, UBNT-UniFi-MIB
4 - The version of the Zabbix server was 3.4, so versions equal to or greater than this should work as well.
For those who can not wait and want to go testing, follow the Template:
Template Unifi SNMP 2019 V1.1
Did you like the tip?
Leave your comment or suggestion!
See you the next time!
Some screen captures:
English 
Português do Brasil
Boa noite amigo.
Implantei com sucesso os passos deste tutorial, mas faltam detalhes de como configurar no Zabbix. Eu devo adicionar um Host com o IP do Unifi Controller utilizando o Template?
Boa noite Pablo!
Primeiro você deve importar o template.
Após isso, criar um novo host com o IP do AP UNIFI e não esquecer de fixar este mesmo IP na configuração do AP.
Durante a criação do host, basta ir em templates e selecionar o template Unifi clicar em add, e depois salvar a configuração.
Após cerca de 1 minuto você já será capaz de ver o resultado das coletas.
Caso não esteja coletando, você pode fazer um teste a partir do seu servidor zabbix utilizando o comando:
snmpwalk -v1 -c public ipdoapubiquiti
NÃO FUNCIONA NO UniFi AP-AC-Pro?
Vai depender da versão do seu firmware. Mas, eu acho que algumas funções não vão funcionar por eu não ter implementado.
Boa tarde… quando vc fala ipdoubiquiti é o IP da máquina que tem o console instalado?
IP do AP, não é preciso a controller para fazer as coletas
Ah. vou fazer esta parte esta semana, estava focado em desenvolver as outras partes do template para diagnosticar uns problemas nas redes que gerencio.
Boa noite Amigo
Funciona com um zabbix proxy coletando as informações?
Pois pelo que entendi esse zabbix proxy teria ter as MIBs que mencionou
Boa noite Tiago!
Funciona com zabbix proxy, sem problemas.
Só precisa das Mibs para depuração e apenas no servidor zabbix.
Depois que eu conclui os artigos, eu mudei a direção e refiz todo o template usando as OIDs sem tradução.
Forte abraço e sucesso
Boa Tarde Alex, vc saberia dizer para qual arquivo no ZABBIX devo importar as MIBS do UNIFI?
As MIBs não são importadas para o zabbix, elas são parte do protocolo client snmp do sistema operacional.
Este link deve te ajudar a encontrar o caminho
https://www.vivaolinux.com.br/topico/Redes/Importar-MIB
Abraços
Alex Moura
Obg pela resposta, mas fiquei um pouco confuso, pelo que você detalhou no item 3 deste artigo as mibs do Unifi devem estar instaladas no zabbix, para eu realizar as coletas dos itens conforme o seu template eu preciso dessas mibs instaladas no zabbix?
Olá Fabrício!
Depois que eu completei o template, eu o refiz usando os números das OIDs ao invés das traduções das MIBs.
As MIBs referentes ao UNIFI não deverão fazer falta. Elas servem para debugar ou implementar novas funções de dispositivos UNIFI.
Eu deixei a informação, pois, alguém pode querer melhorar o template e não vai conseguir sem as MIBs.
Abraços
Alex Moura
Segue a resposta em inglês que eu dei para uma outra pessoa que fez uma pergunta semelhante.
Em resposta a Glenn
Hello Glenn!
In fact, I developed this template using these MIBs, but, these requirements are to troubleshooting.
I changed my direction, and only using the OID numbers to create the template and used the OID names to identify the MIBs correspondent names.
Despite my system have these MIBs, in theory, perhaps not necessary for troubleshooting.
MIBs are files to translate the OID numbers to human readable information.
So let’s go to solve your problem.
Follow these steps to fix your AP.
1 – The SNMP protocol must be enabled at the Acess Point set in services SNMP session in controller. For troubleshooting use “public” community.
2 – Use ping to test the physical connection to the Access point.
3 – On zabbix server use NetCat to test the port connectivity;
EX: nc -vu 192.168.0.200 161
this will be a correct response. Connection to 192.168.0.200 port [udp/snmp] succeeded!
4 – test snmp response with this command:
snmpwalk -v2c -c public 192.168.0.200
5 – looking if the correct port is configured in the host settings in zabbix.
This is a easy part, if this not enough to solve your problem, then let me know more detailed information.
If you solved then let me know too.
Best Regards
Alex Moura
Muito obrigado por compartilhar seu conhecimento! Funcionou!
Não encontrei no template um gráfico que mostrasse todos os usuários/quantidade de todos os SSIDs.
Seria legal pra eu ter uma ideia do uso geral.
Tem alguma dica de como posso implementar esse gráfico?
Mais uma vez, obrigado por compartilhar!
Olá Fernando!
Isto é uma limitação tanto do zabbix, quanto do Unifi.
O fato de que eu faço as coletas dinamicamente de acordo com as redes configuradas, impede que eu faça este somatório com as funções padrão do zabbix.
Andei pesquisando em alguns fóruns sobre isto, e descobri que isto é uma característica muito solicitada aos desenvolvedores do zabbix para tratar valores SNMP gerados dinamicamente.
Do lado do Unifi, não há uma “OID” contendo o somatório de clientes conectados.
Caso tenha alguma idéia de como implementar um script de coleta e queira compartilhar, terei o maior prazer em testar e implementar na solução.
Um grande abraço!
Alex Moura
Boa Tarde
Quais são as macros por favor?
Tenho uma UNIFI GATEWAY
Boa tarde Cleiton.
Não entendi a sua pergunta.
Primeiramente obrigado pela contribuição…
Estou tentando criar o Host.. mas no momento de adiciona-lo recebo essa msg do
Zabbix Details Cannot add host
Cannot find host interface on “AP_RP_Contabilidade” for item key “unifiVapEssId”.
O que eu devo fazer?
At,
Xico
Bom dia!
Provavelmente você já tem o item configurado em sua instalação zabbix.
Acredito que o primeiro passo seja identificar esta duplicidade e removê-la.
Os ítens referentes ao wifi são gerados dinamicamente e não precisam serem configurados.
Mande mais detalhes e talvez eu consiga te ajudar melhor.
Atenciosamente
Alex Moura
amigos, como faço pra criar no template um item que eu faça o cálculo do total de usuários(dispositivos) ativos no AP, estou tentando criar um protótipo de item pra que depois que descubra o unifiVapNumStations ele já me informe o total por AP
Olá Joel!
Até a versão 4.0 do zabbix não é possível.
Em breve atualizarei para a versão 4.4 do zabbix, onde pelo que li pode ser que seja possível.
Assim que fizer atualizo o template.
Vou reproduzir a resposta que dei a outro colega mais abaixo.
Isto é uma limitação tanto do zabbix, quanto do Unifi.
O fato de que eu faço as coletas dinamicamente de acordo com as redes configuradas, impede que eu faça este somatório com as funções padrão do zabbix.
Andei pesquisando em alguns fóruns sobre isto, e descobri que isto é uma característica muito solicitada aos desenvolvedores do zabbix para tratar valores SNMP gerados dinamicamente.
Do lado do Unifi, não há uma “OID” contendo o somatório de clientes conectados.
Caso tenha alguma idéia de como implementar um script de coleta e queira compartilhar, terei o maior prazer em testar e implementar na solução.
Um grande abraço!
Alex Moura
Bom dia mestre,
Estou entrando nesta onda de zabbix agora.
possuo uma nanobeam m5 e não consigo adicioná-la no zabbix. da erro de porta.
como configuro a porta ?
Boa tarde Moreno!
Você precisa garantir que no software controlador estes parâmetros estão ativados e setados.
Services / SNMP / SNMPv1, SNMPv2c/ Enabled
Community = Nome que você gostaria de utilizar. Pode deixar a public para efeitos de teste. Mas, não recomendo deixar a community como public.
Sugiro que você leia também este artigo
https://duvidaonline.com.br/blog/2019/01/03/como-monitorar-dispositivos-unifi-ubiquiti-no-zabbix-parte-3-atualizando-firmware-e-habilitando-o-protocolo-snmp/
Um forte abraço!
Alex Moura
Boa tarde Alex Moura, tudo bem?
Tem alguma novidade sobre a questão de total de usuários conectados no AP invés de retornar o total por SSID/Frequência?
Abraços
Bom dia Rodrigo!
Eu recém instalei a versão 4.4 no meu ambiente de produção.
Vou testar e em breve darei um retorno.
Forte abraço
Alex Moura
Boa tarde alex, consegui isso atráves do unifi_miner/unifi_proxy. Tem no github… Aliás, consegue-se muito mais informação. Abraço
Boa tarde Rodrigo!
Este era o cara que falei para alguém nos comentários que davam vários problemas e por isto desisti.
Quero fazer todas as funções sem depender de scripts externos.
Abraços
Alex Moura
Hi Alex,
I made a snmp v3 version of you template. Do you want to publish it on zabbix share?
Or shall I do this and credit you?
https://github.com/kko/unifi-zabbix-snmpv3
Helo Helmer.
I think will better only one place to post. So this can be access by everyone at once.
Thanks for improvements!
Agreed!
Estou fazendo o teste com Unifi Ac lite. Está coletando tudo corretamente, exceto quantidade de usuários pois acredito que ele separa o que esta na 2.4ghz para o que esta na 5ghz mas aparece estranho no grafico. O que pode ser? No lugar de ter AC ou 2.4hz aparece “ng” e “na” a chave que coleta isso é: {#UNIVAPRADIO}
ng é a banda BG
na é a banda AC
Não existe um contador consolidado de quantidade de usuários no AP, ele separa por redes e por bandas.
Eu solicitei até para a unifi a inclusão deste indicador.
O zabbix não consegue consolidar estes números até a versão 4.4.
Ainda não testei na versão 5.0
Will you be testing this under v5 of Zabbix? The one item I would like to see changed is the ng or na items.
soon I will testing
Cara, eu importei as tres mibs que faltavam no ubuntu em /usr/share/snmp/libs/. Minha linha do snmp.conf está comentada (#MIBS 🙂 e acredito que os gráficos não estão refletindo a realidade do tráfego. Zabbix versão 6. Obrigado.
Ainda não testei na versão 6 do zabbix.
E as MIBs são desnecessárias para o correto funcionamento do template.
Elas existem apenas para referência caso você queira debugar o SNMP sem se perder.