diff --git a/_pages/management.md b/_pages/management.md index 5603b9840..217846d99 100644 --- a/_pages/management.md +++ b/_pages/management.md @@ -37,6 +37,7 @@ OCIには、OCI Observability and Management Platform(O&M)と呼ばれるOCIに + **[Logging Analytics：OCI外部のホストからOSログを収集する](https://oracle-japan.github.io/ocitutorials/management/logginganalytics_logcollection4externalhost/)** + **[カスタム・パーサーを作成してOCI Logging Analyticsで未対応のログを分析する](https://oracle-japan.github.io/ocitutorials/management/logginganalytics_customparser/)** + **[Logging AnalyticsでAutonomous Databaseのログを収集する](https://oracle-japan.github.io/ocitutorials/management/logginganalytics_adb_log/)** ++ **[検出ルールを作成してアラート通知を設定する](https://oracle-japan.github.io/ocitutorials/management/logginganalytics_detect_rule/)** ## Database Management + **[OCI Base Database ServiceでDatabase Managementを有効化する](https://oracle-japan.github.io/ocitutorials/management/dbcs-database-management/)** diff --git a/tutorials/_management/logginganalytics_detect_rule.md b/tutorials/_management/logginganalytics_detect_rule.md new file mode 100644 index 000000000..b1bb090ec --- /dev/null +++ b/tutorials/_management/logginganalytics_detect_rule.md @@ -0,0 +1,133 @@ +--- +title: "検出ルールを作成してアラート通知を設定する" +excerpt: "Logging Analyticsでは、検出ルールという機能を使用してログベースのアラート通知を設定することができます。" +order: "010" +layout: single +header: + teaser: "/management/logginganalytics_logcollection4ocivm/LA_logcollection4ocivm-22.png" + overlay_image: "" + overlay_filter: rgba(34, 66, 55, 0.7) +#link: https://community.oracle.com/tech/welcome/discussion/4474261/ +--- + +このチュートリアルでは、OCIコンピュートのOSログに検出ルールを設定し、Monitoringのアラームへ連携するための設定手順をご紹介します。 + +**所用時間**：30分 + +**前提事項**： +・OCIコンピュートが作成済であること +このチュートリアルではOSはOracle Linux 8を前提としています。 + +・Logging Analyticsが有効化されていること +このチュートリアルでは、オンボーディング機能を使用してポリシーやLogging Analyticsのリソースが作成済みであることを前提としています。 +オンボーディング機能については[こちらの記事](https://oracle-japan.github.io/ocitutorials/management/logginganalytics_onboarding/)を参照ください。 + +ポリシーやリソースの作成はマニュアルで設定しても問題ありません。 +マニュアルで設定する場合は以下のドキュメントを参照ください。 +[前提条件のIAMポリシー](https://docs.oracle.com/ja-jp/iaas/logging-analytics/doc/prerequisite-iam-policies.html#LOGAN-GUID-4CA8D8F4-2218-4C14-AF73-40111C459270) +[管理エージェントを使用した継続的なログ収集の許可](https://docs.oracle.com/ja-jp/iaas/logging-analytics/doc/allow-continuous-log-collection-using-management-agents.html#LOGAN-GUID-AA23C2F5-6046-443C-A01B-A507E3B5BFB2) + +このチュートリアルでは管理者権限を持つユーザーを前提としています。 +ユーザーにアクセス制御を設定する場合は以下のドキュメントを参照ください。 +[ログ・アナリティクスのIAMポリシー・カタログ](https://docs.oracle.com/ja-jp/iaas/logging-analytics/doc/iam-policies-catalog-logging-analytics.html#LOGAN-GUID-04929DA1-E865-4536-A0EC-46AB4B8B0FE1) + +・OCIコンピュートのOSログがLogging Analyticsで表示できていること +サンプルとして、Linux Syslogを使用します。 +参考：[Logging Analytics：OCIコンピュートからOSのログを収集する](https://oracle-japan.github.io/ocitutorials/management/logginganalytics_logcollection4ocivm/) + +![画像01](image01.png) + +
+ +# 1. ラベルを作成する +------------------------------------------ +OCIコンソール ホーム画面のサービスメニューから「監視および管理」＞「管理」＞「ラベル」と進み、「ラベルの作成」をクリックします。 +![画像02](image02.png) + +**Note** +ラベルとは、ログコンテンツの特定の文字列に対して任意の名前を割り当てる機能です。 +最初から定義されたものもあれば、ユーザー自身で作成することもできます。ラベルの詳細は[こちら](https://docs.oracle.com/ja-jp/iaas/logging-analytics/doc/create-label.html) +{: .notice--info} + +任意の名前をつけて、作成を完了します。 +![画像03](image03.png) + +
+ +# 2. ログソースにラベルを設定する +------------------------------------------ +「監視および管理」＞「管理」へ進み、「ソース」の数字の部分をクリックします。 +![画像04](image04.png) + +linuxで検索し、Linux Syslog Logs をクリックします。 +![画像05](image05.png) + +「編集」をクリックします。 +![画像06](image06.png) + +ソースの編集画面で、ラベルのタブで「条件ラベルの追加」をクリックします。 +![画像07](image07.png) + +以下の画像のように条件を設定します。 +これは、ログコンテンツのメッセージ部分に"test log"という文字列が含まれていた場合、"Demo"というラベルを自動割り当てするという意味になります。 +![画像08](image08.png) + +「追加」をクリックすると一覧に表示されますので、問題なければ「変更の保存」をクリックします。 +![画像09](image09.png) + +
+ +# 3. 検出ルールの作成 +------------------------------------------ +「監視および管理」＞「管理」＞「検出ルール」と進み、「ルールの作成」をクリックします。 +![画像10](image10.png) + +検出ルールには2種類あり、スケジュール実行して検出するタイプのものと、特定のラベルが生成されたタイミングで検出するタイプのものがあります。今回は後者の「取込み時検出ルール」を使用します。検出ルールの詳細については[こちら](https://docs.oracle.com/ja-jp/iaas/logging-analytics/doc/manage-detection-rules.html) + +「取込み時検出ルール」をクリックし、ルール名に任意で名前を付けます。 +![画像11](image11.png) + +ラベルの選択では、先ほど作成したラベルを指定します。 +![画像12](image12.png) + +ターゲットサービス（検出結果を連携するサービス）は「モニタリング」のままとします。 +メトリック・ネームスペースとメトリック名は、プルダウンでOracle管理のものが表示されますが、こちらは使用できませんので、任意の名前を付けておきます。 +![画像13](image13.png) + +その他、ポリシーに関する注意点が表示されますので、こちらのポリシーがまだ設定されていなければ追記しておいてください。 +![画像14](image14.png) + +
+ +# 4. 検出の検証 +------------------------------------------ +では、実際に検証してみます。 +OCIコンピュートにログインし、以下のコマンドでLinux Syslogにメッセージを表示させます。 +``` +$ logger test log +``` +ログ・エクスプローラーで少し待つと、以下のように該当メッセージが表示され、ラベルもきちんと割り当てられていることが確認できました。 +![画像15](image15.png) + +検証ルールの画面でも結果が反映されています。 +![画像16](image16.png) + +つぎに、Monitoringのメトリック・エクスプローラーでも確認してみます。 +ネームスペースとメトリック名について、検出ルール作成時に指定したものが表示できるようになっています。 +![画像17](image17.png) + +この条件で検索すると、ログ検出結果がメトリックとして連携されていることがわかります。 +![画像18](image18.png) + +**Note** +検出結果の反映やMonitoringのネームスペースの表示など、画面の反映に数分程度の時間がかかるケースがあります。 +{: .notice--info} + +
+ +# 5. アラート通知の設定 +------------------------------------------ +通知の設定については以下のチュートリアルを参考にしてください。 +[モニタリング機能でOCIのリソースを監視する](https://oracle-japan.github.io/ocitutorials/intermediates/monitoring-resources/) + +以上でチュートリアルは終了です。 \ No newline at end of file diff --git a/tutorials/_management/logginganalytics_detect_rule/image01.png b/tutorials/_management/logginganalytics_detect_rule/image01.png new file mode 100644 index 000000000..82887e3cc Binary files /dev/null and b/tutorials/_management/logginganalytics_detect_rule/image01.png differ diff --git a/tutorials/_management/logginganalytics_detect_rule/image02.png b/tutorials/_management/logginganalytics_detect_rule/image02.png new file mode 100644 index 000000000..36f230aca Binary files /dev/null and b/tutorials/_management/logginganalytics_detect_rule/image02.png differ diff --git a/tutorials/_management/logginganalytics_detect_rule/image03.png b/tutorials/_management/logginganalytics_detect_rule/image03.png new file mode 100644 index 000000000..9eba5bc04 Binary files /dev/null and b/tutorials/_management/logginganalytics_detect_rule/image03.png differ diff --git a/tutorials/_management/logginganalytics_detect_rule/image04.png b/tutorials/_management/logginganalytics_detect_rule/image04.png new file mode 100644 index 000000000..d9239c3f1 Binary files /dev/null and b/tutorials/_management/logginganalytics_detect_rule/image04.png differ diff --git a/tutorials/_management/logginganalytics_detect_rule/image05.png b/tutorials/_management/logginganalytics_detect_rule/image05.png new file mode 100644 index 000000000..b88447a6a Binary files /dev/null and b/tutorials/_management/logginganalytics_detect_rule/image05.png differ diff --git a/tutorials/_management/logginganalytics_detect_rule/image06.png b/tutorials/_management/logginganalytics_detect_rule/image06.png new file mode 100644 index 000000000..b05737ee2 Binary files /dev/null and b/tutorials/_management/logginganalytics_detect_rule/image06.png differ diff --git a/tutorials/_management/logginganalytics_detect_rule/image07.png b/tutorials/_management/logginganalytics_detect_rule/image07.png new file mode 100644 index 000000000..0ef4ddf0c Binary files /dev/null and b/tutorials/_management/logginganalytics_detect_rule/image07.png differ diff --git a/tutorials/_management/logginganalytics_detect_rule/image08.png b/tutorials/_management/logginganalytics_detect_rule/image08.png new file mode 100644 index 000000000..bb3229aad Binary files /dev/null and b/tutorials/_management/logginganalytics_detect_rule/image08.png differ diff --git a/tutorials/_management/logginganalytics_detect_rule/image09.png b/tutorials/_management/logginganalytics_detect_rule/image09.png new file mode 100644 index 000000000..df72475c7 Binary files /dev/null and b/tutorials/_management/logginganalytics_detect_rule/image09.png differ diff --git a/tutorials/_management/logginganalytics_detect_rule/image10.png b/tutorials/_management/logginganalytics_detect_rule/image10.png new file mode 100644 index 000000000..81a549aa1 Binary files /dev/null and b/tutorials/_management/logginganalytics_detect_rule/image10.png differ diff --git a/tutorials/_management/logginganalytics_detect_rule/image11.png b/tutorials/_management/logginganalytics_detect_rule/image11.png new file mode 100644 index 000000000..b75fbc658 Binary files /dev/null and b/tutorials/_management/logginganalytics_detect_rule/image11.png differ diff --git a/tutorials/_management/logginganalytics_detect_rule/image12.png b/tutorials/_management/logginganalytics_detect_rule/image12.png new file mode 100644 index 000000000..480a68d79 Binary files /dev/null and b/tutorials/_management/logginganalytics_detect_rule/image12.png differ diff --git a/tutorials/_management/logginganalytics_detect_rule/image13.png b/tutorials/_management/logginganalytics_detect_rule/image13.png new file mode 100644 index 000000000..fdf699dfe Binary files /dev/null and b/tutorials/_management/logginganalytics_detect_rule/image13.png differ diff --git a/tutorials/_management/logginganalytics_detect_rule/image14.png b/tutorials/_management/logginganalytics_detect_rule/image14.png new file mode 100644 index 000000000..00c1a6ac6 Binary files /dev/null and b/tutorials/_management/logginganalytics_detect_rule/image14.png differ diff --git a/tutorials/_management/logginganalytics_detect_rule/image15.png b/tutorials/_management/logginganalytics_detect_rule/image15.png new file mode 100644 index 000000000..97e02d80b Binary files /dev/null and b/tutorials/_management/logginganalytics_detect_rule/image15.png differ diff --git a/tutorials/_management/logginganalytics_detect_rule/image16.png b/tutorials/_management/logginganalytics_detect_rule/image16.png new file mode 100644 index 000000000..a36442bd6 Binary files /dev/null and b/tutorials/_management/logginganalytics_detect_rule/image16.png differ diff --git a/tutorials/_management/logginganalytics_detect_rule/image17.png b/tutorials/_management/logginganalytics_detect_rule/image17.png new file mode 100644 index 000000000..f4b6f685b Binary files /dev/null and b/tutorials/_management/logginganalytics_detect_rule/image17.png differ diff --git a/tutorials/_management/logginganalytics_detect_rule/image18.png b/tutorials/_management/logginganalytics_detect_rule/image18.png new file mode 100644 index 000000000..660121ada Binary files /dev/null and b/tutorials/_management/logginganalytics_detect_rule/image18.png differ