取込み時の事前定義済イベントの検出
検出ルールを作成する前に、まずアラートの生成に使用できるラベルを特定します。ログ・ソースを編集し、ラベルを使用してログ・レコード内の特定のコンテンツを検出します。ソースでのラベルの使用を参照してください。新しいラベルを作成するには、ラベルの作成を参照してください。たとえば、Apache Tomcat Access Logs
で503
エラーを検出するために検出ルールを定義する必要がある場合は、次のステップに従う必要があります。
-
ラベル(
Availability Error
など)を作成します。 -
ソース
Apache Tomcat Access Logs
のラベルを使用します。 -
ソース定義で、値
503
を持つベース・フィールドStatus
の出現をラベルAvailability Error
にマップします。 -
ラベル
Availability Error
に検出ルールを作成し、ログ・ソースのApache Tomcat Access Logs
をログのフィルタとして指定します。
取込み時間検出ルールを作成および管理するには、まず必要な権限が提供されていることを確認します。ユーザーに収集時間アラート・ルール操作の実行を許可するを参照してください。
一致するラベルおよびフィルタ設定を含むログ・レコードが検出されるたびにアラートを生成する取込み時間検出ルールを作成するには、次のステップを実行します:
-
ナビゲーション・メニューを開き、「監視および管理」をクリックします。「ログ・アナリティクス」で、「管理」をクリックします。「管理の概要」ページが開きます。
管理リソースが、左側のナビゲーション・ペインの「リソース」の下にリストされます。「検出ルール」をクリックします。
「検出ルール」ページがオープンします。「ルールの作成」をクリックします
「検出ルールの作成」ダイアログ・ボックスが表示されます。
-
「取込み時検出ルール」をクリックします。
-
取込み時検出ルールのルール名を指定します。
-
「ラベルの選択」セクションのメニューから、ログ・レコードで検出する必要がある「ラベル」を選択します。
また、ログ・レコードのフィルタリングに使用するエンティティ・タイプおよびログ・ソースを指定できます。
-
アラートをレポートする必要があるターゲット・サービスを指定します。
Monitoring
サービスを選択します。生成されたアラートの情報を含むモニタリング・サービスで生成されたメトリック。メトリックを格納する必要があるメトリック・コンパートメントを選択します。
メトリック・ネームスペースを選択します。
オプションで、メトリックが属するリソース・グループを選択します。
アラートに対して生成されるメトリックの「メトリック名」を指定します。
-
デフォルトでは、
Label
およびRule OCID
がディメンションとして使用されます。また、必要に応じて、「ディメンション」のフィールドの使用可能なオプションからさらに値を選択できます。メトリック・データのフィルタ処理に使用できる値です。選択可能なフィールド・オプションは、一般的に使用される一部のフィールドに加えて、ステップ4で指定したログ・ソースによって異なります。ログ・ソースが指定されていない場合は、すべてのフィールドを使用できます。「検出ルールの作成」をクリックします。
ログ・ソースで指定された一致が収集中にログ・レコードで検出されると、メトリック値がOCIモニタリング・サービスにポストされます。OCIモニタリング・サービスからアラートを取得するには、そのメトリックにアラームを構成します。Create Alerts for Detected Eventsを参照してください。
ユーザーに時間収集アラート・ルール操作の実行を許可
個々のリソース・タイプ: loganalytics-ingesttime-rule
集約リソース・タイプの一部: loganalytics-resources-family
ユース・ケース | IAMポリシー |
---|---|
取込み時間ルールは、テナンシの任意のコンパートメントに存在できます |
時間ルール・リソースを取り込み、メトリックをモニタリング・サービスにポストするためのMANAGE権限を提供するポリシー・ステートメントの例:
|
取込み時間ルールは特定のコンパートメントにあります |
時間ルール・リソースを取り込み、メトリックをモニタリング・サービスにポストするためのMANAGE権限を提供するポリシー・ステートメントの例:
|
取込み時間ルール・リソースの「管理」権限を使用すると、取込み時間ルールのリスト、取込み時間ルールの詳細の取得、取込み時間ルールの作成、削除または更新、および別のコンパートメントへの移動を行うことができます。
前述のポリシー・ステートメントの一部は、すぐに使用可能なOracle定義のポリシー・テンプレートに含まれています。ユース・ケースにテンプレートを使用することを検討できます。Oracle定義の共通ユースケース用ポリシー・テンプレートを参照してください。