chore: start writing adoc/antora documentation

This commit is contained in:
genofire 2023-02-25 21:49:50 +01:00
parent 4acbfefd43
commit dd2eb515b8
4 changed files with 10 additions and 58 deletions

View File

@ -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`

9
docs/antora.yml Normal file
View File

@ -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"

View File

@ -0,0 +1 @@
../../../../README.adoc

BIN
oven-exporter Executable file

Binary file not shown.