prometheus-piped/README.md
Kumi dd890f1708
feat: Fork exporter to Prometheus Piped
Forked the allkeyshop.com game price exporter for a Prometheus exporter for Piped instances, focusing on tracking registered users. This shift addresses the need for monitoring Piped, a self-hosted alternative to YouTube, instead of game pricing data. The changes include:

- Updated the .gitignore, LICENSE, README.md, and requirements.txt to reflect the new functionality and dependencies.
- Removed the allkeyshop.py script in favor of a new script, prometheus_piped.py, designed to fetch and expose the number of registered users from multiple Piped instances.
- Transitioned configuration management from settings.ini to config.yaml for improved flexibility and readability.
- Updated licensing information to include contributions from the Private.coffee Team, extending copyright to 2024.

This enhancement allows users to monitor the growth and usage of their Piped instances directly from their Prometheus setups, aligning with the community's move towards self-hosted, privacy-respecting services.
2024-05-23 11:50:25 +02:00

907 B

Prometheus Exporter for Piped instances

This is a simple exporter for Prometheus that gets statistics from Piped instances. Currently, it only supports getting the number of registered users.

Prerequisites

  • Python >= 3.8
  • prometheus-client, pyyaml (pip install -r requirements.txt)

Configuration

The exporter is configured using config.yaml. The provided config.dist.yaml is a template for the configuration file.

To add a new instance, simply add its API URL to the piped list.

Usage

To run the exporter, simply execute the prometheus_piped.py script. The exporter will listen on port 8098.

A sample output of the exporter looks like this:

# HELP registered_users Number of registered users
# TYPE registered_users gauge
registered_users{domain="api.piped.private.coffee"} 54.0

License

This project is licensed under the MIT License - see the LICENSE file.