README.md

mackerel-agent-plugins

This is the official plugin pack for mackerel-agent, a piece of software which is installed on your hosts to collect metrics and events and send them to Mackerel.

Detailed specs of plugins can be viewed here: ENG mackerel-agent specifications, JPN mackerel-agent 仕様.

Documentation for each plugin is located in its respective sub directory.

• mackerel-plugin-accesslog
• mackerel-plugin-apache2
• mackerel-plugin-aws-cloudfront
• mackerel-plugin-aws-dynamodb
• mackerel-plugin-aws-ec2-cpucredit
• mackerel-plugin-aws-ec2-ebs
• mackerel-plugin-aws-elasticache
• mackerel-plugin-aws-elasticsearch
• mackerel-plugin-aws-elb
• mackerel-plugin-aws-kinesis-streams
• mackerel-plugin-aws-lambda
• mackerel-plugin-aws-rds
• mackerel-plugin-aws-s3-requests
• mackerel-plugin-aws-ses
• mackerel-plugin-conntrack
• mackerel-plugin-docker
• mackerel-plugin-elasticsearch
• mackerel-plugin-fluentd
• mackerel-plugin-gostats
• mackerel-plugin-h2o
• mackerel-plugin-haproxy
• mackerel-plugin-inode
• mackerel-plugin-jmx-jolokia
• mackerel-plugin-jvm
• mackerel-plugin-linux
• mackerel-plugin-mailq
• mackerel-plugin-mcrouter
• mackerel-plugin-memcached
• mackerel-plugin-mongodb
• mackerel-plugin-mssql
• mackerel-plugin-multicore
• mackerel-plugin-munin
• mackerel-plugin-mysql
• mackerel-plugin-nginx
• mackerel-plugin-openldap
• mackerel-plugin-php-apc
• mackerel-plugin-php-fpm
• mackerel-plugin-php-opcache
• mackerel-plugin-plack
• mackerel-plugin-postgres
• mackerel-plugin-proc-fd
• mackerel-plugin-rabbitmq
• mackerel-plugin-rack-stats
• mackerel-plugin-redash
• mackerel-plugin-redis
• mackerel-plugin-sidekiq
• mackerel-plugin-snmp
• mackerel-plugin-solr
• mackerel-plugin-squid
• mackerel-plugin-td-table-count
• mackerel-plugin-trafficserver
• mackerel-plugin-twemproxy
• mackerel-plugin-unicorn
• mackerel-plugin-uptime
• mackerel-plugin-uwsgi-vassal
• mackerel-plugin-varnish
• mackerel-plugin-windows-process-stats
• mackerel-plugin-windows-server-sessions

Installation

Install mackerel-agent

ENG https://mackerel.io/docs/entry/howto/install-agent JPN https://mackerel.io/ja/docs/entry/howto/install-agent

If the mackerel-agent has already be installed this step can be ignored.

Install mackerel-agent-plugins

Install the plugin pack from either the yum or the apt repository. To setup these package repositories, see the documentation regarding the installation of mackerel-agent (rpm / deb).

mackerel-agent-plugins will be installed to /usr/bin/mackerel-plugin-* (and some plugins are symlinked as /usr/local/bin/mackerel-plugin-*, for backward compatibility.).

yum

yum install mackerel-agent-plugins

apt

apt-get install mackerel-agent-plugins

Go

mackerel-agent-plugins supports two newer versions of Go.

go install github.com/mackerelio/mackerel-agent-plugins/...@latest

Caution

Some plugins may not work on CentOS/RedHat 5 because the golang compiler (gc) doesn't support the old kernel. (https://golang.org/doc/install)

Some plugins are not contained in rpm and deb packages. If you want to use them, build them.

Contribution

• see The official plugin registry and Pull requests to the existing central repository
• fork it
• develop the plugin you want
• create a pullrequest!

License

Copyright 2014 Hatena Co., Ltd.

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.