Skip to content

Commit

Permalink
Allow using a custom livebox address (#7)
Browse files Browse the repository at this point in the history
  • Loading branch information
Tomy2e authored Jun 3, 2023
1 parent 5abe206 commit 4a5496d
Show file tree
Hide file tree
Showing 16 changed files with 141 additions and 38 deletions.
8 changes: 5 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -40,9 +40,11 @@ The exporter accepts the following command-line options:

The exporter reads the following environment variables:

| Name | Description | Default value |
| -------------- | --------------------------------------------------------------------------------------------------------- | ------------- |
| ADMIN_PASSWORD | Password of the Livebox "admin" user. The exporter will exit if this environment variable is not defined. | |
| Name | Description | Default value |
| --------------- | --------------------------------------------------------------------------------------------------------- | -------------------- |
| ADMIN_PASSWORD | Password of the Livebox "admin" user. The exporter will exit if this environment variable is not defined. | |
| LIVEBOX_ADDRESS | Address of the Livebox. | `http://192.168.1.1` |
| LIVEBOX_CACERT | Optional path to a PEM-encoded CA certificate file on the local disk. | |

### Docker

Expand Down
4 changes: 2 additions & 2 deletions charts/livebox-exporter/Chart.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -2,5 +2,5 @@ apiVersion: v2
name: livebox-exporter
description: A prometheus exporter for Livebox
type: application
version: 0.2.0
appVersion: "v0.2.0"
version: 0.3.0
appVersion: "v0.3.0"
10 changes: 10 additions & 0 deletions charts/livebox-exporter/templates/configmap.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,10 @@
{{- if .Values.livebox.caCert }}
apiVersion: v1
kind: ConfigMap
metadata:
name: {{ include "livebox-exporter.fullname" . }}
labels:
{{- include "livebox-exporter.labels" . | nindent 4 }}
data:
ca.crt: {{ toYaml .Values.livebox.caCert | indent 2 }}
{{- end }}
25 changes: 22 additions & 3 deletions charts/livebox-exporter/templates/deployment.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -41,13 +41,26 @@ spec:
- name: ADMIN_PASSWORD
valueFrom:
secretKeyRef:
{{- if .Values.adminPassword.secretKeyRef }}
name: {{ .Values.adminPassword.secretKeyRef.name}}
key: {{ .Values.adminPassword.secretKeyRef.key }}
{{- if .Values.livebox.adminPassword.secretKeyRef }}
name: {{ .Values.livebox.adminPassword.secretKeyRef.name}}
key: {{ .Values.livebox.adminPassword.secretKeyRef.key }}
{{- else }}
name: {{ include "livebox-exporter.fullname" . }}-admin
key: password
{{- end }}
{{- with .Values.livebox.address }}
- name: LIVEBOX_ADDRESS
value: {{ . }}
{{- end }}
{{- if .Values.livebox.caCert }}
- name: LIVEBOX_CACERT
value: /etc/livebox/certs/ca.crt
{{- end }}
{{- if .Values.livebox.caCert }}
volumeMounts:
- name: livebox-crt
mountPath: /etc/livebox/certs
{{- end }}
{{- with .Values.nodeSelector }}
nodeSelector:
{{- toYaml . | nindent 8 }}
Expand All @@ -60,3 +73,9 @@ spec:
tolerations:
{{- toYaml . | nindent 8 }}
{{- end }}
{{- if .Values.livebox.caCert }}
volumes:
- name: livebox-crt
configMap:
name: {{ include "livebox-exporter.fullname" . }}
{{- end }}
4 changes: 2 additions & 2 deletions charts/livebox-exporter/templates/secret.yaml
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
{{- if not .Values.adminPassword.secretKeyRef }}
{{- if not .Values.livebox.adminPassword.secretKeyRef }}
apiVersion: v1
kind: Secret
metadata:
Expand All @@ -7,5 +7,5 @@ metadata:
{{- include "livebox-exporter.labels" . | nindent 4 }}
type: Opaque
data:
password: {{ .Values.adminPassword.value | b64enc }}
password: {{ .Values.livebox.adminPassword.value | b64enc }}
{{- end }}
21 changes: 12 additions & 9 deletions charts/livebox-exporter/values.yaml
Original file line number Diff line number Diff line change
@@ -1,7 +1,3 @@
# Default values for livebox-exporter.
# This is a YAML-formatted file.
# Declare variables to be passed into your templates.

replicaCount: 1

image:
Expand All @@ -10,12 +6,19 @@ image:
# Overrides the image tag whose default is the chart appVersion.
tag: ""

adminPassword:
secretKeyRef: {}
# name: ""
# key: ""
livebox:
adminPassword:
secretKeyRef: {}
# name: ""
# key: ""

value: "changeme"

# Address of the Livebox. If empty the exporter will use its own default value.
address: ""

value: "changeme"
# CA cert of the Livebox.
caCert: ""

imagePullSecrets: []
nameOverride: ""
Expand Down
2 changes: 1 addition & 1 deletion go.mod
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ module github.com/Tomy2e/livebox-exporter
go 1.18

require (
github.com/Tomy2e/livebox-api-client v0.0.0-20230304114924-a629a6a185e7
github.com/Tomy2e/livebox-api-client v0.0.0-20230524112450-31caca47cbd8
github.com/prometheus/client_golang v1.14.0
golang.org/x/exp v0.0.0-20230315142452-642cacee5cc0
golang.org/x/sync v0.1.0
Expand Down
4 changes: 2 additions & 2 deletions go.sum
Original file line number Diff line number Diff line change
Expand Up @@ -33,8 +33,8 @@ cloud.google.com/go/storage v1.10.0/go.mod h1:FLPqc6j+Ki4BU591ie1oL6qBQGu2Bl/tZ9
dmitri.shuralyov.com/gpu/mtl v0.0.0-20190408044501-666a987793e9/go.mod h1:H6x//7gZCb22OMCxBHrMx7a5I7Hp++hsVxbQ4BYO7hU=
github.com/BurntSushi/toml v0.3.1/go.mod h1:xHWCNGjB5oqiDr8zfno3MHue2Ht5sIBksp03qcyfWMU=
github.com/BurntSushi/xgb v0.0.0-20160522181843-27f122750802/go.mod h1:IVnqGOEym/WlBOVXweHU+Q+/VP0lqqI8lqeDx9IjBqo=
github.com/Tomy2e/livebox-api-client v0.0.0-20230304114924-a629a6a185e7 h1:aX04myQJxWqjP1I1S8jiE8fKyXSu4CHKMBOCUMTwlCI=
github.com/Tomy2e/livebox-api-client v0.0.0-20230304114924-a629a6a185e7/go.mod h1:3uvJQHRP5V3BKPTzWCOmUMxZrPbJNl45Wu7ueX9L8QM=
github.com/Tomy2e/livebox-api-client v0.0.0-20230524112450-31caca47cbd8 h1:rVK1emWX3JW3nNhLdl76M4RJgmMj/hcgQVOJmrh2r9Y=
github.com/Tomy2e/livebox-api-client v0.0.0-20230524112450-31caca47cbd8/go.mod h1:3uvJQHRP5V3BKPTzWCOmUMxZrPbJNl45Wu7ueX9L8QM=
github.com/alecthomas/template v0.0.0-20160405071501-a0175ee3bccc/go.mod h1:LOuyumcjzFXgccqObfd/Ljyb9UuFJ6TxHnclSeseNhc=
github.com/alecthomas/template v0.0.0-20190718012654-fb15b899a751/go.mod h1:LOuyumcjzFXgccqObfd/Ljyb9UuFJ6TxHnclSeseNhc=
github.com/alecthomas/units v0.0.0-20151022065526-2efee857e7cf/go.mod h1:ybxpYRFXyAe+OPACYpWeL0wqObRcbAqCMya13uyzqw0=
Expand Down
4 changes: 2 additions & 2 deletions internal/collector/deviceinfo.go
Original file line number Diff line number Diff line change
Expand Up @@ -14,15 +14,15 @@ var _ prometheus.Collector = &DeviceInfo{}

// DeviceInfo implements a prometheus Collector that returns Livebox specific metrics.
type DeviceInfo struct {
client livebox.Client
client *livebox.Client
numberOfRebootsMetric *prometheus.Desc
uptimeMetric *prometheus.Desc
memoryTotalMetric *prometheus.Desc
memoryUsageMetric *prometheus.Desc
}

// NewDeviceInfo returns a new DeviceInfo collector using the specified client.
func NewDeviceInfo(client livebox.Client) *DeviceInfo {
func NewDeviceInfo(client *livebox.Client) *DeviceInfo {
return &DeviceInfo{
client: client,
numberOfRebootsMetric: prometheus.NewDesc(
Expand Down
4 changes: 2 additions & 2 deletions internal/poller/devices.go
Original file line number Diff line number Diff line change
Expand Up @@ -13,12 +13,12 @@ var _ Poller = &DevicesTotal{}

// DevicesTotal allows to poll the total number of active devices.
type DevicesTotal struct {
client livebox.Client
client *livebox.Client
devicesTotal *prometheus.GaugeVec
}

// NewDevicesTotal returns a new DevicesTotal poller.
func NewDevicesTotal(client livebox.Client) *DevicesTotal {
func NewDevicesTotal(client *livebox.Client) *DevicesTotal {
return &DevicesTotal{
client: client,
devicesTotal: prometheus.NewGaugeVec(prometheus.GaugeOpts{
Expand Down
4 changes: 2 additions & 2 deletions internal/poller/interface.go
Original file line number Diff line number Diff line change
Expand Up @@ -15,12 +15,12 @@ var _ Poller = &InterfaceMbits{}
// InterfaceMbits allows to poll the current bandwidth usage on the Livebox
// interfaces.
type InterfaceMbits struct {
client livebox.Client
client *livebox.Client
txMbits, rxMbits *prometheus.GaugeVec
}

// NewInterfaceMbits returns a new InterfaceMbits poller.
func NewInterfaceMbits(client livebox.Client) *InterfaceMbits {
func NewInterfaceMbits(client *livebox.Client) *InterfaceMbits {
return &InterfaceMbits{
client: client,
txMbits: prometheus.NewGaugeVec(prometheus.GaugeOpts{
Expand Down
4 changes: 2 additions & 2 deletions internal/poller/interface_homelan.go
Original file line number Diff line number Diff line change
Expand Up @@ -22,14 +22,14 @@ var _ Poller = &InterfaceHomeLanMbits{}
// InterfaceHomeLanMbits is an experimental poller to get the current bandwidth
// usage on the Livebox interfaces.
type InterfaceHomeLanMbits struct {
client livebox.Client
client *livebox.Client
interfaces []*exporterLivebox.Interface
bitrate *bitrate.Bitrate
txMbits, rxMbits *prometheus.GaugeVec
}

// NewInterfaceHomeLanMbits returns a new InterfaceMbits poller.
func NewInterfaceHomeLanMbits(client livebox.Client, interfaces []*exporterLivebox.Interface) *InterfaceHomeLanMbits {
func NewInterfaceHomeLanMbits(client *livebox.Client, interfaces []*exporterLivebox.Interface) *InterfaceHomeLanMbits {
return &InterfaceHomeLanMbits{
client: client,
interfaces: interfaces,
Expand Down
4 changes: 2 additions & 2 deletions internal/poller/interface_netdev.go
Original file line number Diff line number Diff line change
Expand Up @@ -16,14 +16,14 @@ var _ Poller = &InterfaceNetDevMbits{}
// InterfaceNetDevMbits is an experimental poller to get the current bandwidth
// usage on the Livebox interfaces.
type InterfaceNetDevMbits struct {
client livebox.Client
client *livebox.Client
interfaces []*exporterLivebox.Interface
bitrate *bitrate.Bitrate
txMbits, rxMbits *prometheus.GaugeVec
}

// NewInterfaceNetDevMbits returns a new InterfaceNetDevMbits poller.
func NewInterfaceNetDevMbits(client livebox.Client, interfaces []*exporterLivebox.Interface) *InterfaceNetDevMbits {
func NewInterfaceNetDevMbits(client *livebox.Client, interfaces []*exporterLivebox.Interface) *InterfaceNetDevMbits {
return &InterfaceNetDevMbits{
client: client,
interfaces: interfaces,
Expand Down
4 changes: 2 additions & 2 deletions internal/poller/wan.go
Original file line number Diff line number Diff line change
Expand Up @@ -14,13 +14,13 @@ var _ Poller = &WANMbits{}
// WANMbits is an experimental poller to get the current bandwidth usage on the
// WAN interface of the Livebox.
type WANMbits struct {
client livebox.Client
client *livebox.Client
bitrate *bitrate.Bitrate
txMbits, rxMbits prometheus.Gauge
}

// NewWANMbits returns a new WANMbits poller.
func NewWANMbits(client livebox.Client) *WANMbits {
func NewWANMbits(client *livebox.Client) *WANMbits {
return &WANMbits{
client: client,
bitrate: bitrate.New(InterfaceHomeLanMbitsMinDelay),
Expand Down
75 changes: 72 additions & 3 deletions main.go
Original file line number Diff line number Diff line change
Expand Up @@ -2,9 +2,12 @@ package main

import (
"context"
"crypto/tls"
"crypto/x509"
"errors"
"flag"
"fmt"
"io/ioutil"
"log"
"net/http"
"os"
Expand Down Expand Up @@ -37,10 +40,14 @@ var experimentalMetrics = []string{

func parseExperimentalFlag(
ctx context.Context,
client livebox.Client,
client *livebox.Client,
experimental string,
pollingFrequency *uint,
) (pollers []poller.Poller) {
if experimental == "" {
return nil
}

var (
interfaces []*exporterLivebox.Interface
err error
Expand Down Expand Up @@ -96,6 +103,50 @@ func parseExperimentalFlag(
return
}

func getHTTPClient() (*http.Client, error) {
liveboxCACertPath := os.Getenv("LIVEBOX_CACERT")

if liveboxCACertPath == "" {
return http.DefaultClient, nil
}

// Get the SystemCertPool, continue with an empty pool on error.
rootCAs, _ := x509.SystemCertPool()
if rootCAs == nil {
rootCAs = x509.NewCertPool()
}

certs, err := ioutil.ReadFile(liveboxCACertPath)
if err != nil {
return nil, fmt.Errorf("failed to read livebox CA cert: %w", err)
}

if ok := rootCAs.AppendCertsFromPEM(certs); !ok {
return nil, errors.New("no livebox CA cert was successfully added")
}

return &http.Client{
Transport: &http.Transport{
TLSClientConfig: &tls.Config{
RootCAs: rootCAs,
},
},
}, nil
}

func isFatalError(err error) bool {
if errors.Is(err, livebox.ErrInvalidPassword) {
return true
}

var certError *tls.CertificateVerificationError
if errors.As(err, &certError) {
return true
}

return false
}

func main() {
pollingFrequency := flag.Uint("polling-frequency", defaultPollingFrequency, "Polling frequency")
listen := flag.String("listen", ":8080", "Listening address")
Expand All @@ -110,10 +161,28 @@ func main() {
log.Fatal("ADMIN_PASSWORD environment variable must be set")
}

liveboxAddress := os.Getenv("LIVEBOX_ADDRESS")
if liveboxAddress == "" {
liveboxAddress = livebox.DefaultAddress
}

httpClient, err := getHTTPClient()
if err != nil {
log.Fatal(err)
}

client, err := livebox.NewClient(
adminPassword,
livebox.WithAddress(liveboxAddress),
livebox.WithHTTPClient(httpClient),
)
if err != nil {
log.Fatalf("Failed to create Livebox client: %v", err)
}

var (
ctx = context.Background()
registry = prometheus.NewRegistry()
client = livebox.NewClient(adminPassword)
pollers = poller.Pollers{
poller.NewDevicesTotal(client),
poller.NewInterfaceMbits(client),
Expand All @@ -136,7 +205,7 @@ func main() {
go func() {
for {
if err := pollers.Poll(ctx); err != nil {
if errors.Is(err, livebox.ErrInvalidPassword) {
if isFatalError(err) {
log.Fatal(err)
}

Expand Down
2 changes: 1 addition & 1 deletion pkg/livebox/discovery.go
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,7 @@ func (i *Interface) IsWLAN() bool {
}

// DiscoverInterfaces discovers network interfaces on the Livebox.
func DiscoverInterfaces(ctx context.Context, client livebox.Client) ([]*Interface, error) {
func DiscoverInterfaces(ctx context.Context, client *livebox.Client) ([]*Interface, error) {
var mibs struct {
Status struct {
Base map[string]struct {
Expand Down

0 comments on commit 4a5496d

Please sign in to comment.