Oracle Cloud Infrastructureドキュメント

エンティティの管理

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

エンティティ・プリファレンスの管理

エンティティのデフォルト・プリファレンスは、entityLifecycleプリファレンス・グループを使用して管理できます。エンティティ・プリファレンスの読取り、更新および削除をユーザーに許可するIAMポリシーを作成します。

プリファレンスのプリファレンス・グループおよびIAMポリシーの詳細は、Log Analyticsサービス操作プリファレンスおよびユーザーによるタグ・プリファレンスの指定の許可を参照してください。

Oracle Log Analyticsのプリファレンスを管理するREST APIについては、Log Analytics APIリファレンスを参照してください。

トピック:

entityLifecycleプリファレンス・グループのエンティティ・プリファレンス

機能 プリファレンス名 許可された値 詳細
Oracle Log Analyticsでのエージェントおよびホスト・エンティティのライフサイクル AUTO_CREATE_AGENT_HOST_ENTITY 真/偽

TRUE (デフォルト値): エージェントおよびホストのエンティティは自動的に作成されます。

FALSE: エージェントおよびホストのエンティティは作成されません。

AUTO_DELETE_AGENT_ENTITY 真/偽

FALSE (デフォルト値): エージェント・エンティティは、管理エージェントが削除されても削除されません。

TRUE: エージェント・エンティティは、管理エージェントが削除されると削除されます。

AUTO_DELETE_HOST_ENTITY 真/偽

FALSE (デフォルト値): ホスト・エンティティは、管理エージェントが削除されても削除されません。

TRUE: ホスト・エンティティは、管理エージェントが削除されると削除されます。

Oracle Log Analyticsのサービス・コネクタ・ハブを介して受信したログの自動作成エンティティの削除 AUTO_DELETE_SCH_ENTITIES_OF_TYPES サポートされているエンティティ・タイプのカンマ区切りリスト/ _ALL_ / <empty> (値セットなし)

<empty> (値セットなし)(デフォルト値): エンティティは削除されません。

_ALL_: 基礎となるOCIリソースが削除されると、サポートされているすべてのタイプのエンティティが削除されます。

カンマ区切りリスト: 基礎となるOCIリソースが削除されると、指定されたエンティティ・タイプのエンティティが削除されます。
Oracle Log Analyticsで自動作成されたホスト・エンティティのカスタム・ネーミング USE_CUSTOM_HOSTNAME_FROM_TAG エージェントのフリー・フォーム・タグからの<tagKeyName>

デフォルトでは、Oracle Log Analyticsは、ホスト・エンティティの作成時に管理エージェント・リソースで指定されたホスト名を使用します。このホスト名をオーバーライドするには、管理エージェント・リソースにフリー・フォーム・タグを設定できます。タグの値は、ホスト・エンティティに使用される名前をオーバーライドするために使用されます。プリファレンスが設定されていて、フリー・フォーム・タグが管理エージェント・リソースに設定されていない場合、ホスト・エンティティは作成されません。タグの値は、接頭辞付き(デフォルト)か、エージェントによって指定されたホスト名に接尾辞が付きます。

Example: If the hostname reported by Management Agent service is myhost.example.com and if the preference USE_CUSTOM_HOSTNAME_FROM_TAG is set to tagForHostNameOverride and the Management Agent resource has a free form tag tagForHostNameOverride set to value -customEnvName-, then the name of the Log Analytics Host entity is either -customEnvName-myhost.example.com or myhost.example.com-customEnvName- depending on whether Prefix or Suffix option is specified for the USE_CUSTOM_HOSTNAME_POSITION preference.

USE_CUSTOM_HOSTNAME_POSITION 接頭辞/接尾辞 USE_CUSTOM_HOSTNAME_FROM_TAGの詳細を参照してください。
タグ・プリファレンスが適用されるエンティティ・タイプ ENTITY_TYPES_FOR_TAG_PREFERENCES サポートされているLog Analyticsエンティティ・タイプのカンマ区切りリスト/ _ALL_ タグ・プリファレンスは、プリファレンス・リストに記載されているエンティティ・タイプに適用されます。
サービス・コネクタを使用して自動作成されたエンティティのタグを設定します SCH_ENTITIES_TAGS_VALUES サポートされている定義済タグ*、_ALL_のカンマ区切りリスト

サポートされている定義済タグのカンマ区切りリストは、Namespace1.*, Namespace2.Tag2, Namespace3.Tag3='Override value'のように指定でき、プリファレンスは右から左に優先します。前述の例では、Namespace3.Tag3='Override value'はNamespace2.Tag2よりも優先されます。

  • Namespace1.*: Namespace1に一致するすべての定義済タグをコピーします
  • Namespace2.Tag2: ネームスペース2からすべてのTag2をコピーします
  • Namespace3.Tag3='Override value': Namespace3のTag3値を新しい値でオーバーライドします
  • _ALL_: リソースからすべての定義済タグをコピーします

TagDefaultsまたはリソースからのその他のネームスペース/タグは追加されません。タグ・プリファレンスは、エンティティの作成時に、ENTITY_TYPES_FOR_TAG_PREFERENCESプリファレンスで指定されたエンティティ・タイプに対してのみ適用されます。

自動作成されたホスト・エンティティおよびエージェント・エンティティのタグの設定 HOST_AGENT_ENTITIES_TAGS_VALUES サポートされている定義済タグ*、_ALL_のカンマ区切りリスト

サポートされている定義済タグのカンマ区切りリストは、Namespace1.*, Namespace2.Tag2, Namespace3.Tag3='Override value'のように指定でき、プリファレンスは右から左に優先します。前述の例では、Namespace3.Tag3='Override value'はNamespace2.Tag2よりも優先されます。

  • Namespace1.*: Namespace1に一致するすべての定義済タグをコピーします
  • Namespace2.Tag2: ネームスペース2からすべてのTag2をコピーします
  • Namespace3.Tag3='Override value': Namespace3のTag3値を新しい値でオーバーライドします
  • _ALL_: リソースからすべての定義済タグをコピーします

TagDefaultsまたはリソースからのその他のネームスペース/タグは追加されません。タグ・プリファレンスは、エンティティの作成時に、ENTITY_TYPES_FOR_TAG_PREFERENCESプリファレンスで指定されたエンティティ・タイプに対してのみ適用されます。

AUTO_DELETE_SCH_ENTITIES_OF_TYPESおよびENTITY_TYPES_FOR_TAG_PREFERENCESプリファレンスのエンティティ・タイプ

Log Analyticsエンティティ・タイプ OCIリソース
oci_agcs_instance アクセス・ガバナンス
oci_adm_remediationレシピ ADM修正レシピ
oci_analytics_cloud_instance Analytics Cloudインスタンス
oci_api_gateway APIゲートウェイ
oci_apm_domain APMドメイン
クラウド・ガード Cloud Guardデータ・ソース
oci_ccc_インフラストラクチャ Compute Cloud@Customer
omc_kubernetes_cluster Kubernetes向けコンテナ・エンジン
oci_data_flow_application データ・フロー(アプリケーション)
oci_dis_workspace データ統合ワークスペース
oci_datascience_job データサイエンスジョブ
oci_datascience_model_deployment データ・サイエンス・モデルのデプロイメント
oci_datascience_パイプライン データ・サイエンス・パイプライン
(パイプライン実行リソースに対してパイプライン・リソース・エンティティが作成される) データ・サイエンス・パイプライン実行
oci_datascience_mlapplication_instance Data Science MLアプリケーション・インスタンス
oci_devops_build_pipeline Devopsビルド・パイプライン
oci_devops_build_pipeline_stage Devopsビルド・パイプライン・ステージ
oci_devops_build_run DevOpsビルド実行
oci_devops_deployment DevOpsデプロイメント
oci_devops_deployment_pipeline Devopsデプロイメント・パイプライン
oci_devops_deployment_stage Devopsデプロイメント・ステージ
oci_dnsserver DNSリゾルバ
oci_emailsender 電子メール配信サービス
oci_event_rule イベント・サービス
oci_functions_app 関数(FNアプリケーション)
oci_functions_function 関数(FN関数)
omc_oracle_goldengate_deployment GoldenGateデプロイメント
oci_compute_instance インスタンス
oci_vpn_ipsectunnel IPSecトンネル
oci_load_balancer ロード・バランサ
oci_media_workflow メディア・ワークフロー
oci_media_workflow_job メディア・ワークフロー・ジョブ
oci_network_firewall ネットワーク・ファイアウォール
oci_os_bucket オブジェクト・ストレージ(バケット)
oci_cache OCIキャッシュ
omc_postgresql_db OCI Database with PostgreSQL
omc_opc_ics_instance OICインスタンス
oci_opctloperatorcontrol オペレータ・コントロール
omc_postgresql_db PostgreSQLデータベース・システム
oci_service_connector サービス・コネクタ
オッチボールト ボールト
oci_vcn OCI仮想クラウド・ネットワーク(VCN)
oci_vcn_subnet OCI VCNサブネット
oci_vcn_vnic OCI VCN仮想ネットワーク・インタフェース・カード(VNIC)
oci_webappfirewall Webアプリケーション・ファイアウォール

ENTITY_TYPES_FOR_TAG_PREFERENCESプリファレンスでサポートされている追加のエンティティ・タイプ

Log Analyticsエンティティ・タイプ リソース
omc_mgmt_agent 管理エージェント
omc_host_aix ホスト(AIX)
omc_host_linux ホスト(Linux)
omc_host_solaris ホスト(Solaris)
omc_host_ウィンドウ ホスト(Windows)