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

役立つリソース:

• エンティティの詳細は、Log Analyticsの用語と概念に関する項を参照してください。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• タグの追加: Log Analyticsリソースへのタグの追加を参照してください。

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

  ノート
  
  

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

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

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