はじめに

先月、AmazonがOpen Distro for Elasticsearch (以下、ODFE)を発表してしばらく経ちました。そろそろ使ってる人もいますよね。
使ってるとなれば、監視が必要になるわけです。

Mackerel には公式プラグイン mackerel-plugin-elasticsearch がありますが、こちらは標準的なElasticsearchが対象のプラグインです。
記事執筆時点(2019/04/08)では、ODFEにはODFE特有の挙動があり、それに合わせたプラグインが必要でした。

それを作りましたという記事です。

mackerel-plugin-odfe プラグインの紹介

mackerel-plugin-odfe プラグインはこちらです。

リポジトリのREADMEにも書いていますが、 mackerel-plugin-odfe は、公式のプラグイン mackerel-plugin-elasticsearch をforkして、下記の変更を加えたプラグインです。

なぜ公式にプルリクエストしないのかって？

実装も挙動もElasticsearchとあまりに共通点が多いけれど、別物として扱わないとそれはそれで問題になりそうな箇所が幾つもあったからです。その分岐を考えたコードやテスト環境を整えるのも面倒でした。

以上より、 手抜きの結果として 別のリポジトリにアップロードしています。

OSSの精神に反しますよね・・・
せめて更新内容がわかりやすいように、この記事に記しておきます。

インストールする場合は、 mkr インストール済みの環境であれば、以下でOKです。

インストール

sudo mkr plugin install etsxxx/mackerel-plugin-odfe

mackerel-agentの設定ファイルに以下のように追記しましょう。（パスやオプションは注意）

mackerel-agent.conf

[plugin.metrics.elasticsearch]
command = "/path/to/mackerel-plugin-odfe -scheme=https"
env = { ES_USER = "USERNAME", ES_PASSWORD = "PASSWORD" }

※ 使い方について、詳しくはREADME or ヘルプを見てください。

設定が正しければ、以下のようなメトリックが出力されるはずです。（一部メトリックをスクリーンショットしています）

せっかくユーザー認証しているのに、Adminユーザーを使ってしまったら権限分離の観点でイマイチですね。
Securityプラグインで、以下のようなユーザー/ロールを作りましょう。

Roleメニューより、新規に「monitor」ロールを作ります。権限は以下の通り。

Index Permissions:
- Index and Document type: *.*
- Permissions: Action Groups: INDICES_MONITOR

※ 今後必要な権限が変わることもあるかもしれませんが、本記事執筆時点では上記でOKでした。

その後 User メニューで「monitor」ユーザーを作り、 Role Mappings メニューで先程の monitor ロールとマップしましょう。

mackerel-agent.conf の ES_USER と ES_PASSWORD を、そのユーザー情報で置き換えればOKです。

v0.0.1時点では、公式のElasticsearchプラグインと以下の部分で実装が異なります。

差分はあるものの、マイナーチェンジと言っても差し支えない内容であり、互換的に利用できるとは思います。（実際、オプションやREADMEのExample記述も互換にしています）

以上で、Open Distro for Elasticsearch用のMackerelプラグイン mackerel-plugin-odfe の紹介でした。
Mackerel公式ElasticsearchプラグインがODFEに対応するまでの間の「繋ぎ」として機能するかと思います。