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

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

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

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

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

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

ノート

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

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

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

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

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

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

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

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

イベント名 イベント・タイプ

暗号化キーの割当て- 開始

com.oraclecloud.logginganalytics.assignencryptionkey.begin

暗号化キーの割当て- 終了

com.oraclecloud.logginganalytics.assignencryptionkey.end

関連- 削除

com.oraclecloud.logginganalytics.deleteassociations

関連- アップサート

com.oraclecloud.logginganalytics.upsertassociations

自動アソシエーション- 有効化

com.oraclecloud.logginganalytics.enableautoassociation

自動アソシエーション- 無効化

com.oraclecloud.logginganalytics.disableautoassociation

カスタム・コンテンツ- インポート

com.oraclecloud.logginganalytics.importcustomcontent

検出ルール- コンパートメントの変更

com.oraclecloud.logginganalytics.changescheduledtaskcompartment

検出ルール- 作成

com.oraclecloud.logginganalytics.createscheduledtask

検出ルール- 削除

com.oraclecloud.logginganalytics.deletescheduledtask

検出ルール- 一時停止

com.oraclecloud.logginganalytics.pausescheduledtask

検出ルール- 再開

com.oraclecloud.logginganalytics.resumescheduledtask

検出ルール- 更新

com.oraclecloud.logginganalytics.updatescheduledtask

アーカイブの無効化

com.oraclecloud.logginganalytics.disablearchiving

EMブリッジ- 作成

com.oraclecloud.logginganalytics.createembridge

EMブリッジ- 削除

com.oraclecloud.logginganalytics.deleteembridge

アーカイブ有効化

com.oraclecloud.logginganalytics.enablearchiving

エンティティ- 作成

com.oraclecloud.logginganalytics.createentity

エンティティ- 削除

com.oraclecloud.logginganalytics.deleteentity

フィールド- アップサート

com.oraclecloud.logginganalytics.upsertfield

取込み時間ルール- コンパートメントの変更

com.oraclecloud.logginganalytics.changeingesttimerulecompartment

取込み時間ルール- 作成

com.oraclecloud.logginganalytics.createingesttimerule

取込み時間ルール- 削除

com.oraclecloud.logginganalytics.deleteingesttimerule

取込み時間ルール- 使用不可

com.oraclecloud.logginganalytics.disableingesttimerule

取込み時間ルール- 使用可能

com.oraclecloud.logginganalytics.enableingesttimerule

取込み時間ルール- 更新

com.oraclecloud.logginganalytics.updateingesttimerule

ラベル- 削除

com.oraclecloud.logginganalytics.deletelabel

ラベル- アップサート

com.oraclecloud.logginganalytics.upsertlabel

ログ・グループ- コンパートメントの変更

com.oraclecloud.logginganalytics.changeloganalyticsloggroupcompartment

ログ・グループ- 作成

com.oraclecloud.logginganalytics.createloganalyticsloggroup

ログ・グループ- 削除

com.oraclecloud.logginganalytics.deleteloganalyticsloggroup

ログ・グループ- 更新

com.oraclecloud.logginganalytics.updateloganalyticsloggroup

参照- 削除

com.oraclecloud.logginganalytics.deletelookup

参照- 登録

com.oraclecloud.logginganalytics.registerlookup

参照データ- 追加

com.oraclecloud.logginganalytics.appendlookupdata

参照データ- 更新

com.oraclecloud.logginganalytics.updatelookupdata

参照プロパティ- 更新

com.oraclecloud.logginganalytics.updatelookup

ネームスペース- オフボード

com.oraclecloud.logginganalytics.offboardnamespace

ネームスペース- オンボード

com.oraclecloud.logginganalytics.onboardnamespace

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

com.oraclecloud.logginganalytics.createloganalyticsobjectcollectionrule

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

com.oraclecloud.logginganalytics.deleteloganalyticsobjectcollectionrule

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

com.oraclecloud.logginganalytics.changeloganalyticsobjectcollectionrulecompartment

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

com.oraclecloud.logginganalytics.updateloganalyticsobjectcollectionrule

パーサー- 削除

com.oraclecloud.logginganalytics.deleteparser

パーサー- アップサート

com.oraclecloud.logginganalytics.upsertparser

プリファレンス- 削除

com.oraclecloud.logginganalytics.removepreferences

プリファレンス- 更新

com.oraclecloud.logginganalytics.updatepreferences

ストレージ・データのパージ- 開始

com.oraclecloud.logginganalytics.purgestoragedata.begin

ストレージ・データのパージ- 終了

com.oraclecloud.logginganalytics.purgestoragedata.end

アーカイブ済データのリコール- 開始

com.oraclecloud.logginganalytics.recallarchiveddata

アーカイブ済データのリコール- 終了

com.oraclecloud.logginganalytics.recallarchiveddata.end

リコール済データのリリース- 開始

com.oraclecloud.logginganalytics.releaserecalleddata.begin

リコール済データのリリース- 終了

com.oraclecloud.logginganalytics.releaserecalleddata.end

リソース・カテゴリ- 削除

com.oraclecloud.logginganalytics.removeresourcecategories

リソース・カテゴリ- 更新

com.oraclecloud.logginganalytics.updateresourcecategories

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

com.oraclecloud.logginganalytics.setunprocesseddatabucket

ソース- 削除

com.oraclecloud.logginganalytics.deletesource

ソース- アップサート

com.oraclecloud.logginganalytics.upsertsource

ソース・イベント・タイプ- 追加

com.oraclecloud.logginganalytics.addsourceeventtypes

ソース・イベント・タイプ- 使用不可

com.oraclecloud.logginganalytics.disablesourceeventtypes

ソース・イベント・タイプ- 使用可能

com.oraclecloud.logginganalytics.enablesourceeventtypes

ソース・イベント・タイプ- 削除

com.oraclecloud.logginganalytics.removesourceeventtypes

アップロード- 削除

com.oraclecloud.logginganalytics.deleteupload

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

com.oraclecloud.logginganalytics.uploadlogeventsfile

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

com.oraclecloud.logginganalytics.uploadlogfile

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

com.oraclecloud.logginganalytics.deleteuploadfile

アップロード警告- 削除

com.oraclecloud.logginganalytics.deleteuploadwarning

警告- 抑制

com.oraclecloud.logginganalytics.suppresswarning

警告- 抑制解除

com.oraclecloud.logginganalytics.unsuppresswarning

これは、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分

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

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

Bytes

1分

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

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

件数

1分

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

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

件数

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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