# 機械学習モジュール
:::info
:bulb:ここでは、線形回帰分析およびロジスティック回帰分析の機能をGoogleCloudに実装し、モデル作成から予測までを自動で実行するモジュールの導入方法をご紹介します。
この機能を使うことで、線形回帰（回帰）、ロジスティック回帰（分類）での分析において分析方法や評価方法、利用するツールが統一されるため、品質が一定になります。またGoogleCloudでの基盤構築時の機械学習分析部分の実装をラクにできます。
:::

## 導入手順
**1. 事前準備**

1. 任意のProjectのBigqueryにモデル用データと予測用データをテーブルとして登録する
・BigqueryMLの一部機能は`us-central1`でのみ利用可能なため、`us-central1`にする。
・テーブルはID、説明変数、目的変数（予測時には不要）の構成で、それ以外は削除しておく

2. 以下のリンクから線形回帰もしくはロジスティック回帰のモジュールのZIP（liner_reg.zip）をダウンロードする
[・線形回帰モジュールはこちら](https://drive.google.com/drive/folders/1HBfcmDhrlJ4CwTEf5M5yHLxK878FtxC8)
[・ロジスティック回帰モジュールはこちら](https://drive.google.com/drive/folders/1GlMZyHZP4WytRIcNt2Df2Dukm9kEB-JN)

**2. Cloudfunctionsの作成と実行**

1. Cloudfunctionsに移動する
2. ［+関数の作成］をクリックする
3. 基本設定を行い［保存］ボタンを押下する
* 環境：`第二世代`を選択（画像とは異なるので注意）
* 関数名：任意の関数名
* リージョン：任意のリージョン（`asia-northeast1`推奨）
* トリガーのタイプ：状況に応じて任意だが、`HTTPS`推奨

4. ランタイム、ビルド、接続、セキュリティの設定を行う
* タイムアウト：3600
* サービスアカウント：`Functionsの実行権限`を付与したサービスアカウントをセットする
権限を持つサービスアカウントがない場合は作成する
* その他の設定値：デフォルト


5. ランタイム環境変数を設定し、［次へ］ボタンを押下する
* UUID：他と被らない、ユニークなUUIDを設定する
モデル評価値が規定値から外れた場合にアラートを出す場合に使用する
[UUID生成ツール](https://uuid.doratool.com/)
* PROJECT：対象のプロジェクトを入力
* DATASET：対象のデータセットを入力（Bigqueryのデータセット）
* IN_MODEL_TABLE：モデル作成用のテーブル名を入力
* IDE：モデル用・予測用データのIDカラム名を入力
* FLAG：モデル作成用データの正解カラム名を入力
* IN_PREDICT_TABLE：予測用のテーブル名を入力
* ALGORITHM：不要


6. 2でダウンロードしたZIPをアップロードし、［デプロイ］ボタンを押下
* ZIPファイル：ダウンロードしたZIP
* ステージバケット：任意のバケット、ディレクトリを設定
zipファイルがここにアップロードされるが、デプロイ後に削除してよい。


7. 動作確認
* デプロイが正常に完了したら、［テスト中］タブを押下
* テストコマンドにある［CLOUD SHELLでテストする］を押下
* CLOUD SHELLが立ち上がりテストコマンドが自動で入力されるため、［Enterキー］を押す
テストが実行されCLOUD SHELL上にOKと出力されれば動作確認完了


8. 対象のデータセットに以下のテーブルが出力される
※⑤は存在しない
| | テーブル | 概要・目的 |
|:-----:| ---------- | ---------------------------------------- |
| （A） | 任意の名称 | モデリングに使用するデータ用のテーブル |
| （B） | 任意の名称 | スコアリングに使用するデータ用のテーブル |
| ① | 01_model_categorize | modelテーブルを用途ごとに色分けしたテーブル（トレーニング用/評価用） |
| ② | 02_modeling | モデル（モデリングを実施した結果） |
| ③ | 03_model_scoring | モデルを評価用データを利用して検証した結果のテーブル |
| ④ | 04_judgment_index | モデルの評価結果から評価用の指標を計測した結果（線形回帰は決定係数、ロジスティック回帰はAUC）
| ⑥ | 06_scoring | 予測結果 |
| ⑦ | 07_output_data | 予測結果（CSV出力用） |

**3. アラートの設定**
1. GoogleCloudの検索窓から「ログ エクスプローラ」で検索し、「ログ エクスプローラ」画面へ遷移する
2. ［アラート作成］をクリックする
3. アラート詳細情報を入力し、［次へ］ボタンを押下する
* Alert Policy Name：任意のアラート名称を入力
ここに記入した内容がメールの件名に反映される
* Choose logs to include in the alert：UUIDを入力
* 通知の間隔、インシデントの自動クローズ期間：最も短い時間を設定
* Who Shoud be notified?：アラートの通知チャネルをセットする
通知チャネルがない場合は［通知チャネルを管理］を押下して作成する

    通知チャンネルの設定方法
    例：メール通知の場合
        1.Emailにて［ADD NEW］を押下する。
        2.メールアドレスと表示名を入力して［SAVE］を押下する。
        3.元のアラート設定画面に戻り更新アイコンをクリックすると作成した表示名が通知チャンネルとして表示される。
        4.チェックボックスに✓を付け、[OK]を押下する。


4. アラートのサンプルが通知されているか確認し、問題がなければ完了
例：メール通知の場合