Instanaのイベント、チョットワカル#2

はじめに

こんばんは。
金カムに爆ハマりしている古川がお届けします、
Instana Observability Advent Calendar 2023 15日目です。

6日目はInstanaのイベント、チョットワカル#1ということで、　　
Instanaの主要機能の1つであるイベント機能について書きました。

今日はその続編です。今回は、イベントの構成要素や作成/管理に関するお話をします。　　

対象とする読者の方

• Instanaを検討中の方、利用開始してまもない方
• 「イベント」「アラート」「組み込みメトリック」などの各種用語や設定項目を前に挫折してしまった方。心が折れそうな方。

Instanaのイベント、チョットワカル#1 を先に読んで頂いた方が、理解が深まると思うので、まだ#1をお読みでない方はそちらを先に読んでみてください！

ゴール

Instanaのイベント、チョットワカル！

本編

イベントの構成要素（メトリックとイベント）

そもそもInstanaのイベントとは、「いつ、どこで、何が起きたか、どれくらい重要か」を示すものです。　　

• 「いつ」は読んで字の如くなので、割愛します。
• 「どこで」を示すのが後述するスコープです。例えば、「ECサイトAで」「社内アプリケーションB」で「MySQL上で」などです。
• 「何が起きたか」に関連するのがメトリックとイベントです。

メトリックは監視項目を表していて、イベントはその監視項目がどんな状態にあるかを示しています。

例1. アプリケーション監視の場合：アプリケーションに対する「呼び出し数」がメトリックで、「呼び出し数が増えた(減った）」がイベントです。

例2. サーバ監視の場合：「cpu.wait」がメトリックで、「CPUの入出力に多くの時間が費やされている」がイベントです。

• 「どれくらい重要か」は、Instanaのイベント、チョットワカル#1 でお話した、インシデントなのか問題なのか、クリティカルなのか警告なのかということです。

＞「何が起きたか」に関連するのがメトリックとイベント
というお話をしましたが、ここをもう少しドリルダウンしてみます。　　

メトリック

メトリックは以下2種類が存在します。

• 組み込みメトリック
• カスタムメトリック

組み込みメトリック

組み込みメトリックは、Instanaにデフォルトで組み込まれている監視項目です。　
例：

• PostgreSQLの組み込みメトリック
  • コネクションの使用率
• IBM Db2の組み込みメトリック
  • 表スペース・ユーティリティー
  • HADR_CONNECT_STATUS

カスタムメトリック

一方、カスタムメトリックは、「使いたい監視項目が組み込みメトリックでは具備されていないな...」という時に使うものです。ただし、なんでも自由に設定できるわけではなく、Instanaのモニター対象のアプリケーションが明示的に公開しているメトリックのみ利用できます。例えば、以下のカスタム・メトリックをInstanaで利用できます

• Dropwizard メトリック
• Finagle メトリック
• JMX メトリック
• Prometheus メトリック
• statsd メトリック
  など

つまり、Instana内で組み込みメトリック以外で何のメトリックを利用できるかは、上記、監視ソフトウェアやサービスの仕様に依存するということです。

イベント

• 組み込みイベント
• カスタムイベント　の2種類が存在します。

組み込みイベント

• Instana側でデフォルトで用意されたイベント
  • 組み込みメトリックこと監視項目と、その状態の組み合わせのこと。
• エンティティー・タイプごと、つまり、Instanaの監視対象テクノロジーごとに様々なイベントが組み込みで用意されている。
• メリット：監視定義の手間を省くことができる。

例

• ホストにおいてToo many open file(ファイルを開きすぎている)
• TomcatにおいてThreads number reached maximum(スレッド数が最大値に達した)
  

カスタムイベント

• 自分で独自に作成できるイベント。
• 実現したい監視定義が組み込みイベントで実装されていない時に利用。
• 組み込みメトリック or カスタムメトリック を紐づけることが可能。

例
IBM Db2の場合は、以下の組み込みメトリック及びイベントが具備されています。

• 組み込みメトリック：表スペース・ユーティリティー
• 組み込みイベント：表スペース・ユーティリティー・メトリックの状況(表スペースとそのメトリックに関連するイベントの確認を促すイベント)

でもこれだと具体性にちょっと欠けてしまいますよね？また、データベース監視の場合は表領域の使用率なども気になるところです。

このように「Instanaの組み込みイベントには具備されていないけど、もっとこういう監視をしたい!」という場合に、カスタムイベントを作成する必要があります。実装レベルでいうと、Instanaの設定>イベントページから「新規イベント」を選択して、新たにイベントを作成する必要があるということです。

これを利用すれば、例えばですが、Db2の表領域使用率の監視も可能になります。



最後にメトリックとイベントの関係性をまとめると以下の通りです。

• 組み込みイベントに紐付くのは組み込みメトリック
• カスタムイベントに紐付くのは組み込みメトリック or カスタムメトリック

カスタムイベントの作り方

では、次はカスタムイベントの作り方について詳しく述べます。

組み込みイベントは、自分で作成する必要はないです。既に組み込まれたものだからです。Instanaの監視対象のアプリやインフラに問題が起これば、勝手にイベントとして起票されます。

1. Instana GUIのTOP画面にて、左側のメニューバーから設定（歯車マーク）を選択。

2. イベントとアラートから イベントを選択。
   

3. 2の画面から新規イベントを選択。
   

4. イベントの詳細を入力（「何が起きたか」「どれくらい重要か」に相当）
   4-1. 名前 説明 問題の重大度 インシデントとして取り扱うか否か 猶予期間を入力します。
   ＊ 猶予期間：条件に一致しなくなった場合にその問題をクローズするまでの時間。
   
   

5. 条件を入力（「何が起きたか」に相当）
   5-1. ソース：組み込みメトリック カスタムメトリックのいずれかを選択。
   組み込みメトリックを選択した場合：(A)へ。
   カスタムメトリックを選択した場合：(B)へ。

   (A)
   5-2. エンティティー・タイプ：何のメトリックをイベントに紐づけるのかを
   　　　　　　　　　　　　　　選択。今回はJVMを例とする。
   5-3. 時間枠：プルダウンから任意の時間を選択。
   5-4. 任意のメトリックを選択。　　
   　　 JVMであれば、スレッド数などに関するメトリックが取得可能。
   

   (B)
   5-2. エンティティ-・タイプ：以下から任意のものを選択。
   - Dropwizard メトリック
   - Finagle メトリック
   - JMX メトリック
   - カスタム・パフォーマンス・カウンター
   - Prometheus メトリック
   - statsd メトリック
   5-3. 時間枠：プルダウンから任意の時間を選択。
   5-4. 任意のメトリックを選択。
   

6. スコープを設定（「どこで」に相当）
   当該イベントのスコープを選択する。選択肢は以下の３通り。
   

まとめ

• メトリックは 組み込みメトリック カスタムメトリック　の2種類が存在。　　

• イベントは 組み込みイベント カスタムイベント　の2種類が存在。　　

• イベントは組み込みメトリックとカスタムメトリックに紐づく。

  • 作成の必要性や紐づくメトリックによって、イベントの呼称が変わる。
    • 組み込みイベント（作成不要）に紐付くのは組み込みメトリック
    • カスタムイベント（要作成）に紐付くのは組み込みメトリック or カスタムメトリック　　

• カスタムイベントのユースケース： 「組み込みイベントではちょっと監視が物足りない。もっと自社の運用に合わせて監視設定をカスタマイしたい」という場合利用。

• 裏を返せば、そのようなケースがない場合は、組み込みイベントの利用で十分。これを使えば、実装の手間は省けて、迅速に監視をスタートできる。

おわりに

いかがでしたでしょうか？言語化/体系化するのに、思いの外時間がかかりました。。。でもこういう情報があれば、設計や実装もスムーズにいくと思うので、どこかで誰かのお役に立てていれば嬉しく思います！

ではでは、皆様良い週末を！

改訂履歴

2024/8/19 組み込みイベント/メトリック、カスタムイベント/メトリックの説明を全体的に修正。