エンティティは、ログ・アナリティクスのリソースであり、オンプレミス・ホストまたは仮想ホスト上の実際のアセットを参照するために使用されます。ログ・アナリティクスでこのエンティティを検出した後、それをログ・ソースに関連付け、そこからのログ収集を有効にできます。

役立つリソース:

• エンティティの詳細は、ログ・アナリティクスの用語と概念を参照してください。

• エンティティを作成するには、ログ出力リソースを表すエンティティの作成を参照してください。さらに、ログ・アナリティクスでは、それを後で編集したり、コンパートメント間で移動したり、次に示すような他のいくつかの管理タスクを実行したりできます。

• パッケージ・アプリケーション、データベース、ミドルウェアなどのエンティティの検出を開始するには、エンティティおよびログ収集の自動検出を参照してください。

• エンティティには、エンティティ・タイプが必要です。100近くのOracle定義エンティティ・タイプがすでに使用可能です。ログ・アナリティクスでモデル化されたエンティティ・タイプを参照してください。カスタム・エンティティ・タイプを作成することもできます。エンティティが作成されると、エンティティ・タイプによって、ログ・ファイルの場所を特定するために使用されるプロパティが定義されます。たとえば、Oracle Databaseエンティティ・タイプでは、ADR_HOME、ORACLE_HOME、INSTALL_HOMEなどのプロパティのパス値を指定する必要があります。REST APIまたはCLIを使用して、新しいエンティティ・タイプを作成できます。ログ・アナリティクスAPIおよびコマンドライン・リファレンスを参照してください。

• 管理エージェントを使用してログを継続的に収集する場合、特定のエンティティのソースがログ・データを収集できるように、ソースとエンティティのアソシエーションを構成する必要があります。ソースとエンティティのアソシエーションの管理を参照してください。

• エンティティからのログ収集を停止するには、エンティティとソースの関連付けを解除します。エンティティからのログ収集の停止を参照してください。

エンティティに他のアクションを実行するには、「エンティティ」ページの「エンティティ・スコープ」セクションでエンティティのコンパートメントを選択し、「フィルタ」セクションでエンティティ・タイプを選択してエンティティの検索を絞り込みます。エンティティを識別したら、エンティティの行にある「アクション」アイコンをクリックします:

• 詳細の表示: 「エンティティ」ページが表示されます。「エンティティ情報」タブでは、エンティティ・タイプ、そのOCID、作成タイプ、存在するコンパートメント、管理エージェントの詳細、作成時間と最終更新時間、および関連付けられたソースを表示できます。「管理エージェント」の横にある「編集」アイコンをクリックして、エージェント情報を更新します。「タグ」タブでは、エンティティに関連付けられているタグを表示できます。タグを追加するには、「タグの追加」ボタンをクリックします。

  さらに、「エンティティ」ページの「編集」、「リソースの移動」、「タグの追加」または「削除」ボタンをクリックして、対応するアクションを実行します。

• 編集: 「エンティティの編集」ダイアログ・ボックスが表示されます。ここで、別のプロパティを追加するには、「プロパティ」セクションの「追加」ボタンをクリックし、「プロパティ名」および「プロパティ値」を指定します。「変更の保存」をクリックします。

  これらのプロパティは、ログ・ファイルの場所を特定するために使用されます。たとえば、Oracle Databaseエンティティ・タイプでは、ADR_HOME、ORACLE_HOME、INSTALL_HOMEなどのプロパティのパス値を指定する必要があります。

• データの追加: エンティティがOCIリソースであるかOCIリソースでないかに応じて、「エージェントベースのログ収集の構成」または「OCIリソースのログ収集の構成」ダイアログ・ボックスが表示されます。ウィザードは、エンティティを適切なソースに関連付けるのに役立ちます。これにより、エンティティから流れるログ・レコードを処理するためのパーサーおよびフィルタが設定されます。

• ファイルのアップロード: ファイルのアップロード・ウィザードが開きます。ウィザードのステップに従って、エンティティに関連付けられたログ・ファイルをアップロードします。これは、連続ログ収集に含まれないファイル、または収集に定義されている範囲外の時間範囲に属するファイルのバッチをアップロードする場合に特に便利です。

• OCIDのコピー: エンティティ・リソースのOCIDがコピーされます。これを使用して、Oracle Cloud Infrastructure内の任意の場所でこのリソースを参照できます。

• リソースの移動: 「別のコンパートメントへのリソースの移動」ダイアログ・ボックスが表示されます。オプションから、エンティティを移動するコンパートメントを選択し、「リソースの移動」をクリックします。

• タグの追加: ログ・アナリティクス・リソースへのタグの追加を参照してください。

• 削除: 場合によっては、ログ・アナリティクスのサービス制限に準拠するために、古いエンティティまたは未使用のエンティティの一部を削除する必要があります。Oracle Cloud Infrastructureドキュメントのサービス別の制限を参照してください。エンティティを削除するには、「エンティティの削除」ダイアログ・ボックスで確認します。

  ノート
  
  

  エンティティ削除APIを使用して削除したエンティティは、次のいずれかの状況でエンティティ・リストに再表示される場合があります:

  • 削除されたエンティティの新しいログは、サービス・コネクタ・ハブまたはオブジェクト・ストレージのコレクションを介してプッシュされます。

  • 新しいEMブリッジ・アップロードには、削除されたエンティティが含まれます。