ミドルウェアのメトリック可視化に公式プラグイン集を使う

各種ミドルウェアに対応した公式プラグイン集を利用して簡単にミドルウェアのメトリックを収集できます。動作確認環境は、mackerel-agentと同一ですので、Mackerelの概説の動作環境をご参照ください。

AWS ELB・AWS RDSなど、mackerel-agentをインストールできないAWSクラウド環境はAWSインテグレーションをご利用ください。サービスメトリックとして投稿するためには、fluentdをご利用ください。詳しくは「AWSのCloudWatchのメトリックからELB関連のメトリックをサービスメトリックに投稿する」をご参照ください。

プラグイン集の一覧は、下記READMEをご参照ください。

github.com

公式プラグイン集をインストールする(Linux系OSの場合)

インストールにはお使いの環境に合わせてyumリポジトリもしくはaptリポジトリを使うことを推奨しています。リポジトリの設定方法は「Mackerelエージェントをインストールする」をご参照ください。rpmファイルやdebファイルを直接取得したい場合は、GitHub Releasesを参照してください。

rpmパッケージの場合

sudo yum install mackerel-agent-plugins

アップデートの際は、以下のコマンドでおこなうことができます。

sudo yum update mackerel-agent-plugins

debパッケージの場合

sudo apt-get install mackerel-agent-plugins

アップデートの際は、以下のコマンドからおこなうことができます。

sudo apt-get update
sudo apt-get install mackerel-agent-plugins

公式プラグイン集をインストールする(Windows Serverの場合)

Windows Server で公式プラグイン集を利用する場合、エージェントに同梱されているプラグインを利用すると便利です。(エージェントのインストール方法については「Mackerelエージェントをインストールする」を参照してください。)

同梱されているプラグイン一覧は、GitHubリポジトリにある同梱プラグインリストを参照してください。同梱されていないプラグインについては、公式でのサポート対象外となっていることに加えて、ご自身でビルドを実施していただく必要があります。

エージェントをアップデートすることで同梱のプラグインもアップデートされます。アップデート方法についてはWindowsにmackerel-agentをインストールするを参照してください。

公式プラグイン集を利用する(Linux系OSの場合)

各プラグインは/usr/binにインストールされていますので、mackerel-agentの設定ファイルに利用するプラグインに合わせて以下のような設定を追加してください。設定の反映には、mackerel-agentの再起動が必要です。

Apache2用プラグインの場合

[plugin.metrics.apache2]
command = ["mackerel-plugin-apache2"]

各プラグインの利用方法の詳細は、後述のGitHubにある各プラグインのREADMEを参照してください。

公式プラグイン集を利用する(Windows Serverの場合)

上述のとおり、Windows Server で公式プラグイン集を利用する場合、エージェントに同梱されているプラグインを利用すると便利です。同梱されているプラグインを利用する場合、各プラグインはエージェントのインストールフォルダに格納されており、パスも通っています。mackerel-agentの設定ファイルに利用するプラグインに合わせて以下のような設定を追加してください。設定の反映には、mackerel-agentの再起動が必要です。

「mackerel-plugin-mssql」プラグインを使う場合は以下のようになります。

[plugin.metrics.mssql]
command = ["mackerel-plugin-mssql"]

各プラグインの利用方法の詳細は、後述のGitHubにある各プラグインのREADMEを参照してください。

プラグイン集のコード

公式のプラグイン集は、GitHub - mackerelio/mackerel-agent-plugins: Plugins for mackerel-agentで公開されています。 新しいミドルウェアに対応するプラグインのPull Requestなど、いつでもお待ちしています。

プラグインを作るためにはホストのカスタムメトリックを投稿するを参照してください。