収集するサービス・ログのタイプに基づいて、Oracle Log Analyticsで、リソースに関する情報を取得し、各リソースのエンティティを作成できるようにするポリシーを作成する必要があります。

ポリシーを作成すると、作成されるエンティティは、そのリソースから収集されたすべてのログに自動的に関連付けられます。ポリシーを作成しない場合、ログは収集されますが、エンティティは作成されません。

次の権限は、サービス・コネクタからOracle Log Analyticsにログをアップロードするためのものです。OCIコンソールを使用してサービス・コネクタを作成するときに、これらのポリシー・ステートメントを追加するように求められます。または、次のポリシー・ステートメントを含むポリシーを手動で作成できます。

allow any-user to {LOG_ANALYTICS_LOG_GROUP_UPLOAD_LOGS} in compartment id <Log_Group_Compartment_OCID> where all {request.principal.type = 'serviceconnector', target.loganalytics-log-group.id = '<Log_Group_OCID>', request.principal.compartment.id = '<Service_Connector_Compartment_OCID>'}
allow group <userGroup> to MANAGE serviceconnectors in tenancy
allow group <userGroup> to READ logging-family in tenancy

上記のポリシーでは、

• Log_Group_Compartment_OCID: ログを格納する必要があるOracle Log Analyticsのログ・グループのコンパートメントOCID。

• Log_Group_OCID: ログを格納する必要があるOracle Log Analyticsのログ・グループのOCID。

• Service_Connector_Compartment_OCID: サービス・コネクタ・ハブのコンパートメントOCID。

Oracle Log Analyticsは、サービス・コネクタを介して新しいログを受信したときに、基礎となるOCIリソースを表すエンティティを作成します。OCIリソースから必要な情報を取得するには、OCIリソースへのread以上のアクセスをOracle Log Analyticsに提供する必要があります。たとえば、オブジェクト・ストレージ内のバケットに関する情報を読み取るには、次のいずれかのポリシーを記述できます:

OCIリソースのREAD PRIVILEGEを含むポリシー・ステートメント:

allow resource loganalyticsvrp LogAnalyticsVirtualResource to {BUCKET_READ} in compartment <specify_compartment>

または

OCI RESOURCEのread動詞を含むポリシー・ステートメント:

allow resource loganalyticsvrp LogAnalyticsVirtualResource to read buckets in compartment <specify_compartment>

前述のポリシー・ステートメントは、コンパートメントへのreadアクセスを制限します。テナンシ全体へのアクセスを拡張するには、それに応じてポリシー・ステートメントを変更できます。

Oracle Log Analyticsでは、サービス・コネクタを介したログ収集のために、次のOCIリソースがサポートされています。前述のように、OCIリソースのread verbを使用してポリシーを作成するか、リソースにread privilegeを使用できます。

ログを収集するためのサービス・コネクタを設定する前に、収集するログのコンパートメントおよびログ・グループを識別してください。

次の例のステップでは、Oracle Cloud Infrastructure LoggingサービスからVCNサービス・ログを収集する方法を示します:

1. これは、Oracle Cloud Infrastructure Loggingサービスでログを有効にする方法を示す推奨ステップです。

   Oracle Cloud Infrastructure Loggingサービスに移動し、「ログ」に移動します。

   「リソース・ログの有効化」をクリックして、VCNサービス・ログを有効にします。ダイアログ・ボックスが開きます。

   1. リソース・コンパートメントを選択します。
   2. サービスを選択します。たとえば、仮想クラウド・ネットワーク(サブネット)。
   3. リソースを選択します。たとえば、VCNリソース。
   4. 「ログの構成」で、フロー・ログなどのログ・カテゴリとログ名を選択します。
   5. 「ログの場所」で、Oracle Log Analyticsでログを参照するコンパートメントとログ・グループを選択します。

   「ログの有効化」をクリックします。

2. ログのソース・サービスおよびターゲットのOracle Log Analyticsを指定して、サービス・コネクタを設定します。これは、Oracle Cloud Infrastructureサービス・コネクタ・ハブと統合されているソース・サービス(Oracle Cloud Infrastructure Loggingサービスなど)から、または直接Oracle Cloud Infrastructureサービス・コネクタ・ハブから設定できます。

   Oracle Cloud Infrastructure ロギング・サービスに移動し、「サービス・コネクタ」に移動して、「コネクタの作成」をクリックします。

   または、Oracle Cloud Infrastructureサービス・コネクタ・ハブ・サービスに移動し、「サービス・コネクタの作成」をクリックします。

   「サービス・コネクタの作成」ページが開きます。

   1. コネクタの名前を入力し、説明を指定します。
   2. コネクタ・リソースを作成する必要があるリソース・コンパートメントを選択します。
   3. 「サービス・コネクタの構成」で、ロギングをソース・サービスとして、ログ・アナリティクスをターゲット・サービスとして指定します。
   4. 「ソース接続の構成」で、サービスから収集するログの詳細(VCNサービス・ログなど)を指定します。

      コンパートメント名、ログが属しているログ・グループ、およびステップ1で構成したログの名前を選択します。

   同じサービス・コネクタを構成して、より多くのログを収集できます。「別のログ」をクリックし、ステップ2-dを繰り返します。

   オプションで、「タスクの構成」でフィルタを作成できます。

   「コネクタの作成」をクリックします。

サービス・コネクタの作成後、選択したログがOracle Log Analyticsで使用できることを確認できます。

ログを収集するOracle Cloud Infrastructure Loggingなどのソース・サービスのテナントをSource_Tenantとします。サービス・コネクタを作成するテナントをTarget_Tenantとします。サービス・コネクタは、ソース・サービスから収集されるログのターゲットとしてOracle Log Analyticsで構成されます。サービス・コネクタ・ハブとOracle Log Analyticsが同じターゲット・テナントで使用できることを前提としています。

次のポリシーを設定して、サービス・コネクタが作成されるテナンシとは異なるテナンシからのログ収集を構成します。

define tenancy <Target_Tenant> as <Target_Tenant_OCID>
define group <Common_User_Group> as <Common_User_Group_OCID>
admit any-user of tenancy <Target_Tenant> to read logging-family IN TENANCY WHERE ALL {request.principal.type = 'serviceconnector'}
admit group <Common_User_Group> of tenancy <Target_Tenant> to read logging-family IN TENANCY

admit group <Common_User_Group> of tenancy <Target_Tenant> to read audit-events in TENANCY
admit any-user of tenancy <Target_Tenant> to read audit-events IN tenancy WHERE ALL {request.principal.type = 'serviceconnector'}

define tenancy <Source_Tenant> as <Source_Tenant_OCID>
endorse any-user to read logging-family IN tenancy <Source_Tenant> WHERE ALL {request.principal.type = 'serviceconnector'}
endorse group <Common_User_Group> to read logging-family IN tenancy <Source_Tenant>

endorse group <Common_User_Group> to read audit-events in tenancy <Source_Tenant>
endorse any-user to read audit-events in tenancy <Source_Tenant> WHERE ALL {request.principal.type = 'serviceconnector'}

allow any-user to {LOG_ANALYTICS_LOG_GROUP_UPLOAD_LOGS} in compartment id <Log_Group_Compartment_OCID> where all {request.principal.type = 'serviceconnector', target.loganalytics-log-group.id = '<Log_Group_OCID>', request.principal.compartment.id = '<Service_Connector_Compartment_OCID>'}
allow group <Common_User_Group> to MANAGE serviceconnectors in tenancy

oci --profile <Target_Profile> sch service-connector create 
    --display-name XTenancyConnector 
    --compartment-id <Connector_Compartment_OCID> 
    --source '{ "kind": "logging", "logSources": 
        [ { "compartmentId": "<Logging_LogGroup_Compartment_OCID>", 
            "logGroupId": "<Logging_LogGroup_OCID>" } ] }' 
    --target '{ "kind": "loggingAnalytics", "logGroupId": "<LogAnalytics_LogGroup_OCID>" }'

OCI LoggingからOracle Log Analyticsにログを継続的に収集するようにサービス・コネクタを設定している場合は、コネクタを非アクティブ化するか削除することで、ログ収集を停止できます。

ログ収集を一時的に停止し、後でログ収集を再開できるようにコネクタ構成を保持する必要がある場合は、コネクタを非アクティブ化します。

サービス・コネクタからログ収集を完全に停止する場合は、コネクタを削除します。

1. ログ収集用に設定されているサービス・コネクタの識別: コネクタ・ハブ・サービスに移動し、コンパートメント内のコネクタをリストします。コネクタのリストを参照してください。

   コネクタの名前をクリックして、コネクタの詳細および構成を表示します。ログ収集に設定されている適切なサービス・コネクタを特定します。

2. ログ収集の停止: 要件に応じて、「非アクティブ化」または「削除」をクリックします。コネクタの非アクティブ化およびコネクタの削除を参照してください。

   これにより、特定のOCIサービスからOracle Log Analyticsへのデータ・フローが停止します。

コネクタを非アクティブ化し、ログ収集を再開する場合は、そのコネクタを再アクティブ化します。「コネクタのアクティブ化」を参照してください。