Skip to content

Latest commit

 

History

History
91 lines (69 loc) · 3.6 KB

README.md

File metadata and controls

91 lines (69 loc) · 3.6 KB
Raw
____                  _        ____  _             
/ ___| _ __ ___   ___ | | _____|  _ \(_)_ __   __ _ 
\___ \| '_ ` _ \ / _ \| |/ / _ \ |_) | | '_ \ / _` |
 ___) | | | | | | (_) |   <  __/  __/| | | | | (_| |
|____/|_| |_| |_|\___/|_|\_\___|_|   |_|_| |_|\__, |
                                              |___/

Original Authors: Tobias Oetiker and Niko Tyni

Build Test

SmokePing is a latency logging and graphing and alerting system. It consists of a daemon process which organizes the latency measurements and a CGI which presents the graphs.

SmokePing is ...

  • extensible through plug-in modules

  • easy to customize through a webtemplate and an extensive configuration file.

  • written in perl and should readily port to any unix system

  • an RRDtool frontend

  • able to deal with DYNAMIC IP addresses as used with Cable and ADSL internet.

cheers tobi

Smokeping changes

A live version of Smokeping hosted by sjultra can be found here

smokepingkube.vzxy.net

TODO

  • enable our docker image to accept volume mounts for config/config so users of our image can provide their own configuration file or customise the default configuration file
  • redirect / to /smokeping/smokeping.fcgi.dist

NOTES

Smokeping configuration defaults

A default smokeping configuration can be found in config/config.

The Smokeping UI is enabled by default and is configured with config/smokeping.conf

Enable writes to influxDB

  • To enable smokeping to write generated metrics to an InfluxDB instance, add the following block to your smokeping config file. Update values to map to your InfluxDB instance
*** InfluxDB ***
host = influxdb:8086
database = smokeping
timeout = 10
port = 8086
username = admin
password = password

Enable the smokeping Grafana dashboard

  • To enable the smokeping Grafana dashboard, run your Grafana instance and enable it to communicate with your running . There are many ways to approach this. Below is an example of how to configure Grafana with Smokeping using docker compose.
    • GF_SECURITY_ADMIN_PASSWORD is your default Grafana user password. Unless you've configured it explicitly, the default Grafana username will be admin. See Grafana docs for more info.
    • The /etc/grafana/provisioning/dashboards volume mount is where your Grafana dashboard configuration will live (dashboard.yml, smokeping.json). You can roll your own dashboard, or use our recommended default, found here.
    • The /etc/grafana/provisioning/datasources volume mount is where your Grafana datasource for InfluxDB will live (i.e; influxdb.yml). You can roll youe own datasource configuration, or use our recommended default, found here.
  • If you use our recommended defaults, be sure to update values for your InfluxDB instance where applicable in the provided files.
grafana:
    image: grafana/grafana:10.1.2
    environment:
      - GF_SECURITY_ADMIN_PASSWORD=admin
      - GF_AUTH_ANONYMOUS_ENABLED=true
    volumes:
      - ./grafana/dashboards:/etc/grafana/provisioning/dashboards
      - ./grafana/datasources:/etc/grafana/provisioning/datasources
    ports:
      - 3000:3000
    restart: always
    depends_on:
      - "influxdb"