Prometheus Exporter

插件

· 作者 hank880907

一个 PaperMC 插件,通过 HTTP 端点将服务器指标暴露给 Prometheus。

0 本站下载 0 关注 更新于 6 个月前

最新 0.0.1-beta.1 · 26.1.2 · Paper

一键开服(送7天)

Prometheus Exporter

一个 PaperMC 插件,通过 HTTP 端点将服务器指标暴露给 Prometheus。

指标端点默认在端口 9940 上自动启动。

配置

plugins/PrometheusExporter/config.yml:

metrics-port: 9940
collection-interval-ticks: 20   # 20 ticks = 1 second

抓取

将 Prometheus 指向:

http://<server-ip>:9940/metrics

示例 prometheus.yml:

scrape_configs:
  - job_name: minecraft
    static_configs:
      - targets: ["<server-ip>:9940"]

指标

服务器

Metric Labels Description
mc_tps window (1m, 5m, 15m) 每秒刻数 (TPS)
mc_mspt_milliseconds — 平均每刻毫秒数(最近 100 刻)
mc_tick_time_milliseconds quantile (max, p95) 最近 100 刻的刻持续时间分位数
mc_players_online — 当前在线玩家数量
mc_players_max — 最大玩家槽位
mc_current_tick — 单调递增的刻计数器
mc_worlds — 当前加载的世界数量

按世界

Metric Labels Description
mc_world_players world 每个世界的玩家数量
mc_world_loaded_chunks world 每个世界已加载的区块数量
mc_world_entities world 每个世界的实体总数
mc_world_entities_by_type world, type 按类型细分的实体数量(例如 zombie, cow)每世界
mc_world_tile_entities world 每个世界的方块实体数量
mc_world_ticking_tile_entities world 每个世界正在更新的方块实体数量
mc_world_time world 游戏内时钟(0–24000);追踪昼夜循环
mc_world_storm world 如果风暴活跃则为 1,否则为 0
mc_world_thundering world 如果雷暴活跃则为 1,否则为 0

按玩家

Metric Labels Description
mc_player_ping_milliseconds player 每位玩家的延迟
mc_player_health player 每位玩家的当前生命值
mc_player_max_health player 每位玩家的最大生命值(当应用自定义属性时有用)
mc_player_food_level player 每位玩家的饥饿值(0–20)
mc_player_saturation player 每位玩家的饱和度(0.0–20.0+)
mc_player_xp_level player 每位玩家的 XP 等级
mc_player_xp_progress player 当前等级内的 XP 进度分数(0.0–1.0)
mc_player_total_experience player 每位玩家累计的总 XP
mc_player_flying player 如果玩家正在飞行则为 1,否则为 0
mc_player_gamemode player 数值型当前游戏模式(0 = 生存, 1 = 创造, 2 = 冒险, 3 = 旁观者)

JVM

Metric Labels Description
jvm_* various JVM 堆内存、GC、线程、类加载器

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源