ruins/mackerel-agent

docker-mackerel-agent

https://github.com/xruins/docker-mackerel-agent/actions/workflows/latest-build.yml/badge.svg](https://github.com/xruins/docker-mackerel-agent/actions/workflows/latest-build.yml) https://github.com/xruins/docker-mackerel-agent/actions/workflows/latest-light-build.yml/badge.svg](https://github.com/xruins/docker-mackerel-agent/actions/workflows/latest-light-build.yml)

镜像概述

docker-mackerel-agent是mackerel/mackerel-agent的变体镜像，旨在提供更灵活的插件管理能力和轻量级部署选项。该镜像支持多架构部署，适用于需要对服务器进行监控且对镜像体积有要求的场景。

核心功能与特性

• 自动化插件安装：支持通过环境变量配置实现插件自动安装
• 多架构支持：兼容arm64/armv7架构
• 轻量级选项：提供"latest-light"标签镜像，体积仅约80MB
• 插件灵活性：支持自定义安装第三方插件

镜像对比

使用场景

• 需要在arm架构设备上部署监控代理的场景
• 对镜像体积有严格要求的轻量化部署
• 需要安装自定义或第三方监控插件的场景
• 希望简化插件管理流程的监控环境

使用方法

基础使用

基础使用方法请参考https://github.com/mackerelio/docker-mackerel-agent/blob/master/README.md%E3%80%82

插件安装

通过设置mackerel_plugins环境变量，可在容器启动时自动安装指定插件。

Docker运行示例

bash
docker run -h `hostname` \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v /var/lib/mackerel-agent/:/var/lib/mackerel-agent/ \
  -e 'apikey=<API密钥>' \
  -e 'enable_docker_plugin=1' \
  -e 'mackerel_plugins="xruins/mackerel-plugins-hddtemp xruins/mackerel-plugins-nicehash-stats"' \
  --name mackerel-agent \
  -d \
  ruins/mackerel-agent:latest

参数说明

• -v /var/run/docker.sock:/var/run/docker.sock: 挂载Docker套接字，用于监控Docker容器
• -v /var/lib/mackerel-agent/:/var/lib/mackerel-agent/: 挂载数据目录，持久化代理数据
• -e 'apikey=<API密钥>': 设置Mackerel API密钥
• -e 'enable_docker_plugin=1': 启用Docker插件监控
• -e 'mackerel_plugins="插件仓库1 插件仓库2"': 指定需要安装的插件，多个插件用空格分隔

注意：mackerel_plugins中指定的插件仓库必须兼容mkr plugin install命令的安装方式。