Dark Mode

Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

webdevops/myuplink-exporter

Repository files navigation

myUplink.com exporter

A Prometheus exporter for myuplink.com device metrics

Usage

Usage:
myuplink-exporter [OPTIONS]

Application Options:
--log.level=[trace|debug|info|warning|error] Log level (default: info) [$LOG_LEVEL]
--log.format=[logfmt|json] Log format (default: logfmt) [$LOG_FORMAT]
--log.source=[|short|file|full] Show source for every log message (useful for debugging and bug reports) [$LOG_SOURCE]
--log.color=[|auto|yes|no] Enable color for logs [$LOG_COLOR]
--log.time Show log time [$LOG_TIME]
--myuplink.url= Url to myUplink API (default: https://api.myuplink.com) [$MYUPLINK_URL]
--myuplink.auth.clientid= ClientID from myUplink [$MYUPLINK_AUTH_CLIENTID]
--myuplink.auth.clientsecret= ClientSecret from myUplink [$MYUPLINK_AUTH_CLIENTSECRET]
--myuplink.device.allowed-connectionstates= Allowed device connection states (default: Connected) [$MYUPLINK_DEVICE_ALLOWED_CONNECTIONSTATES]
--myuplink.device.calc-total-parameters= Calculate total metrics for these parameters (eg. energey log parameters) [$MYUPLINK_DEVICE_CALC_TOTAL_PARAMETRS]
--server.bind= Server address (default: :8080) [$SERVER_BIND]
--server.timeout.read= Server read timeout (default: 5s) [$SERVER_TIMEOUT_READ]
--server.timeout.write= Server write timeout (default: 10s) [$SERVER_TIMEOUT_WRITE]

Help Options:
-h, --help Show this help message

Auth (Client id and secret)

Register an application at myUplinkDEVS to get client id and secret for your application.

HTTP Endpoints

Endpoint Description
/metrics Default prometheus golang metrics
/probe Probe devices metrics from myuplink.com

/probe

GET parameter Default Required Multiple Description
cache no no Cache time in time.Duration (eg. 30s or 5m)

Metrics

Metric Description
myuplink_system_info System information
myuplink_system_device_info Device information (belongs to a system)
myuplink_system_device_point Device parameter metric point

About

Prometheus exporter for myuplink.com

Topics

Resources

Readme

License

MIT license

Stars

Watchers

Forks

Packages

Contributors