Smart Alerts for logsのご紹介

こんにちは、Instana Observability Advent Calendar 2024 6日目は足立よりお届けします。

# はじめに

みなさん、Instanaのスマート・アラートをご利用いただいていますか？
※まだの方はぜひこちらの記事を参考に触ってみてください！

https://qiita.com/mayamasaki68/items/fbf3f5164e12b22e8796

最近、Instanaはログ周りの機能強化を進めているのですが、その一環として build 282 にてログ向けのスマート・アラートが追加されています。([リリースノート](https://www.ibm.com/docs/en/instana-observability/current?topic=saas-build-282#smart-alerts-for-logs))
本記事では、執筆時点(build 286)で必要な権限の設定と、[Smart Alerts for logs](https://www.ibm.com/docs/en/instana-observability/current?topic=logging-smart-alerts)の設定をお見せしようと思います。

# 権限設定

:::note info
[分析] > [ログ] > [スマート・アラート]と進んだ画面にてアラートを作成しますが、権限がない場合は右下の[スマート・アラートの作成]ボタンが表示されないので権限を付与しましょう。
※表示されている方はこのステップをスキップしてください

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/118463/4e8e3c90-eea3-5923-d4b7-67c3f547acf3.png)
:::

今回は新規グループを作成し権限を付与します。
既存のグループ権限を修正しても問題ありません。

[設定] > [Security & Access] > [グループ] > [新規グループ]をクリックします。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/118463/33c00510-c17e-2fe1-99e0-f9e042dd79a8.png)

任意の グループ名 を入力して ログ・アクセス権 の **ログ用のグローバル・スマート・アラートの構成** のチェックを ON にて 保存 します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/118463/93002ac6-e368-6db5-d5e2-33c2979bdf33.png)

グループの作成ができたら、ユーザーに割り当てます。
真ん中あたりにある[ユーザーの追加]をクリックします。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/118463/e230ee3b-a3d8-0717-fec2-7ec13994cc19.png)

権限を付与したいユーザーを検索して選択・保存します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/118463/6480d1cc-0e95-8bf6-e2e3-a78d046b13a9.png)

権限の設定は以上です。

:::note warn
権限つけたのにスマート・アラート作成のボタンでない！という方は一度ブラウザをリロードしてみてください。
:::

# スマート・アラートの作成

[分析] > [ログ] > [スマート・アラート]と進み、右下の[スマート・アラートの追加]をクリックしてください。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/118463/7236346d-bd1a-c901-b8f5-a7a43f94da9e.png)

## スコープの定義

**メトリック**は ログ・カウント で固定です。
**フィルター**で 監視する範囲 を設定しましょう。設定しない場合、全てのログを対象に監視します。
**グループ**で どのメトリックで監視するかを1つ選択します。例えば、`log level = error`の数を監視したい場合は、`Logs > Level`を設定します。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/118463/c932f4e5-5786-38fd-b2a2-9d6e217420fb.png)

## しきい値の定義

画面イメージは`log level = error`の数を監視する想定の画面です。
少し見切れてしまっていますが、画面下部でERROR or WARN or FATAL が指定可能なので、 ERROR を選択しています。

過去のデータが真ん中のグラフに表示されているので、参考にしつつしきい値を設定しましょう。

:::note info
しきい値は現在 静的しきい値 のみをサポートしています。
:::

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/118463/c77781e7-c1aa-084f-10d4-bc02366cf936.png)

## 時間しきい値の定義

**評価の粒度** は何分間隔でしきい値判定するかを指定します。デフォルトだと10分間隔でログの合計数をチェックします。
**連続したメトリック違反の数** は上記のチェックが連続で何回引っかかったからアラートを発信するかを指定します。デフォルトだと1回でアラートを送信するようになっていますが、例えば 3 にすると、3回連続でしきい値を超えた場合にアラートを送信します。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/118463/3e944ec0-963f-29ee-e3e6-8e78906563a9.png)

## アラート・チャネルの指定

アラートの送信先を指定できます。
右上の[アラート・チャネルの選択]から送信先を選びましょう。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/118463/b7d1c845-e9b2-d726-b872-ab2a460db746.png)

## アラート・プロパティの定義

Instanaの画面上に出すメッセージやアラート・レベルを設定します。

:::note info
タイトルに設定した文字が 構成済みアラート の一覧に表示された時のアラート名になります。
タイトルは後からを変更可能です。
:::

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/118463/e5da9acb-473e-82f6-5674-7d6619e69fd1.png)

## カスタム・ペイロードの定義

カスタム・ペイロードの設定が必要な場合は、[行の追加]から key / value を設定しましょう。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/118463/ee76b263-d359-65e7-50af-c94cad33d27b.png)

以上で設定は完了です。

## スマート・アラートの作成

設定が一通りできたら、一番下の[作成]をクリックしましょう。

作成後そのまま監視がスタートします。
停止したい場合は、右側に表示されている [停止アイコン]をクリックします。
編集・複製・削除したい場合は、 [・・・] よりそれぞれ選択してください。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/118463/5a20349d-0c3f-97a9-ab30-9f0836964093.png)

# おわりに

まだまだリリースされたての機能なので制約がある部分もありますが、ぜひ試してみていただけると嬉しいです。

この記事を含め、Instanaに関するページへのリンク集を定期的に更新しています。
こちらもよければ見てみてください。(次の更新は2024年のアドベントカレンダーが終わり次第を予定)

https://qiita.com/LgmQue/items/68773c9a14406f610509

それでは！！！