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