大規模なアクティビティ・ストリーム・ペイロードに対するOracle Log Analyticsの使用

Oracle Integrationアクティビティ・ストリーム・ログを格納するログ・グループをOracle Log Analyticsに作成するには、次のステップを実行します。

1. Oracle Cloud Consoleで、ナビゲーション・メニューを開き、「監視および管理」をクリックし、「Log Analytics」で「管理」をクリックします。
2. 「ログ・グループ」ページの左側のメニューで、「ログ・グループ」をクリックします。
3. 「適用済フィルタ」の横に、ログ・グループを作成するコンパートメントが表示されていることを確認します。
4. 「ログ・グループの作成」をクリックします。
5. 名前と説明を入力します(たとえば、OracleIntegration_ActivityStream_LogGroup)。
6. 「作成」をクリックします。

Oracle Integrationからのログ・アップロードを許可するポリシーを作成するには、次のステップを実行します。

1. まだサインインしていない場合は、Oracle Cloudコンソールにサインインしてください。
2. Oracle IntegrationインスタンスのクライアントIDを取得します:
   1. Oracle Cloudコンソールのナビゲーション・メニューで、「アイデンティティおよびセキュリティ」をクリックし、「アイデンティティ」で「ドメイン」をクリックします。
   2. Oracle Integrationインスタンスを作成したドメインを開きます。

      ドメインが表示されない場合は、正しいリージョン(バナー内)にあり、正しいコンパートメント(フィルタ内)が表示されていることを確認します。

   3. 上部のタブで、「Oracleクラウド・サービス」をクリックします。
   4. Oracle Integrationインスタンスを開きます。

      インスタンスの検索に問題がある場合、「統合」を検索すると選択肢が絞り込まれます。

   5. 上部のタブで、OAuth configurationをクリックします。
   6. 「一般情報」セクションまでスクロール・ダウンし、「クライアントID」をコピーします。
3. ポリシーで使用する動的グループを作成します。
   1. ページ上部の「Oracleクラウド・サービス」をクリックして、ドメインに戻ります。
   2. 上部のタブで、「動的グループ」をクリックします。
   3. 動的グループの作成をクリックします。
   4. グループの名前(たとえば、OracleIntegration_LogAnalytics_DynamicGroup)および説明を入力します。
   5. 「ルール1」ボックスに、次のルールを入力します。
      構文:

      • resource.id='OracleIntegration_ClientID'
      説明:

      • OracleIntegration_ClientIDは、ステップ2でコピーしたクライアントIDです
      例:

      • resource.id='A01BC23DE4567FGH89I0123456J78901_APPID'
4. ポリシーを作成します。
   1. 左側のナビゲーション・ペインで、「ポリシー」をクリックします。
   2. 「ポリシーの作成」をクリックします。
   3. ポリシーの名前(たとえば、OracleIntegration_LogUploadPolicy)および説明を入力します。
   4. 「手動エディタの表示」をクリックします。
   5. 次の権限を入力します。
      構文:

      • allow dynamic-group DynamicGroup to {LOG_ANALYTICS_LOG_GROUP_UPLOAD_LOGS} in compartment LogGroup_Compartment
      • allow dynamic-group DynamicGroup to {LOG_ANALYTICS_SOURCE_READ} in tenancy
      • allow dynamic-group DynamicGroup to use loganalytics-ondemand-upload in tenancy
      • allow 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_Compartment
      • allow dynamic-group OracleIntegration_LogAnalytics_DynamicGroup to {LOG_ANALYTICS_SOURCE_READ} in tenancy
      • allow dynamic-group OracleIntegration_LogAnalytics_DynamicGroup to use loganalytics-ondemand-upload in tenancy
      • allow dynamic-group OracleIntegration_LogAnalytics_DynamicGroup to {LOG_ANALYTICS_LOG_GROUP_UPLOAD_LOGS} in tenancy

ユーザーがOracle Log Analyticsでログを表示できるようにするポリシーを作成するには、次のステップを実行します。

1. Oracle Log Analyticsでアクティビティ・ストリーム・ログを表示できるようにするユーザーのグループを作成します:
   1. 左側のナビゲーション・ペインで、「ドメイン」をクリックします。
   2. Oracle Integrationインスタンスを作成したドメインを開きます。

      ドメインが表示されない場合は、正しいリージョン(バナー内)にあり、正しいコンパートメント(フィルタ内)が表示されていることを確認します。

   3. 上部のタブで、「ユーザー管理」をクリックします。
   4. 「グループ」セクションまでスクロール・ダウンし、「グループの作成」をクリックします。
   5. グループの名前(たとえば、OracleIntegration_LogAnalytics_Group)および説明を入力します。
   6. グループにユーザーを追加します。
   7. 「作成」をクリックします。
2. ポリシーを作成します。
   1. 左側のナビゲーション・ペインで、「ポリシー」をクリックします。
   2. 「ポリシーの作成」をクリックします。
   3. ポリシーの「名前」(OracleIntegration_LogAnalyticsAccessPolicyなど)および「説明」を入力します。
   4. 「手動エディタの表示」をクリックします。
   5. エディタで、次の権限を入力します。
      構文:

      • allow group UserGroup to use loganalytics-features-family in tenancy
      • allow group UserGroup to use loganalytics-resources-family in tenancy
      説明:

      • UserGroupは、ステップ1で作成したグループです。
      例:

      • allow group OracleIntegration_LogAnalytics_Group to use loganalytics-features-family in tenancy
      • allow group OracleIntegration_LogAnalytics_Group to use loganalytics-resources-family in tenancy

Oracle Integrationアクティビティ・ストリーム・ログのOracle Log Analyticsへの格納を有効にするには、次のステップを実行します。

1. 作成したログ・グループのOCIDを取得します。
   1. Oracle Cloudコンソールのナビゲーション・メニューで、「監視および管理」をクリックし、「ログ分析」で「管理」をクリックします。
   2. 左側のナビゲーション・ペインで、「ログ・グループ」をクリックします。
   3. Oracle Integration用に作成したログ・グループの横にあるをクリックし、「OCIDのコピー」をクリックします。

      ログが表示されない場合は、正しいコンパートメント(左側のメニュー)が表示されていることを確認します。

2. 次のオプションを有効にします。
   1. Oracle Cloudコンソールのナビゲーション・メニューで、「開発者サービス」をクリックし、「アプリケーション統合」で「統合」をクリックします。
   2. Oracle Integrationインスタンスを開きます。

      探しているインスタンスが表示されない場合は、適切なリージョン(バナー内)およびコンパートメント(インスタンス・リストの上部、「適用済フィルタ」の横)が表示されていることを確認します。

   3. 「設定」で、「OCI Log Analytics」の横にある「有効化」をクリックします。
   4. コピーしたOCIDを「ログ・グループのOCID」ボックスに貼り付け、「更新」をクリックします。

      サービス・インスタンスのステータスが「更新中」に変わります。完了すると、ステータスが「アクティブ」に変わり、「OCI Log Analytics」でログ分析が有効になっていることがわかります。ログ・グループのOCIDを示す統合ログ・グループの新しいエントリも表示されます。

アクティビティ・ストリーム・ログのOracle Log Analyticsへの格納を停止する場合は、Oracle Integrationインスタンスに対して無効にできます。

1. Oracle Cloudコンソールのナビゲーション・メニューで、「開発者サービス」をクリックし、「アプリケーション統合」で「統合」をクリックします。
2. Oracle Integrationインスタンスを開きます。

   インスタンスが表示されない場合は、正しいコンパートメント(左側のメニュー)が表示されていることを確認します。

3. OCI Log Analyticsで、OCI Log Analyticsの横にある「無効化」をクリックします。

   処理を確認するよう求められます。

   サービス・インスタンスのステータスが「更新中」に変わります。完了すると、ステータスが「アクティブ」に変わり、OCI Log Analyticsに「使用不可」と表示されます。

ヒューマン・イン・ループ・ランタイムのデータ保持

ヒューマン・イン・ループ・ランタイム・データは、Oracle Integration内に格納され、Oracle Integrationインスタンス用に構成されたデータ保持設定によって管理されます。この保存設定により、ワークフロー・インスタンスが終了状態になった後、ワークフロー・ランタイム・データおよび関連するタスク履歴が使用可能になる期間が決まります。

構成された保持期間が経過すると、ワークフロー・インスタンスおよび関連するタスク履歴がOracle Integrationから自動的に削除されます。

標準データ保持要件と長期監査要件

通常、標準のデータ保持期間は、最近のワークフロー実行の監視、失敗の調査、タスク・アクティビティのレビュー、問題のトラブルシューティングなど、日常的なワークフロー管理および分析に十分です。

ただし、標準のデータ保持期間は、長期的な監査、コンプライアンスまたはガバナンス要件では不十分である場合があります。

財務承認、人事決定、規制ワークフローなどのビジネス・プロセスは、数年間再構築可能である必要がある場合があります。組織は、プロセス中に何が発生したか、特定のアクティビティが発生した時期、およびループ・ワークフロー・インスタンスの元の人員とそのタスク履歴がOracle Integrationからパージされた後でもワークフローがどのように進行したかをデモンストレーションする必要がある場合があります。

これにより、標準的なデータ保持と長期的な監査保持との間に重要な違いが生じます。標準データ保持では、主に日常的なワークフロー管理および分析をサポートするためにワークフロー・データが保持されますが、監査要件およびコンプライアンス要件では、データの保持期間が大幅に長くなる場合があります。

Oracle Log Analyticsへのログの公開による監査性の拡張

Oracle Log Analyticsへのログ公開を有効にすると、この長期保存要件に対処するためのメカニズムが提供されます。

ログの公開を有効にすると、ループ・イベントの人間は、OCIテナンシ内の組織が所有するログ・グループに送信されます。このログ・データの保存期間は、組織の運用、監査およびコンプライアンスの要件に応じて個別に構成できます。

ダッシュボードによる業務の可視性

運用面では、すべての状態の変更が、ワークフロー、タスク、担当者、承認者、結果、期間、期日、優先度などの豊富なコンテキスト・フィールドとともに記録されます。この詳細レベルにより、ワークフロー実行の可視性が向上し、ワークスペース内から直接分析することが困難な業務上の質問への回答が容易になります。

ダッシュボード機能により、この情報が統合されたビジュアル形式にまとめられるため、個々の問合せを記述することなく、ワークフローおよびタスク・アクティビティに関するインサイトを取得できます。たとえば、ダッシュボードは、次のような質問への回答に役立ちます。

ダッシュボードの表示方法を学習するには、Oracle Integration 3でのループでのヒューマンの使用のダッシュボードの表示を参照してください。

ログ・エクスプローラを使用したログの調査

Oracle Log Analyticsのログ・エクスプローラを使用して、ループ・アクティビティ・ストリーム・ログで公開されたヒューマンを検索して検査します。ログ・エクスプローラは、特定のワークフロー・インスタンスの調査や、監査チームまたはコンプライアンス・チームからの特定の質問への回答に役立ちます。

たとえば、特定の期間のワークフロー・インスタンスに関する情報が必要な場合は、適用可能な時間範囲を選択し、インスタンスを検索し、使用可能なフィールドおよび問合せ機能を使用して、関連するアクティビティ・ストリーム・レコードを調べることができます。

ログの表示方法を学習するには、Oracle Integration 3でのループでのヒューマンの使用のログの表示を参照してください。

Oracle Log Analyticsでログ・グループを作成し、ループ・アクティビティ・ストリーム・ログに人員を格納するには、次のステップを実行します。

1. Oracle Cloudコンソール内で、ナビゲーション・メニューを開き、「監視および管理」をクリックし、「Log Analytics」で「管理」をクリックします。
2. 「ログ・グループ」ページの左側のメニューで、「ログ・グループ」をクリックします。
3. 「適用済フィルタ」の横に、ログ・グループを作成するコンパートメントが表示されていることを確認します。
4. 「ログ・グループの作成」をクリックします。
5. 名前と説明を入力します(たとえば、ActivityStream_LogGroupなど)。
6. 「作成」をクリックします。

ヒューマンからのループ内のログ・アップロードを許可するポリシーを作成するには、次のステップを実行します。

1. まだサインインしていない場合は、Oracle Cloudコンソールにサインインしてください。
2. ループ・インスタンスで人間のOCIDを取得します。
   1. Oracle Cloudコンソールのナビゲーション・メニューで、「開発者サービス」をクリックし、「アプリケーション統合」で「統合」をクリックします。
   2. ヒューマン・イン・ループが有効になっているOracle Integrationインスタンスを開きます。

      探しているインスタンスが表示されない場合は、適切なリージョン(バナー内)およびコンパートメント(インスタンス・リストの上部、「適用済フィルタ」の横)が表示されていることを確認します。

   3. 統合インスタンスの詳細ページの「ループ内の人間」セクションで、「OCID」(プロセス自動化インスタンスを一意に識別する値)をコピーします。
3. ポリシーで使用する動的グループを作成します。
   1. ページ上部の「Oracleクラウド・サービス」をクリックして、ドメインに戻ります。
   2. 上部のタブで、「動的グループ」をクリックします。
   3. 動的グループの作成をクリックします。
   4. グループの名前(たとえば、LogAnalytics_DynamicGroup)および説明を入力します。
   5. 「ルール1」ボックスに、次のルールを入力します。
      構文:

      • resource.id='Humanintheloop_OCID'
      説明:

      • Humanintheloop_OCID は、ステップ2でコピーしたOCIDです
4. ポリシーを作成します。
   1. 左側のナビゲーション・ペインで、「ポリシー」をクリックします。
   2. 「ポリシーの作成」をクリックします。
   3. ポリシーの名前(たとえば、LogUploadPolicy)と説明を入力します。
   4. 「手動エディタの表示」をクリックします。
   5. 次の権限を入力します。
      構文:

      • allow dynamic-group DynamicGroup to {LOG_ANALYTICS_LOG_GROUP_UPLOAD_LOGS} in compartment LogGroup_Compartment
      • allow dynamic-group DynamicGroup to {LOG_ANALYTICS_SOURCE_READ} in tenancy
      • allow dynamic-group DynamicGroup to use loganalytics-ondemand-upload in tenancy
      • allow dynamic-group DynamicGroup to {LOG_ANALYTICS_LOG_GROUP_UPLOAD_LOGS} in tenancy
      説明:

      • DynamicGroupは、ステップ3で作成した動的グループです。
      • LogGroup_Compartmentは、Oracle Log Analyticsのループ・ログに人間を格納するログ・グループを作成するコンパートメントです
      例:

      • allow dynamic-group LogAnalytics_DynamicGroup to {LOG_ANALYTICS_LOG_GROUP_UPLOAD_LOGS} in compartment LogGroup_Compartment
      • allow dynamic-group LogAnalytics_DynamicGroup to {LOG_ANALYTICS_SOURCE_READ} in tenancy
      • allow dynamic-group LogAnalytics_DynamicGroup to use loganalytics-ondemand-upload in tenancy
      • allow dynamic-group LogAnalytics_DynamicGroup to {LOG_ANALYTICS_LOG_GROUP_UPLOAD_LOGS} in tenancy

ヒューマンをOracle Log Analyticsのループ・アクティビティ・ストリーム・ログに格納するには、次のステップを実行します。

1. 作成したログ・グループのOCIDを取得します。
   1. Oracle Cloudコンソールのナビゲーション・メニューで、「監視および管理」をクリックし、「ログ分析」で「管理」をクリックします。
   2. 左側のナビゲーション・ペインで、「ログ・グループ」をクリックします。
   3. ループでヒューマン用に作成したログ・グループの横にあるをクリックし、「OCIDのコピー」をクリックします。

      ログが表示されない場合は、正しいコンパートメント(左側のメニュー)が表示されていることを確認します。

2. 次のオプションを有効にします。
   1. Oracle Cloudコンソールのナビゲーション・メニューで、「開発者サービス」をクリックし、「アプリケーション統合」で「統合」をクリックします。
   2. Oracle Integrationインスタンスを開きます。

      探しているインスタンスが表示されない場合は、適切なリージョン(バナー内)およびコンパートメント(インスタンス・リストの上部、「適用済フィルタ」の横)が表示されていることを確認します。

   3. 「OCI Log Analytics」で、「ループ内のヒューマン」の横にある「有効化」をクリックします。
   4. コピーしたOCIDを「ログ・グループのOCID」ボックスに貼り付け、「更新」をクリックします。

      サービス・インスタンスのステータスが「更新中」に変わります。完了すると、ステータスが「アクティブ」に変わり、「OCI Log Analytics」で、ログ分析が「ループ内の人間」に対して有効になっていることがわかります。Human in the Loop log groupの新しいエントリも表示され、ログ・グループのOCIDが示されます。

   パーサー(ログ・ファイルをログ・エントリに解析する方法と、ログ・エントリをフィールドに解析する方法の定義)が自動的に作成されます。パーサーを表示するには、次のステップを実行します。

   1. Oracle Cloudコンソールのナビゲーション・メニューで、「監視および管理」をクリックし、「ログ分析」で「管理」をクリックします。
   2. 左側のナビゲーション・ペインで、「パーサー」をクリックします。

      「パーサー」ページに、使用可能なパーサーのリストが表示されます。

   3. ループでヒューマン用に作成されたパーサーをクリックして、ログ内のどの要素がログ分析のどの要素にマップされているかを確認できます。

Oracle Log Analyticsでの人間のアクティビティ・ストリーム・ログのループへの格納を停止する場合は、Oracle Integrationインスタンスに対してそれを無効にできます。

1. Oracle Cloudコンソールのナビゲーション・メニューで、「開発者サービス」をクリックし、「アプリケーション統合」で「統合」をクリックします。
2. Oracle Integrationインスタンスを開きます。

   インスタンスが表示されない場合は、正しいコンパートメント(左側のメニュー)が表示されていることを確認します。

3. 「OCI Log Analytics」で、「ループ内の人間」の横にある「無効化」をクリックします。

   処理を確認するよう求められます。

   サービス・インスタンスのステータスが「更新中」に変わります。完了すると、ステータスが「アクティブ」に変わり、「ヒューマン・イン・ザ・ループ」に「使用不可」が表示されます。