大規模なアクティビティ・ストリーム・ペイロードに対するOracle Log Analyticsの使用
アクティビティ・ストリーム・ログをOracle Log Analyticsに公開できます。これは、Oracle Cloud Infrastructure (OCI)パブリック・ロギングによってログ・ファイルのサイズが制限されるため、アクティビティ・ストリーム・ペイロードが大きい場合に役立ちます。
アクティビティ・ストリーム・ログをそこで公開するには、Oracle Log Analyticsをサブスクライブする必要があります。
アクティビティ・ストリーム・ログのOracle Log Analyticsへの格納を後で停止する場合は、Oracle Integrationインスタンスに対して無効にできます。Oracle Log Analyticsでのログの格納の無効化を参照してください
ログをOracle Log Analyticsに格納するためのログ・グループの作成
Oracle Integrationアクティビティ・ストリーム・ログを格納するログ・グループをOracle Log Analyticsに作成するには、次のステップを実行します:
- Oracle Cloudコンソールで、ナビゲーション・メニューを開き、「監視および管理」をクリックし、「Log Analytics」で「管理」をクリックします。
- 「ログ・グループ」ページの左側のメニューで、「ログ・グループ」をクリックします。
- 「適用済フィルタ」の横に、ログ・グループを作成するコンパートメントが表示されていることを確認します。
- 「ログ・グループの作成」をクリックします。
- 名前と説明を入力します(たとえば、
OracleIntegration_ActivityStream_LogGroup)。 - 「作成」をクリックします。
Oracle Integrationからのログ・アップロードを許可するポリシーの作成
Oracle Integrationからのログ・アップロードを許可するポリシーを作成するには、次のステップを実行します:
- まだサインインしていない場合は、Oracle Cloudコンソールにサインインしてください。
- Oracle IntegrationインスタンスのクライアントIDを取得します:
- Oracle Cloudコンソールのナビゲーション・メニューで、「アイデンティティおよびセキュリティ」をクリックし、「アイデンティティ」で「ドメイン」をクリックします。
- Oracle Integrationインスタンスを作成したドメインを開きます。
ドメインが表示されない場合は、正しいリージョン(バナー内)にあり、正しいコンパートメント(フィルタ内)が表示されていることを確認します。
- 上部のタブで、「Oracleクラウド・サービス」をクリックします。
- Oracle Integrationインスタンスを開きます。
インスタンスの検索に問題がある場合、「統合」を検索すると選択肢が絞り込まれます。
- 上部のタブで、OAuth configurationをクリックします。
- 「一般情報」セクションまでスクロール・ダウンし、「クライアントID」をコピーします。
- ポリシーで使用する動的グループを作成します。
- ページ上部の「Oracleクラウド・サービス」をクリックして、ドメインに戻ります。
- 上部のタブで、「動的グループ」をクリックします。
- 動的グループの作成をクリックします。
- グループの名前(たとえば、
OracleIntegration_LogAnalytics_DynamicGroup)および説明を入力します。 - 「ルール1」ボックスに、次のルールを入力します。
構文:
resource.id='OracleIntegration_ClientID'
説明:OracleIntegration_ClientIDは、ステップ2でコピーしたクライアントIDです
例:resource.id='A01BC23DE4567FGH89I0123456J78901_APPID'
- ポリシーを作成します。
- 左側のナビゲーション・ペインで、「ポリシー」をクリックします。
- 「ポリシーの作成」をクリックします。
- ポリシーの名前(たとえば、
OracleIntegration_LogUploadPolicy)および説明を入力します。 - 「手動エディタの表示」をクリックします。
- 次の権限を入力します。
構文:
allow dynamic-group DynamicGroup to {LOG_ANALYTICS_LOG_GROUP_UPLOAD_LOGS} in compartment LogGroup_Compartmentallow dynamic-group DynamicGroup to {LOG_ANALYTICS_SOURCE_READ} in tenancyallow dynamic-group DynamicGroup to use loganalytics-ondemand-upload in tenancyallow dynamic-group DynamicGroup to {LOG_ANALYTICS_LOG_GROUP_UPLOAD_LOGS} in tenancy
説明:DynamicGroupは、ステップ3で作成した動的グループです。LogGroup_Compartmentは、ログ・グループを作成したコンパートメントです
例:allow dynamic-group OracleIntegration_LogAnalytics_DynamicGroup to {LOG_ANALYTICS_LOG_GROUP_UPLOAD_LOGS} in compartment OracleIntegration_LogGroup_Compartmentallow dynamic-group OracleIntegration_LogAnalytics_DynamicGroup to {LOG_ANALYTICS_SOURCE_READ} in tenancyallow dynamic-group OracleIntegration_LogAnalytics_DynamicGroup to use loganalytics-ondemand-upload in tenancyallow dynamic-group OracleIntegration_LogAnalytics_DynamicGroup to {LOG_ANALYTICS_LOG_GROUP_UPLOAD_LOGS} in tenancy
ユーザーがOracle Log Analyticsでログを表示できるようにするポリシーの作成
ユーザーがOracle Log Analyticsでログを表示できるようにするポリシーを作成するには、次のステップを実行します。
- Oracle Log Analyticsでアクティビティ・ストリーム・ログを表示できるようにするユーザーのグループを作成します:
- 左側のナビゲーション・ペインで、「ドメイン」をクリックします。
- Oracle Integrationインスタンスを作成したドメインを開きます。
ドメインが表示されない場合は、正しいリージョン(バナー内)にあり、正しいコンパートメント(フィルタ内)が表示されていることを確認します。
- 上部のタブで、「ユーザー管理」をクリックします。
- 「グループ」セクションまでスクロール・ダウンし、「グループの作成」をクリックします。
- グループの名前(たとえば、
OracleIntegration_LogAnalytics_Group)および説明を入力します。 - グループにユーザーを追加します。
- 「作成」をクリックします。
- ポリシーの作成:
- 左側のナビゲーション・ペインで、「ポリシー」をクリックします。
- 「ポリシーの作成」をクリックします。
- ポリシーの「名前」(
OracleIntegration_LogAnalyticsAccessPolicyなど)および「説明」を入力します。 - 「手動エディタの表示」をクリックします。
- エディタで、次の権限を入力します。
構文:
allow group UserGroup to use loganalytics-features-family in tenancyallow group UserGroup to use loganalytics-resources-family in tenancy
説明:UserGroupは、ステップ1で作成したグループです
例:allow group OracleIntegration_LogAnalytics_Group to use loganalytics-features-family in tenancyallow group OracleIntegration_LogAnalytics_Group to use loganalytics-resources-family in tenancy
Oracle Log Analyticsにログを公開するオプションの有効化
Oracle Integrationアクティビティ・ストリーム・ログをOracle Log Analyticsに格納できるようにするには、次のステップを実行します:
- 作成したログ・グループのOCIDを取得します。
- Oracle Cloudコンソールのナビゲーション・メニューで、「監視および管理」をクリックし、「ログ分析」で「管理」をクリックします。
- 左側のナビゲーション・ペインで、「ログ・グループ」をクリックします。
- Oracle Integration用に作成したログ・グループの横にある
をクリックし、「OCIDのコピー」をクリックします。
ログが表示されない場合は、正しいコンパートメント(左側のメニュー)が表示されていることを確認します。
- 次のオプションを有効にします。
- Oracle Cloudコンソールのナビゲーション・メニューで、「開発者サービス」をクリックし、「アプリケーション統合」で「統合」をクリックします。
- Oracle Integrationインスタンスを開きます。
探しているインスタンスが表示されない場合は、適切なリージョン(バナー内)およびコンパートメント(インスタンス・リストの上部、「適用済フィルタ」の横)が表示されていることを確認します。
- 「設定」で、「OCI Log Analyticsにアクティビティ・ストリーム・ログを格納」の横にある「有効化」をクリックします。
- コピーしたOCIDをOCI Log Analyticsログ・グループ・ボックスに貼り付け、「保存」をクリックします。
サービス・インスタンスのステータスが「更新中」に変わります。完了すると、ステータスが「アクティブ」に変わり、「リンク」の下に、ログ・グループのOCIDを示すOCI Log Analyticsログ・グループの新しいエントリが表示されます。
Oracle Log Analyticsでのログの格納の無効化
Oracle Log Analyticsへのアクティビティ・ストリーム・ログの格納を停止する場合は、Oracle Integrationインスタンスに対して無効にできます。
- Oracle Cloudコンソールのナビゲーション・メニューで、「開発者サービス」をクリックし、「アプリケーション統合」で「統合」をクリックします。
- Oracle Integrationインスタンスを開きます。
インスタンスが表示されない場合は、正しいコンパートメント(左側のメニュー)が表示されていることを確認します。
- 「設定」で、「OCI Log Analyticsにアクティビティ・ストリーム・ログを格納」の横にある「無効化」をクリックします。
処理を確認するよう求められます。
サービス・インスタンスのステータスが「更新中」に変わります。完了すると、ステータスが「アクティブ」に変わり、「アクティビティ・ストリーム・ログをOCI Log Analyticsに格納」に「無効」と表示されます。