Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/minetest-monitoring/monitoring

Monitoring mod for minetest server owners
https://github.com/minetest-monitoring/monitoring

grafana minetest mod monitoring prometheus

Last synced: 26 days ago
JSON representation

Monitoring mod for minetest server owners

Host: GitHub
URL: https://github.com/minetest-monitoring/monitoring
Owner: minetest-monitoring
License: other
Created: 2019-03-03T19:03:39.000Z (over 5 years ago)
Default Branch: master
Last Pushed: 2024-09-06T12:09:46.000Z (2 months ago)
Last Synced: 2024-09-27T15:41:03.131Z (about 1 month ago)
Topics: grafana, minetest, mod, monitoring, prometheus
Language: Lua
Homepage: https://forum.minetest.net/viewtopic.php?f=9&t=22472
Size: 437 KB
Stars: 19
Watchers: 8
Forks: 9
Open Issues: 2
Metadata Files:
- Readme: README.md
- License: license.txt

Awesome Lists containing this project

README

        # Monitoring framework for minetest

Provides a [prometheus](https://prometheus.io) monitoring endpoint (via push-gateway).

![](https://github.com/minetest-monitoring/monitoring/workflows/luacheck/badge.svg)

![](https://github.com/minetest-monitoring/monitoring/workflows/test/badge.svg)

[![License](https://img.shields.io/badge/License-MIT-green.svg)](license.txt)

[![Coverage Status](https://coveralls.io/repos/github/minetest-monitoring/monitoring/badge.svg?branch=master)](https://coveralls.io/github/minetest-monitoring/monitoring?branch=master)

## Demo

* [monitoring.minetest.ch](https://monitoring.minetest.ch/d/YUpouLmWk/lua-server-monitoring-mod?tab=visualization&orgId=1&refresh=5s&var-instance=pandorabox.io)

## Documentation

* [Custom metrics](doc/custom.md)

* [Exporters](doc/exporters.md)

* [Chat commands](doc/chatcommands.md)

* [Installation of the mod](doc/install.md)

* [Hosted](doc/hosted.md)

* [Docker](doc/docker.md)

* [Installation of the tools (without docker)](doc/standalone.md)

## Features

* Builtin metrics (lag, mapgen, time, uptime, auth, etc.).

* Supports the **gauge**, **counter** and **histogram** metrics.

## Mod integrations

* advtrains

* technic

* mesecons

* digtron

* protector

## Screenshots

![](./pics/lag.png?raw=true)

![](./pics/craft.png?raw=true)

# Pipeworks Features

* Tubed item management (flushing)

* Enable and disable pipeworks at runtime

* Item expiration (tubed items only stay 10 minutes in the pipes)

* Item injection limit per mapchunk

# Chatcommands

* **/pipeworks_flush** flushes (removes) all items in the tubes

* **/pipeworks_stats** shows the item count

* **/pipeworks_enable** enables the pipeworks mod at runtime

* **/pipeworks_disable** disables the pieworks mod at runtime

* **/pipeworks_check_limit** check the injection limits on the current mapchunk

* **/pipeworks_limit_stats** shows the chunk with the highest injection rate

## Metric controller

Usage:

Reading:

```lua

if event.type == "program" then

  -- query metric by its name

  digiline_send("ctrl_channel", "pipeworks_entity_count")

end

if event.type == "digiline" and event.channel == "ctrl_channel" then

  print("Pipeworks entities: " .. event.msg)

end

```

Writing:

```lua

digiline_send("channel", {

	metric = "ingame_lua_tube_mese",

	help = "my mese lua tube count"

	counter = true,

	increment = true,

	value = 20

})

```

## License

* Code: MIT

* textures/monitoring_controller_top.png

  * CC BY-SA 3.0 https://cheapiesystems.com/git/digistuff