chore: start writing adoc/antora documentation
This commit is contained in:
parent
4acbfefd43
commit
dd2eb515b8
58
README.md
58
README.md
|
@ -1,58 +0,0 @@
|
||||||
# Oven-Exporter
|
|
||||||
An Prometheus Exporter for OvenMediaEngine
|
|
||||||
|
|
||||||
(it provides also a small API-Client for OvenMediaEngine)
|
|
||||||
Be welcome to improve it.
|
|
||||||
|
|
||||||
## Configure OvenMediaEngine
|
|
||||||
|
|
||||||
This Exporter use the REST-API of OvenMediaEngine,
|
|
||||||
to setting it up, that a look in there Documentation [OvenMediaEngine REST-API](
|
|
||||||
https://airensoft.gitbook.io/ovenmediaengine/rest-api).
|
|
||||||
|
|
||||||
## Setup Exporter
|
|
||||||
|
|
||||||
### Compile
|
|
||||||
|
|
||||||
Install [golang](https://golang.org/doc/install).
|
|
||||||
|
|
||||||
Run:
|
|
||||||
`go install -v dev.sum7.eu/genofire/oven-exporter@latest`
|
|
||||||
|
|
||||||
### Configuration
|
|
||||||
Read comments in [config_example.toml](config_example.toml) for more information.
|
|
||||||
|
|
||||||
Maybe a good place to store this file is: `/etc/ovenmediaengine/exporter.conf`
|
|
||||||
|
|
||||||
OR use env variables:
|
|
||||||
```
|
|
||||||
OVEN_E_LISTEN=:8080
|
|
||||||
OVEN_E_API__URL=http://1.2.3.4:8081
|
|
||||||
OVEN_E_API__TOKEN=ome-access-token
|
|
||||||
OVEN_E_API__DEFAULT_VHOST=
|
|
||||||
OVEN_E_API__DEFAULT_APP=
|
|
||||||
```
|
|
||||||
|
|
||||||
(File read could be disabled by call `oven-exporter -c ''`
|
|
||||||
|
|
||||||
### Startup
|
|
||||||
Create a systemd.service file e.g. under `/etc/systemd/system/oven-exporter.service` with maybe a content like this:
|
|
||||||
|
|
||||||
```ini
|
|
||||||
[Unit]
|
|
||||||
Description = Prometheus exporter for OvenMediaEngine
|
|
||||||
|
|
||||||
[Service]
|
|
||||||
Type=simple
|
|
||||||
ExecStart=/usr/local/bin/oven-exporter -c /etc/ovenmediaengine/exporter.conf
|
|
||||||
Restart=always
|
|
||||||
RestartSec=5s
|
|
||||||
Environment=PATH=/usr/bin:/usr/local/bin
|
|
||||||
|
|
||||||
[Install]
|
|
||||||
WantedBy=multi-user.target
|
|
||||||
```
|
|
||||||
PS: maybe you need to adjust the binary path and configuration path.
|
|
||||||
|
|
||||||
Start and enable on boot:
|
|
||||||
`systemctl enable --now oven-exporter.service`
|
|
|
@ -0,0 +1,9 @@
|
||||||
|
name: oven-exporter
|
||||||
|
title: Oven Exporer
|
||||||
|
# use from git tag
|
||||||
|
version:
|
||||||
|
v(?<version>+({0..9}).+({0..9})).*: $<version>
|
||||||
|
main: latest
|
||||||
|
|
||||||
|
nav:
|
||||||
|
- "modules/ROOT/nav.adoc"
|
|
@ -0,0 +1 @@
|
||||||
|
../../../../README.adoc
|
Binary file not shown.
Loading…
Reference in New Issue