管理: その他のアクション

ログ・アナリティクス・リソースへのタグの追加

Oracle Cloud Infrastructure Taggingでは、メタデータをリソースに追加できます。つまり、キーと値を定義して、それらをリソースに関連付けることができます。ログ・ソース、パーサー、エンティティ、保存済検索、スケジュール済タスク、ログ・グループ、フィールド、ラベル、アップロード、ストレージなどのログ・アナリティクス・リソースにタグ付けして、ビジネス・ニーズに基づいてそれらを整理およびリストします。

タグ付けの概念、タグの作業に必要な権限、タグ制限、タグ変数、タグを使用したアクセスの管理、タグとタグ・ネームスペースの管理についてさらに学習するには、Oracle Cloud Infrastructureドキュメントタグ付けの概要を参照してください。

コンパートメント間でのログ・アナリティクス・リソースの移動

エンティティ、ログ・グループ、保存済検索などのログ・アナリティクス・リソースは、コンパートメント間で移動できます。

ノート

  • リソースを移動する前に、宛先コンパートメントにログ・アナリティクスの操作を実行するために必要なアクセス権限があることを確認してください。リソースを新しいコンパートメントに移動すると、固有のポリシーが即座に適用され、リソースへのアクセスに影響します。

  • ログ・アナリティクス・リソースを新しいコンパートメントに移動しても、関連付けられたリソースは移動されない可能性があります。

Oracle Cloud Infrastructureドキュメントコンパートメントの作業を参照してください。

ログ・アナリティクス・イベントのルールの作成

Oracle Logging Analyticsに対して実行する特定のアクションは、イベントを生成します。イベントが発生したときに特定のアクションをトリガーするルールを定義できます。

イベント・サービスを使用すると、テナンシ全体のリソースの状態変化に基づいて自動化を作成できます。イベントを使用して、イベントの発生時に開発チームが自動的に応答できるようにします。

イベント・サービス、ルールの作成、およびメトリックを使用したルールのパフォーマンスの監視の詳細は、イベントの概要イベントのルールの管理およびイベント・メトリックを参照してください。

次の表に、Oracle Logging Analyticsが生成するイベント・タイプを示します:

イベント名 イベント型

EMブリッジ- 作成

com.oraclecloud.logginganalytics.createembridge

エンティティ- 作成

com.oraclecloud.logginganalytics.createentity

EMブリッジ- 削除

com.oraclecloud.logginganalytics.deleteembridge

エンティティ- 削除

com.oraclecloud.logginganalytics.deleteentity

オブジェクト収集ルール- コンパートメントの移動

com.oraclecloud.logginganalytics.changeloganalyticsobjectcollectionrulecompartment

オブジェクト収集ルール- 作成

com.oraclecloud.logginganalytics.createloganalyticsobjectcollectionrule

オブジェクト収集ルール- 削除

com.oraclecloud.logginganalytics.deleteloganalyticsobjectcollectionrule

アップロード- 削除

com.oraclecloud.logginganalytics.deleteupload

アップロード・ログ・ファイル- 削除

com.oraclecloud.logginganalytics.deleteuploadfile

アップロード警告- 削除

com.oraclecloud.logginganalytics.deleteuploadwarning

未処理データ・バケットの設定

com.oraclecloud.logginganalytics.setunprocesseddatabucket

オブジェクト収集ルール- 更新

com.oraclecloud.logginganalytics.updateloganalyticsobjectcollectionrule

ログ・ファイルのアップロード

com.oraclecloud.logginganalytics.uploadlogfile

アップロード・ログ・イベント・ファイル

com.oraclecloud.logginganalytics.uploadlogeventsfile

これはOracle Logging Analyticsのリファレンス・イベントです:

{
    "eventType": "com.oraclecloud.logginganalytics.uploadlogeventsfile",
    "cloudEventsVersion": "0.1",
    "eventTypeVersion": "2.0",
    "source": "LoggingAnalytics",
    "eventTime": "2023-01-09T10:50:10Z",
    "contentType": "application/json",
    "data": {
      "eventName": "example_event",
      "compartmentId": "ocid1.compartment.oc1..unique_ID",
      "compartmentName": "example_compartment",
      "availabilityDomain": "availability_domain"
    },
    "eventID": "unique_ID",
    "extensions": {
      "compartmentId": "ocid1.compartment.oc1..unique_ID"
    }
  }

サービス・メトリックを使用したログ・アナリティクスのモニター

Oracle Cloud Infrastructure Monitoringサービス・メトリックを使用して、ログ・アナリティクスをモニターします。

サービス・メトリックは、リージョンに固有で、サービス・パフォーマンス全体を可視化できます。これらのメトリックは、「サービスの概要」ページで表示できます。しきい値を超えた場合に通知を取得するために、Oracle Cloud Infrastructureのアラーム機能を使用してアラームを構成することもできます。

ストレージのサービス・メトリックにアクセスするには:

  1. ナビゲーション・メニューを開き、「監視および管理」をクリックします。「ログ・アナリティクス」で、「管理」をクリックします。「管理の概要」ページが開きます。

  2. 管理リソースが、左側のナビゲーション・ペインの「リソース」の下にリストされます。「サービス詳細」をクリックします。

「処理エラー」「エージェント・データ・アップロード・サイズ」「エージェント・データ・アップロード・エラー」および「スケジュール済タスク実行ステータス」メトリックにアクセスするには:

  1. ナビゲーション・メニューを開き、「監視および管理」をクリックします。「モニタリング」で、「サービス・メトリック」をクリックします。

  2. 作業する権限のあるコンパートメント(rootなど)を選択します。

    選択したコンパートメントのメトリック・ネームスペースのリストが更新されます。

  3. 「メトリック・ネームスペース」oci_logging_analyticsを選択します。

    ログ・アナリティクス・サービスのメトリックが表示されます。

次のメトリックが使用可能です:

メトリック名 単位 間隔 説明

使用されているアクティブ・ストレージ

GB

1時間

分析に使用できるアクティブ・ストレージのログ・データのサイズ。

使用されているアーカイブ・ストレージ

GB

1時間

アクティブに使用されていないアーカイブ・ストレージのログ・データのサイズ。

処理エラー

件数

1分

様々な収集方法によるログ・データの処理中のエラー数。収集パイプラインのトラブルシューティングを参照してください。

エージェント・データ・アップロード・サイズ

バイト

1分

各ログ・ソースの管理エージェントを介して収集されたログ・データのサイズ。継続的なログ収集のモニターを参照してください。

エージェント・データ・アップロード・エラー

件数

1分

各ログ・ソースで発生したエラーの数およびエラーのタイプ。継続的なログ収集のモニターを参照してください。

スケジュール済タスクの実行ステータス

件数

保存検索のスケジュール・タスクには、そのタスク・スケジュールで指定された間隔があります

すべてのスケジュール済タスクの実行のステータス。保存済検索のスケジュール済タスクのモニターを参照してください。

メトリックを表示するときは、メトリック・ネームスペースoci_logging_analyticsおよび適切なコンパートメントを選択してください。

  • 「エラーの処理」メトリックでは、データ収集の方法に基づいてコンパートメントの値を選択する必要があります。オブジェクト・ストレージ・バケットからログを収集する場合、値はObjectCollectionルールが定義されているコンパートメントの名前です。他の収集方法では、これはデフォルトのルート・コンパートメントです。

  • メトリックの「エージェント・データ・アップロード・サイズ」および「エージェント・データ・アップロード・エラー」で、エージェント・コンパートメントを選択します。

  • メトリック「スケジュール済タスクの実行ステータス」で、スケジュール済タスクが配置されているコンパートメントを選択します。

各メトリックで実行できるアクションは、サービス・メトリックのアクションを参照してください。

次のカスタマイズを指定してメトリックを表示できます:

  • メトリック・データを表示する必要がある期間
  • 表示のためにデータを照合する必要がある時間間隔。メトリックの収集間隔より大きい値を指定してください。
  • 表示するデータに対して実行する統計演算。最大最小レート合計平均件数50パーセンタイル90パーセンタイル95パーセンタイルおよび99パーセンタイルから選択できます。

サービス・メトリックのアクション

「サービス詳細」ページでは、サービスの様々なメトリックを表示できます。チャートの上にカーソルを置くと、各データ・ポイントの詳細情報が表示されます。さらに、「オプション」メニューをクリックして、次のいずれかのアクションから選択します:

  • メトリック・エクスプローラで表示(処理エラーでは「メトリック・エクスプローラで問合せを表示」): モニタリング・サービスのメトリック・エクスプローラでメトリックを表示できます。メトリック・エクスプローラでは、収集されたデータ・ポイントの「データ表」ビューへの切替え、メトリックの生成に使用される問合せの編集、y軸へのカスタム・ラベルの追加、またはy軸の最小値と最大値の定義を行うことができます。

  • チャートURLのコピー: チャートURLをコピーして、他のリソース、アプリケーション、または効率のために使用します。

  • 問合せ(MQL)のコピー: メトリックの生成に使用される問合せをコピーし、メトリック・エクスプローラでカスタマイズに使用します。

  • この問合せにアラームを作成: 問合せが実行され、エラーが検出されるたびにトリガーされるアラームを設定できます。

    モニタリング・サービスでアラームを作成する詳細なステップは、Oracle Cloud Infrastructureドキュメントアラームの管理を参照してください。

  • 表ビュー: 収集されたエラー・データ・ポイントが表形式で表示される「表ビュー」に切り替えることができます。

モニタリングの概念およびモニタリング・サービス・メトリックにアクセスするステップの詳細は、Oracle Cloud Infrastructureドキュメントモニタリングの概要を参照してください。

サービスの終了

特定のリージョンでログ・アナリティクス・サービスを無効にする場合は、次のステップに従います。サービスを終了するリージョンにログインしていることを確認します。

  1. ナビゲーション・メニューを開き、「監視および管理」をクリックします。「ログ・アナリティクス」で、「管理」をクリックします。「管理の概要」ページが開きます。

  2. 管理リソースが、左側のナビゲーション・ペインの「リソース」の下にリストされます。「サービス詳細」をクリックします。

  3. 「終了」をクリックします。

    サービスを終了すると、ソース、パーサー、その他のリソースなどのカスタム構成が削除されます。ただし、さらにクリーンアップするには、ログ・アナリティクスを使用するために作成したIAMポリシーおよびユーザー・グループを削除する必要がある場合がありますが、使用されなくなりました。