IBM Process Miningのモニター機能を使って、新規データの投入にあわせて特定のアクティビティーが発生したことをメール通知する
IBM Process Mining 1.13.1の新機能に、Insight to Actionという機能が追加されました。
これは、ビジネス・プロセスの変化をモニターし、それらの洞察に対して専用のアクションで対応する機能です。これにより、プロセスの所要時間またはコストのようなKPIが閾値に達したこと、またはプロセス内で特定の予期しないアクティビティーが発生したことを検出することができます。
検出したことに対して、RESTfulサービスなどのサービスを呼び出すことで、これらの変化に対するアクションを実行することができます。
モニターについては、こちらのリンクを参照してください。
下記の図のように、GithubでIssueをopenしたり、コメントを入力したりすると、その状態をWebhookの機能を使って、IBM Cloud上のFunctionsで定義されたアクションにそのデータを送信します。Functionsでは、受け取ったデータをIBM Event StreamsのTopicに格納します。
IBM Event Streamsに格納されたデータは、IBM Process Miningのデータストリーム機能によって、定期的に取得されて、プロセスモデルとして可視化されます。
このシナリオの詳細については、下記の記事を参照してください。
IBM Process Miningのデータ・ストリームによるIBM Event Streams（Kafka）との連携
このブログで紹介するメインの機能は、モニター機能と、モニターで検知した事象から呼び出される、サービスになります。
上記のシナリオを実現するために準備すること。
- Pythonのスクリプトからメール送信できるようにするために、Gmailのアプリパスワードを生成しておく
- IBM Cloud上のFunctionsを定義し、アクションで、Gmailの送信のPythonスクリプトを定義する
- IBM Process Miningでサービスを作成する
- IBM Process Miningでモニターを作成する
Gmailのアプリパスワードを生成する
Pythonのスクリプトから、Emailアドレスとパスワードを使用してgmailのサーバーに接続できるようにGoogleアカウントの設定で下記の設定を行う必要があります。
アプリパスワードでログインする。
- 二段階認証プロセスを有効にする
- アプリパスワードを生成する
下記のイメージのように、生成するアプリ（メール）とデバイス（Windowsパソコン）を選択して生成ボタンをクリックします。
アプリパスワードは、16文字のコードになります。（これは、後で、Functionsのメール送信のアクションに設定します。）
IBM Cloud上のFunctionsを定義し、アクションで、Gmailの送信のPythonスクリプトを定義する
まず、新規にアクションの作成をおこないます。
アクション名として、IPM_monitor_send_emailと入力します。ランタイムは、Python 3.11を選択します。
下記のように、Functionsのひな型が生成されます。
次に、gmailにログインするためのemail_accountとemail_pswdというパラメータを設定します。
email_accountには、Googleアカウントを設定し、email_pswdには、先ほどGoogleアカウントで生成したアプリパスワードを設定します。
下記のコードを入力して、Pythonコードを完成させます。
#
#
# main() このアクションを呼び出すときに実行されます
#
# @param Cloud Functions アクションは 1 つのパラメーターを受け入れます。このパラメーターは JSON オブジェクトでなければなりません。
#
# @return このアクションの出力。この出力は、JSON オブジェクトでなければなりません。
#
#
import sys
import smtplib
from email.message import EmailMessage
def emailLogin(email_account, email_password):
try:
server = smtplib.SMTP_SSL('smtp.gmail.com', 465)
server.ehlo()
server.login(email_account, email_password)
print('Login to gmail success')
return server
except:
print('Login to gmaol failure')
return 0
def main(dict):
server = emailLogin(dict['email_account'], dict['email_pswd'])
msg = EmailMessage()
msg['From'] = dict['email_account']
msg['To'] = dict['email_to']
msg['Subject'] = dict['email_subject']
msg.set_content(dict['email_body'])
server.send_message(msg)
server.close()
return { 'message': 'Email sent' }
完成イメージは下記のようになります。
次に、Webアクションを有効化し、外部からREST APIで呼び出せるようにしておきます。
完成したPythonスクリプトが正常に稼働するかどうかのテストを行います。
パラメータを付けて起動のところをクリックし、メール送信に必要なデータをJSON形式で入力します。
起動ボタンをクリックして、右側にあるように、”Email sent”と表示されればメール送信は成功です。
下記のようなメールが届きました。
IBM Process Miningでサービスを作成する
最初に、Account Closureというプロセスにデータが登録されたタイミングで、モニタリングを行うため、Account Closureのプロジェクトを開きます。
左側に双眼鏡のようなアイコンがモニター機能のアイコンになるので、それをクリックします。
サービスの作成ボタンをクリックして、サービスの作成を行っていきます。
新規サービスの作成画面では、サービス・タイトルとして、Functions-send-emailsを入力します。説明には、Python sends email using SMTP libと入力しておきます。認証については、認証なしに設定します。
URLには、Functionsで有効化した、HTTPメソッドのURLを設定します。
次に、アクティビティモニターを作成していきます。
モニターの作成ボタンをクリックします。
モニタータイトルには、Github open monitorと入力し、説明には、Monitor Github for Open Issuesと入力します。
アクティビティー・モニターの定義では、モニターしたいアクティビティーがドロップダウンで選択できるようになっているので、今回は、openedを選択しておきます。
次は、どのタイミングでモニターするのかを設定しますが、今回は、データ・アップロードのタイミングでモニタリングすることにします。
次に、どのサービスを実行するのかを指定します。
事前に定義した、Functions-send-emailsのサービスを選択します。
最後にメール送信のためのパラメータとして、本体パラメータを入力します。
{
"email_to": "shideo@jp.ibm.com",
"email_subject": "Process Mining Warning: $__insight_name__",
"email_body": "$__insight_description__ : $__project__ There are github issue opened."
}
接続の検証ボタンをクリックして、正常に接続されることを確認しておきます。
完成すると、下記のような画面が出てきます。
GithubでIssueをopenしてデータを発生させてみて、メールが送信されることを確認する。
GithubのNew IssueからTitleやコメントなどをいれて、Submit new issueをクリックします。
Functionsのアクティベーションダッシュボードを見ると、一番上に、Github Webhookが実行されたことがわかります。
データストリームで今すぐフェッチを行って、データの取得を行います。データの取得が行われたタイミングでモニターが稼働するので、テストとして、今すぐフェッチでデータを取得します。
データが取得されると、インポート済みが1件になっていることがわかります。
アクティビティーモニターを参照すると、3分前に実行されたことがわかります。
履歴を参照すると、7/7 17:48に実行されたことがわかります。（それ以外の履歴は、少し前に試したものなので、時間が少し遅い時間になっています。）
再度、Functionsのダッシュボードに戻ってみると、IPM_monitor_send_emailが実行されてメール送信されていることがわかります。
メールを確認すると、以下のようなメールが来ていました。
まとめ
IBM Process Miningのモニターおよびサービスのサンプルを作成する手順について、見ていきました。
IBM Process Mining のモニター・サービスは、カスタム条件とスケジュールされたモニターおよび通知を使用してビジネス・プロセスをモニターするのに役立ちます。 プロセスの重要業績評価指標 (KPI)、アクティビティー KPI、分析ウィジェット、プロセス・アクティビティー、および遷移の変更に対する洞察を得られるプロセス基準を設定することにより、モニターを作成できます。
#IBM #CloudPakforBusinessAutomation #Monitor
#IPM
#ProcessMining