統合のアクティブ化および非アクティブ化

統合設計が完了したら、統合をアクティブ化できます。統合を非アクティブ化することもできます。

トピック:

統合のアクティブ化

統合を作成し、進捗インジケータが100%になったら、その統合を実行環境に対してアクティブ化できます。統合が100%として表示され、アクティブ化の対象となるのは、ソース接続、ターゲット接続、データ・マッピングおよび追跡フィールドを指定した後です。

アクティブな統合の数に関する制限の理解

Oracle Integrationインスタンス当たりのアクティブな統合の数は700を超えることはできません。アクティブな統合は、アクティブ化が進行中の現在アクティブな統合および統合として定義されます。

この制限の90%に達すると、次の警告が表示されます:

You've number integrations which are either active or whose activation is in progress. 
It is more than 90% of the allowed limit.

700の制限に達すると、統合をアクティブ化するための「アクティブ化」または「アクティブ化&スケジュール」ボタンが無効になり、次の警告が表示されます。
```
You've reached the limit as there are 700 integrations which are either active 
or whose activation is in progress. Deactivate or abort the activation of an integration 
and try again.
```
制限に近づいている場合は、不要になった古い統合をレビューおよび削除します。

統合をアクティブ化するには:

ノート:

既存の統合の新しいバージョンをアクティブ化しても、古いバージョンのインスタンスまたはログの追跡は削除されません。ただし、関連するアーティファクトは削除され、再デプロイはバック・エンドで実行されます。監視データも削除されます。

左側のナビゲーション・ペインで、「ホーム」>「統合」>「統合」をクリックします。
アクティブ化する統合の行に移動します。
アイコンをクリックして、統合をアクティブ化します。
「Confirmation」ダイアログが表示されます。

統合に適したオプションを選択します。このOracle Integrationインスタンスのアクティブ化済統合の数が制限の90%を超えている場合は、ダイアログに警告メッセージが表示されます。

要素	説明
Oracle Recommendationsへの統合マッピングの提供	クリックすると、Oracle Recommendations Engineが有効になります。集合インテリジェンスを使用して、統合を開発する際にマップするフィールドを推奨します。これらの推奨事項は、匿名でOracle Recommendations Engineに提供されたマッピングに基づいて作成されています。これは、ナビゲーション・ペインで「設定」> 「推奨」を選択して、Recommendationsページで変更できます。
アサータ記録の有効化	クリックすると、再生およびテストのためのペイロードおよびレコード・インスタンスが取得されます。「統合インスタンスのテスト」を参照してください。
トレースを有効にする	アクティビティ・ストリームの詳細なトレース情報を有効にする場合にクリックします。トレース・レベルは請求には影響しません。このチェックボックスを選択すると、実行時にこの統合フローによって処理されるメッセージに関する詳細なロギング情報が収集されます。これは問題のトラブルシューティングに役立ちます。ただし、詳細なトレースは、パフォーマンスに影響を与えることもあります。トレースを無効にするには、統合を非アクティブ化してから、「トレースの有効化」チェック・ボックスを選択せずに再アクティブ化する必要があります。ダッシュボード・ページでログをダウンロードできます。ペイロード・トレースを有効にして、入力および出力ペイロードをアクティビティ・ストリームに記録する場合は、「ペイロードを含める」チェック・ボックスを選択します。このチェック・ボックスを選択すると、ペイロードからの情報もログ・ファイルに書き込まれ、ダウンロードして表示できます。たとえば、統合フローの複数の場所でペイロード・アクティビティに関する詳細なロギング情報(データ・マッピング前のペイロードやデータ・マッピング後のペイロードなど)を参照できます。このアクションによって、セキュリティのリスクが生じる可能性があり、システムのパフォーマンスにも影響します。この設定は、本番環境ではお薦めしません。「アクティビティ・ストリーム・ログが削除されました」を参照してください。 .
&デプロイのアクティブ化	RESTアダプタ・トリガー・ベースの接続をOracle API Gatewayにデプロイする場合にクリックします。このオプションは、Oracle API Gatewayとの接続を構成した場合にのみ表示されます。「Oracle API Gatewayへの接続」を参照してください。

アクティブ化オプションを選択します。使用可能なオプションは、アクティブ化する統合のタイプによって異なります:
1. 「アクティブ化」をクリックします(スケジュールされていない統合を活動化する場合)。
2. 「アクティブ化とスケジュール設定」をクリックします(スケジュールされた統合を活動化する場合)。
  実行integration_nameページが表示されます。この統合を実行するスケジュールを作成し、「保存」をクリックします。「統合スケジュールの定義」を参照してください。
ステータス・メッセージは、ページ上部のバナーに表示されます。たとえば:

図integration_activation.pngの説明
統合のアクティブ化に失敗すると、バナーに「アクティブ化失敗」警告アイコンが表示されます。このアイコンをクリックすると、アクティベーション失敗事象の詳細をダウンロードするためのダイアログが表示されます。

「図integration_active_fail.pngの説明」
1. 完全に構成されていない機能が統合に含まれている場合は、バナーにエラー・メッセージが表示されます。統合を活動化する前に、この機能の構成を完了する必要があります。統合内をクリックし、次のエラー/警告を確認します:
  - 不完全な関数を使用する関数呼び出しアクションにエラー・アイコンが表示されます。統合キャンバスの右側にある「エラー」パネルには、不完全な関数の詳細が表示されます。
  - この機能の入力と出力を使用する警告アイコンがマッパー上に表示されます。関数の構成が完了したら、統合をアクティブにする前に入力と出力のマッピングを確認する必要があります。
アクティブ化に成功すると、統合のステータスが行のACTIVEに変わります。
アイコンをクリックすると、この統合のインスタンスの実行、テストおよび追跡方法の詳細が表示されます。
たとえば:
トレースを有効にすることを選択した場合は、クリックしたアイコンの下にTRACE ENABLEDという単語が表示され、統合をアクティブにします。「インスタンスのトラッキング」ページで統合インスタンスをクリックすると、メニューに、ペイロードの詳細を表示するための「アクティビティ・ストリームの表示」というオプションが表示されます。

詳細なトレース・ログ情報にアクセスするには:
1. 左側のナビゲーション・ペインで、「ホーム」>「モニタリング」>「統合」>「ダッシュボード」をクリックします。
2. Oracle Integrationログと診断ログをダウンロードするには、「診断ログをダウンロード」をクリックします。
統合名をクリックするか、メニューから「表示」を選択して、アクティブな統合を表示します。アクティブな統合が、上部のバナーに「表示のみ」というメッセージとともに表示されます。

読取り専用モードでは次の点に注意してください。

「保存」ボタンは表示されません。
「起動」、「アクション」または「エラー」のアイコンはありません。
統合の複数の部分をクリックすると、「トラッキング」リンクの下のビジネス識別子の表示、マッパーでのソースからターゲットおよびターゲットからソースへのマッピングの表示、接続ウィザードのページでの構成の表示などの構成の詳細を表示できますが、変更はできません。

接続更新後に統合を再アクティブ化

接続の更新後に同じアダプタ接続を使用するすべてのアクティブな統合を再アクティブ化できます。これにより、更新されたアダプタ接続を反映するために、各統合を手動で非アクティブにして再アクティブ化する必要がなくなります。この機能は、すべてのアダプタで動作します。

ノート:

接続の更新後、最大50の統合を再アクティブ化できます。

左側のナビゲーション・ペインで、「ホーム」>「統合」>「接続」をクリックします。
必要な接続を検索して更新します。この接続を使用する統合の数がバナーに表示されます。
「テスト」をクリックし、「保存」をクリックします。
更新された接続を使用するアクティブおよび非アクティブの統合のリストが右側に表示されます。
「保存&再アクティブ化」をクリックして、すべてのアクティブな統合に接続の変更を適用します。次の点に注意してください。
- 再アクティブ化する個々の統合を選択することはできません。すべてが再アクティブ化されます。
- 再アクティブ化すると、待機状態にあるスケジュールの次回実行を含め、既存のスケジュール済統合がすべて取り消されます。取り消された次回実行を再生成するには、非アクティブ化後にスケジュールを再起動する必要があります。それ以外の場合、次の実行はスキップされます。
- 現在非アクティブとしてリストされているこの接続を使用する統合は、その状態のままになります。
- 「保存」をクリックすると、接続の変更は保存されますが、統合は再アクティブ化されません。
- ビジネス・イベントにサブスクライブしている統合を非アクティブ化しても、ビジネス・イベントはサブスクライブ解除されません。
統合のアクティブ化進捗状況(再アクティブ化された統合の数、再アクティブ化される残りの統合の数など)を示すためにページがリフレッシュされます。
を定期的にクリックして、進行状況を表示します。
完了すると、再アクティブ化された統合の詳細が表示されます。
「取消」をクリックしてページを閉じます。
統合の再アクティブ化が失敗した場合、調査するには統合ページに移動します。

一般的な統合のアクティブ化情報も提供されます。「統合のアクティブ化」を参照してください。

統合の非アクティブ化

Oracle Integrationの統合を非アクティブ化して、新しいメッセージの処理を停止できます。アクティブな統合を変更したい場合には、まず統合を非アクティブ化する必要があります。統合にビジネス・イベント・サブスクリプションが含まれている場合は、イベント・サブスクリプションを削除するかどうかを確認するメッセージが表示されます。

非アクティブ化はプロジェクトのデプロイ解除と同じです。つまり既存の履歴データ、監視データおよび実行時データはすべて失われます。 Oracle Integrationはプロジェクトの開始と停止という概念をサポートしていません。非同期パターンでは、非アクティブ化されたプロジェクトのキューは削除され、このキューに関連付けられたすべてのメッセージも削除されます。したがって、処理されていない保留中のリクエストがあっても、非アクティブ化の後で失われます。前のバージョンが非アクティブ化されると、履歴データ、監視データおよび実行時データがすべて失われます。

左側のナビゲーション・ペインで、「ホーム」>「統合」>「統合」をクリックします。
非アクティブ化する統合の行に移動します。
アクティブな統合のみを表示するには、filter.で「アクティブ」を選択します。統合名または統合タイプ(事前作成、カスタマイズまたは開発)でフィルタして、リストを絞り込むこともできます。
アイコンをクリックして、統合を非アクティブ化します。
表示されるダイアログで「非アクティブ化」をクリックします。ダイアログの上部に非アクティブ化の進捗バーが表示されます。

ノート:
スケジュール済統合を非アクティブ化しようとすると、この統合のアクティブまたは一時停止中のスケジュールも非アクティブ化の一部として停止します。

統合の非アクティブ化は、リクエストの開始後に完了するまでに時間がかかる場合があります。この期間中、処理中またはキューに入っているリクエストがまだ存在する可能性があります。対応する統合アーティファクトおよびリソースが削除およびアンデプロイされると、これらの処理インスタンスは失敗します。

非アクティブ化中の実行ポイントに応じて、失敗したインスタンスの様々な処理エラーを監視できます。非アクティブ化リクエスト後に発生した失敗したインスタンスを監視することもできます。

ビジネス・イベントとの統合の非アクティブ化

非アクティブ化する統合にビジネス・イベント・サブスクリプションが含まれている場合は、イベント・サブスクリプションを削除するかどうかを確認するメッセージが表示されます。イベント・サブスクリプションの削除を選択すると、統合は再アクティブ化された後はイベントを受信しなくなります。

イベント・サブスクリプションを削除しない場合、統合が6時間以内にアクティブ化された場合は、この統合のイベントが再送信されます。

アクティブな統合に対するトレースの有効化または無効化

アクティブ化された統合を再アクティブ化せずにトレースを有効または無効にすることができます。これらのアクションは、個々の統合で実行することも、すべての統合でグローバルに実行することもできます。

注意:

統合レベルまたはグローバル・レベルでトレースを有効にすると、パフォーマンスに影響します。 Oracleでは、本番環境ではこのオプションを有効にしないことをお薦めします。トレースにペイロードを含めるとシステムのパフォーマンスに影響し、ペイロード・トレースに機密情報を格納することによって会社のデータ保持ルールに違反する可能性があります。

ナビゲーション・ペインで、「ホーム」>「設定」>「統合」>「トレース」をクリックします。

次のオプションを選択して、トレース・レベルを構成しますトレース・レベルは請求には影響しません。

要素説明

要素	説明
統合レベル	Integrationsページの個々の統合レベルでトレースを有効または無効にする場合に選択します。これにより、Integrationsページの個々の統合のメニューから「トレース」を選択し、トレースを無効にするか、トレースを有効にしてペイロードを統合に含めるかを選択できます。トレースを有効にすると、詳細がアクティビティ・ストリームに表示されます。
グローバル・トレース・オン	すべてのアクティブ化された統合のトレーシングをグローバルにオンにする場合に選択します。このオプションを選択して保存した後、Integrationsページの個々の統合レベルでトレースを有効または無効にすることはできません。 Integrationsページのすべての統合について、次のメッセージが表示されます。 `TRACE WITH PAYLOAD` トレースの詳細がアクティビティ・ストリームに表示されます。メニューから「トレース」を選択してIntegrationsページの個々の統合のトレースを無効にしようとすると、アクティブなすべての統合に対してグローバル・トレースが現在有効であることを示すダイアログが表示されます。まず、このページに戻って「統合レベル」を選択して、統合レベルでトレースを有効または無効にする必要があります。
グローバル・トレース・オフ	すべてのアクティブな統合のトレーシングをグローバルにオフにする場合に選択します。このオプションを選択して保存した後、Integrationsページの個々の統合レベルでトレースを有効または無効にすることはできません。メニューから「トレース」を選択して、Integrationsページで個々の統合のトレースを有効にしようとすると、アクティブなすべての統合でグローバル・トレースが現在無効であることを示すダイアログが表示されます。まず、このページに戻って「統合レベル」を選択して、統合レベルでトレースを有効または無効にする必要があります。

統合レベル

Integrationsページの個々の統合レベルでトレースを有効または無効にする場合に選択します。

これにより、Integrationsページの個々の統合のメニューから「トレース」を選択し、トレースを無効にするか、トレースを有効にしてペイロードを統合に含めるかを選択できます。トレースを有効にすると、詳細がアクティビティ・ストリームに表示されます。

グローバル・トレース・オン

すべてのアクティブ化された統合のトレーシングをグローバルにオンにする場合に選択します。このオプションを選択して保存した後、Integrationsページの個々の統合レベルでトレースを有効または無効にすることはできません。 Integrationsページのすべての統合について、次のメッセージが表示されます。

TRACE WITH PAYLOAD

トレースの詳細がアクティビティ・ストリームに表示されます。

メニューから「トレース」を選択してIntegrationsページの個々の統合のトレースを無効にしようとすると、アクティブなすべての統合に対してグローバル・トレースが現在有効であることを示すダイアログが表示されます。まず、このページに戻って「統合レベル」を選択して、統合レベルでトレースを有効または無効にする必要があります。

グローバル・トレース・オフ

すべてのアクティブな統合のトレーシングをグローバルにオフにする場合に選択します。このオプションを選択して保存した後、Integrationsページの個々の統合レベルでトレースを有効または無効にすることはできません。

メニューから「トレース」を選択して、Integrationsページで個々の統合のトレースを有効にしようとすると、アクティブなすべての統合でグローバル・トレースが現在無効であることを示すダイアログが表示されます。まず、このページに戻って「統合レベル」を選択して、統合レベルでトレースを有効または無効にする必要があります。

トレースは、アクティビティ・ストリーム・ログに影響する可能性があります。「アクティビティ・ストリーム・ログが削除されました」を参照してください。