routeros-exporter/README.md

38 lines
807 B
Markdown
Raw Normal View History

2021-05-30 19:29:00 +00:00
# RouterOS Prometheus Exporter
2021-05-29 21:14:26 +00:00
2021-10-08 20:14:48 +00:00
## Setup
2021-05-29 21:14:26 +00:00
You need to create a user on routerOS (>7.1):
```
/user group
2021-05-30 19:29:00 +00:00
add name=prometheus policy=api,rest-api,!local,!telnet,!ssh,!ftp,!reboot,!write,!policy,!test,!password,!web,!sniff,!sensitive,!romon,!dude,!tikapp
2021-05-29 22:02:18 +00:00
/user
add group=prometheus name=prometheus password=<your super secret password>
````
2021-05-29 21:59:32 +00:00
You also need to `www-ssl` [enable](https://help.mikrotik.com/docs/display/ROS/REST+API)
## Docker
```
2021-10-08 20:06:28 +00:00
routeros-exporter:
image: python-routeros
restart: always
environment:
- ROUTER_IP=<your ROUTERIP>
- ROUTER_USERNAME=<your prometheus username>
- ROUTER_PASSWORD=<your super secret password>
2021-10-08 20:14:48 +00:00
```
### build
simply use `make build`
## Metrics
Today thoose metrics was fetched by this exporter:
* interfaces
* cpu (load/irq)