IICS オペレーションインサイト データ統合アラート 編  [Informatica]

この記事は [インフォマティカ Advent Calendar 2021](https://qiita.com/advent-calendar/2021/informatica) Day 18 の記事として書かれています。
これまで、[Day 4](https://qiita.com/ORA-1060/items/9e05703330d2450532a3)、[Day 8](https://qiita.com/ORA-1060/items/437e803f510009378022)、[Day 12](https://qiita.com/ORA-1060/items/e79302d29d6ef163e5f5)とIPU メータリング ダッシュボード入門編をお届けしてきましたが、今日は**オペレーションインサイト**の機能についてIPU（Informatica Processing Unit）消費監視に役立つ**データ統合アラート**を紹介します。

この原稿を書いている時点では、**データ統合アラート**は日本リージョンでは未リリースで、AWS-USAやAWS-APACリージョンでは使用可能となっていました。
#はじめに
オンラインマニュアルが日本語化されていないためか、まだ情報が少ない**オペレーションインサイト**ですが、クラスメソッド様の インフォマティカ Advent Calendar 2020 Advent Calendar 2020 Day19で[【小ネタ】IICSのSecure Agentをお手軽に監視する](https://dev.classmethod.jp/articles/iics-monitor-secure-agent-easily/)として一度紹介されています。

英語のメニューでは**Operational Insights**ですが日本語でのメニューはオペレーショナルインサイトではなく、オペレーションインサイトとなっています。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/786891/ce1e6c2b-8355-40c4-1472-eb337c84aff8.png)
**データ統合アラート**は、左側のナビゲーションメニューに**データ統合**が存在する場合に有効化されているアラート機能です。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/786891/f08dde9f-92ef-e73c-301c-4611f1d49346.png)
#アラート
アラートには現時点で5つの機能があります。**アラートを受信**は発生済のアラートをリストします。**インフラストラクチャのアラート**は前出のクラスメソッド様の記事で紹介された機能です。**一括取り込みアラート**はMass Ingestion（一括取り込み）で使用可能です。**PowerCenterのアラート**は[英語のオンラインマニュアル](https://docs.informatica.com/integration-cloud/cloud-platform/current-version/operational-insights/part-3--monitoring-on-premises-applications.html)に記載してあるドメイン登録の設定画面が見当たらず使用可否の判断がつきませんでした。ではData Integration（データ統合）で使える**データ統合アラート**を紹介していきます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/786891/00377987-2406-7ca9-c2c6-a010f140ef50.png)
マッピングタスク自体にタスク終了時に通知する機能は存在しますが、この**データ統合アラート**でもタスクの状態に応じて通知をメールで受け取る設定が可能です。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/786891/94841372-6d18-49c3-70d4-cf0067037586.png)

##アラート作成
アラート作成画面の上段から説明していきます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/786891/3c7d4d63-8524-7401-e448-e4ae6e8ea482.png)
###全般
- 有効/無効のスライドバー：作成後に有効化するかしないかを選択します
- 名前：アラートの名前を入力します
- 説明：アラートの説明を入力します
- アラートルールオン：アラートの対象とするアセットを選択します

説明は設定必須項目ではありませんが通知メールに記載されるので、アラートの内容を簡潔に記載しておくことをお勧めします。アラート作成画面の下段を説明していきます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/786891/0fc5a689-be27-fe35-3eda-f89f23ce9d15.png)
###アラート条件
- ジョブの状態：実行中/完了したジョブ（失敗/警告/成功）選択します。「実行中」と「完了したジョブ」の同時選択は不可です。
 - 完了したジョブ：失敗/警告/成功のいずれか、もしくは任意の複数の組み合わせでジョブ完了時の状態を指定します。（例えば「失敗」と「警告」を選択）**しきい値**からの条件追加は任意です。
 - 実行中：**しきい値**からの条件追加が**必須**です。

**実行中のジョブに対するアラート作成機能が本日紹介したかったデータ統合アラートの活用ポイント！**

- しきい値：
 - 継続時間：秒単位でジョブの継続時間を指定します。さらに指定した継続時間に対して、上回ったのか/下回ったのか/同じなのかという条件をLOVから選択します。

**データ統合ではジョブの実行時間に対してIPUが消費されますので、継続時間を超過したジョブが発生した場合にPUSH型で通知を受け取れるというのがIPU消費の監視という観点で便利な機能です。**

 - 処理済の行数：ターゲット側で処理した行数を指定します。さらに指定した行数に対して、上回ったのか/下回ったのか/同じなのかという条件をLOVから選択します。
 - エラー行数：**「完了したジョブ」でのみ設定可能**。ターゲット側でエラーとなった行数を指定します。さらに指定した行数に対する条件をLOVから選択します。

###アラートアクション
- 電子メール通知：アラートの通知先となるIICSユーザを指定します。デフォルトではアラート作成ユーザのみが設定された状態で表示されいます。右側の▼を展開してLOVから他ユーザを追加可能です。
- タスク停止： **「実行中」のジョブでのみ設定可能**。タスクを停止する場合に指定します。

全て情報を入力後右上の「保存」ボタンをクリックするとアラート作成の完了です。作成されたアラートは**データ統合アラート**の画面でリストに表示されます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/786891/40f6fac4-a383-021f-3ab9-f849b146ce98.png)
ではアラート発生後の**アラートを受信**画面や受け取った**通知メール**を見ていきます。
##アラートを受信 画面
デフォルトではフィルタの条件が「受信日時：過去24時間」、「サービス：有効化済サービス全て選択」で表示されます。

赤枠内はダウンロードボタンとなっておりリストをCSV形式でダウンロード可能です。ファイルをそのまま開くと日本語が文字化けしますのでUTF-8で再度読み込む必要があります。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/786891/73590e2d-3a88-8649-8d13-e585318dd4a2.png)

- 受信日時：アラートを検知した日時
- アラート名：クリックするとアラート編集画面が表示されます。
- トリガ日時：アラートの対象として設定したアセット名。クリックするとジョブのプロパティ画面が表示されます。

**※英語の画面では「Triggered on」となっているため「トリガ日時」は日本語訳が不適切ですね。**

##通知メール
実際に受信した通知メールをいくつか紹介します。メールは英語で送信され、送信元アドレス、メール本文内に含まれている項目は固定です。**Viwe Job Run**はジョブのプロパティ画面へのリンクとなっており、**Manage this Alert**はアラート編集画面へのリンクとなっています。

####設定例①実行中のジョブに対して継続時間3分以上でアラート発生
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/786891/dedaae31-50a6-6dd2-b789-16c793f47941.png)
**Job State:RUNNINGでEnd Timeが空白**であることから、実行中のジョブに対して作成したアラート（継続時間3分以上を検知）が機能したことがわかります。
####設定例②「成功」で完了したジョブに対して処理行数が100未満でアラート発生
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/786891/2f916897-a299-5ef7-b2ef-bd553384044a.png)
**Alert Name**にアラートの条件を使用したためなぜこの通知を受信したのか判断できますが、メール本文の項目に**「行数」**は存在しません。このような場合は**View Job Run**でジョブのプロパティ画面をで詳細を確認しましす。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/786891/1c382bab-bd4a-5c10-15e7-d46ac5f31b9e.png)
プロパティ画面で確認すると結果で**ステータス：成功、成功した行：99**が確認できますので、作成したアラート（成功で完了したジョブで処理行数100未満を検知）が機能したことがわかります。
もう一つ実例を紹介して終わりにしたいと思います。
####設定例③実行中のジョブに対して継続時間50秒以上でタスク停止とアラート発生
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/786891/cfc55cf5-6dde-1c27-73b6-5be6e7f12ac3.png)
これも**Alert Name**や**Alert Description**からなぜこの通知を受信したのか想像できますが、メール本文の項目にタスクの状態を示す情報は存在しません。この場合も**View Job Run**でジョブのプロパティ画面をで詳細を確認しましす。![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/786891/520ab8de-7afc-0e3c-8d74-b883affcde50.png)
プロパティ画面で確認すると結果で**ステータス：失敗**が確認できます。さらに、**エラーメッセージ**を確認すると実行したユーザによりAPI経由でジョブが停止されたメッセージが記載されています。このマッピングタスクでは、ソースと同一行数がターゲットにロードされる事になっているため、エラーが無いにもかかわらず処理が途中で停止されたことを伺い知ることができます。
#参考資料
https://docs.informatica.com/integration-cloud/cloud-platform/current-version/operational-insights/part-2--monitoring-informatica-intelligent-cloud-services/monitoring-informatica-intelligent-cloud-services-data-integrati.html

https://video.informatica.com/detail/video/5857865014001

https://www.youtube.com/watch?v=iKnwtSS0_rI

https://www.youtube.com/watch?v=T9X06XiGgfo
#おわりに
機会があればもう少し調査したいと思っていますが、アラートの検知/通知は一定間隔（おそらく数分毎）で実行されているようで、動作検証した限りにおいてはリアルタイムで通知されることはありませんでした。今後も[インフォマティカ Japan User Group](https://network.informatica.com/groups/japan-user-group)かQiitaで継続的に情報発信していきたい思います。