Litter Exporter

Litter Exporter is a Prometheus exporter for the Litter Robot.

This exporter uses an experimental API. The upstream Litter Robot API is not publicly documented and may cause breaking changes with no notice. Breaking changes will be handled as soon as possible.

Example

An example Docker Compose configuration is contained in the doc/examples folder.

To run this example, substitute values for email and password and run docker-compose up.

Metrics

Metrics are available at the default and metrics endpoints (/ and /metrics respectively).

Labels

Usage

The Litter Exporter can be installed on a target machine or executed in a Docker container. The configuration options are the same for both.

Docker

$ docker run --rm -p 9080:9080 tlkamp/litter-exporter:latest \
    --email "your-email@example.com" \
    --password "your-password"

CLI

$ ./litter-exporter --help
Usage of ./litter-exporter:
      --address string     the server address (default "0.0.0.0:9080")
      --email string       litter robot account email address
  -h, --help               print help and exit
      --log-level string   the log level (default "info")
      --password string    litter robot account password

Configuration

The litter robot requires only two pieces of information for configuration: the account email address and password.

The other fields are optional and provided as a convenience in case the upstream Litter Robot API changes.

Environment Variables

All CLI options can be configured as environment variables. Environment variables are all-caps (uppercase) and prefixed with LR_.

If CLI arguments contain hyphens (-), use an underscore as a replacement in environment variable names.

Example:

$ export LR_EMAIL="your-email-address@example.com"
$ export LR_PASSWORD="yourPassword"
$ export LR_LOG_LEVEL=debug
$ ./litter-exporter

Unit Status

The unit status is represented by a non-negative integer.