Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/smejdil/zabbix-starlink
Monitoring Starlink Dish by gRPC python project
https://github.com/smejdil/zabbix-starlink
grpc metrics monitoring zabbix
Last synced: 27 days ago
JSON representation
Monitoring Starlink Dish by gRPC python project
- Host: GitHub
- URL: https://github.com/smejdil/zabbix-starlink
- Owner: smejdil
- License: gpl-3.0
- Created: 2023-03-31T07:52:44.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2023-09-04T06:52:11.000Z (over 1 year ago)
- Last Synced: 2024-11-10T13:40:13.350Z (3 months ago)
- Topics: grpc, metrics, monitoring, zabbix
- Homepage: https://open-tech.cz/
- Size: 931 KB
- Stars: 8
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
## zabbix-starlink
Monitoring Starlink Dish by [gRPC](https://grpc.io/) and Python project [starlink-grpc-tools](https://github.com/sparky8512/starlink-grpc-tools)
### Tested on FreeBSD
- Package - py39-grpcio-1.52.0 HTTP/2-based RPC framework
- Package - py39-grpcio-tools-1.52.0 Protobuf code generator for gRPC
### How it works
Python projects by gRPC connect to Dish and read information. Result is by
Prometeus format. Zabbix read URL - {$STARLINK.SCHEME}://{HOST.CONN}:{$STARLINK.PORT}/metrics.
### Running on FreeBSD in Screen
```console
function exec_in_screen() {
name=$1
command=$2
screen -dmS $name sh; screen -S $name -X stuff "$command\n";
}
exec_in_screen "starlink" "/usr/local/bin/exporter_starlink.sh"
```
```console
cat /usr/local/bin/exporter_starlink.sh
cd /root/starlink-grpc-tools
/usr/local/bin/python3.9 dish_grpc_prometheus.py status alert_detail
```
### Running with Docker
```console
git clone https://github.com/sparky8512/starlink-grpc-tools && cd starlink-grpc-tools
cp ../zabbix-starlink/Dockerfile.patch ./
patch < Dockerfile.patch
patching file Dockerfile
docker build -t starlink-grpc-tools .
docker run -d -t -p 8080:8080 --name='starlink-grpc-tools' starlink-grpc-tools
curl 127.0.0.1:8080
```
### Running docker container by SystemD
```console
cp docker.starlink-grpc-tools.service /etc/systemd/system/
systemctl daemon-reload
systemctl enable docker.starlink-grpc-tools.service
systemctl restart docker.starlink-grpc-tools.service
curl 127.0.0.1:8080
```
### Images
### To do
- Run in Jail or Docker
- Make template for https://github.com/ewilken/starlink-exporter
- Make template for https://github.com/sysdigdan/starlink_exporter