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

役立つリソース:

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

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

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

• エンティティには、エンティティ・タイプが必要です。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ブリッジ・アップロードには、削除されたエンティティが含まれます。