masarasiの日記

私は Mackerel CRE テクニカルサポート担当です。

チェック監視

チェック監視を設定したけどエラーになってしまうというお問い合わせは多い。エラーの原因はいろいろあるけど、案外プラグインがインストールされていないケースが結構ある。

それはなぜなのか。理由としては主に下記のようなものがあると思う。

  1. プラグインのインストールを忘れていた
  2. プラグインのインストールが必要なことを知らなかった
  3. プラグインはインストールしたつもりだったけどメトリックプラグインだった

1 は少なくともインストールが必要という意識はあるし、人間なのでしょうがない。しかし、残りは少し性質が違う。2 や 3 に関してはサービスを提供する側のガイドが不足しているのではないか。

Mackerelを使い始めるとおそらくは誰もが目にする導入マニュアルがある。これにはオーガニゼーション作成後にやることが書いてあり、ホスト登録やロール設定、監視ルールの設定、通知の設定、などの基本的な内容になっている。

しかし、プラグインについては書いていない。最後の段落に、もう少し進んだ使い方が書かれている下記のヘルプへのリンクがある。これはリンクが箇条書きになっているだけのかなり素朴な内容だし、導入マニュアルとかぶっている情報もあるので正直微妙である。

mackerel.io

また、ここにもプラグインについては直接書かれていない。カスタムメトリックの投稿についてのリンクがあるので、がんばって読み進めればメトリックプラグインのインストールまではたどり着けるかもしれない。しかし、チェック監視については導線がないのだ。思い返してみればメトリックプラグインがインストールされていなくてエラーになるというお問い合わせはあまり印象に残っていない。やはりチェック監視の存在に気づきづらい状況と言えそうだ。(とはいえ、メトリックプラグインへのガイドも適切かと言われるとそうでもない)

いちおうWebコンソールの監視ルール追加画面にチェック監視という項目があって、ここにはチェック監視を行う方法についてのリンクがある。もしかするとここで気づくユーザはいるかもしれない。しかし、チェック監視の存在はたまたま気づいたとか、見つけた、というものであってはいけなくて、Mackerelを使い始めてすぐの段階から選択肢として認識しておいてほしいもののはずだ。

使い始めのガイドをもっと親切にしてもよいかもな、と思った。