Mackerel で使用されている用語とその解説です。
サービス
Mackerelにおいて、サービスとはホストを運用する上でもっとも大きな単位です（例: 「はてなブックマーク」「社内システム（勤怠管理）」など）。通常、複数のホストがそれぞれの「役割」（→ ロール）を担当し、協調しあってひとつのサービスを形づくります。関係しあうホストをひとつのサービスに属するものとしてまとめることで、ホストの管理・監視が容易になります。Mackerel における「サービス」については、「サービス」「ロール」とは - Mackerel ヘルプも参照してください。
ロール
ロールはサービスに所属するホストをさらにその「役割」（アプリケーション、データベース、etc…）によって分類する概念です。Mackerelではホストの状況をロールごとにまとめて可視化できます。Mackerel における「ロール」については、「サービス」「ロール」とは - Mackerel ヘルプも参照してください。
ホスト
エージェントが動く OS インスタンスひとつ（仮想化されたものを含む）に対応します。ひとつのホストには複数のロール（およびサービス）を割り当てられます。Mackerel における「ホスト」については、「ホスト」とは - Mackerel ヘルプも参照してください。
ステータス: ホストは standby/maintenance/working といった、ホストの状況を管理するためのステータスを持ちます。運用の際にこのステータスを更新することで、新規ホストのセットアップ〜サービスへの投入〜ホストの撤退というフローをMackerel上で実現できます。
ホストID: Mackerelは各ホストをホストIDで識別します。ホストIDはmackerel-agentが動作しているホスト上のファイル/var/lib/mackerel-agent/idに保存されています。そのため、/var/lib/mackerel-agent/idが別ホストにコピーされると実際は複数のホストがMackerel上では同一のホストと認識され、メトリックの投稿や監視が正しく動作しなくなりますので注意してください。
オーガニゼーション
Mackerelを利用する会社・組織・個人を指します。Mackerelのユーザーアカウントはいずれかのオーガニゼーションに所属します。ホストやサービスの情報がオーガニゼーションの枠を越えて共有されることはありません。
他のオーガニゼーションに使用されている名前のオーガニゼーションを新たに作成することはできません。
また1つのオーガニゼーションに複数のユーザーが所属したり、1人のユーザーが個人用と会社用といった複数のオーガニゼーションに所属することもできます。
メトリック
mackerel-agent が定期的に収集するホストの状況です。CPU・メモリの利用状況や、IOの量などが計測され、Mackerelのサーバに自動的に送信されます。ウェブ上でこれらの値をグラフィカルに確認できます。
sensuプラグイン互換のシンプルなプロトコルで、ユーザー定義のメトリックを登録することも可能です。
メトリクスとも表記されますが、Mackerelではメトリックで統一しています。
ラベル付きメトリック
ラベル付きメトリックは OpenTelemetry の仕様に準拠した機能です。OpenTelemetry のエコシステムを利用してメトリックを Mackerel に投稿できます。
Mackerel に投稿されたラベル付きメトリックは PromQL クエリ言語を用いてグラフに表示・監視することができます。
2024 年 2 月時点では、この機能はパブリックベータ版として提供されています。
