OCIインテグレーションのアンインストール

Oracle Resource Managerスタックを使用してインテグレーションをセットアップした場合、Terraformはすべてのリソースを作成し、スタックの状態で追跡します。スタックを破棄すると、正しい依存関係の順序ですべてが削除されます。

1. OCIコンソールで、Developer Services > Resource Manager > Stacksに移動します。
2. リージョンを選択し、New Relicメトリクススタックを開きます。
3. Destroyを選択し、ジョブがSucceededに達するまで待ちます。
4. Delete stackを選択します。
5. そのリージョンのロギングスタックについて、ステップ2～4を繰り返します。
6. インストゥルメントされたすべてのリージョンについて、ステップ1～5を繰り返します。
7. ホームリージョンに切り替えて、同じ方法でポリシースタックとWIFセットアップスタックを破棄します。

Resource Manager経由ではなく、ご自身でNew RelicのTerraform設定を適用した場合は、これを使用してください。

元の作業ディレクトリとそのステート — ローカルのterraform.tfstateファイル、または構成したリモートバックエンドへのアクセス — が必要です。Terraformは、ステートに記述されている内容のみを破棄できます。

1. 適用した設定に移動して初期化し、ワークスペースを使用した場合は選択します：

   bash

   コピー

   $
   cd <path-to-your-newrelic-oci-configuration>
   $
   terraform init
   $
   terraform workspace select <workspace>

2. ステートが引き続きリソースを記述していることを確認します：

   bash

   コピー

   $
   terraform state list

   何も返されない場合、または想定よりもリソースが極端に少ない場合、状態が失われているか、不完全です。代わりにOCIコンソールで手動で削除してください — 不完全な状態から破棄するとリソースが残り、引き続きコストが発生します。

3. 適用した際と同じ変数値を指定して、各設定を破棄します：

   bash

   コピー

   $
   terraform destroy -var-file=<your-vars-file>.tfvars

   確定する前にプランを確認してください。変数の値が異なると、実行時に誤ったリージョンが指定されたり、リソースの解決に失敗したりして、リソースが孤立する可能性があります。

4. 依存関係の逆順で作業を進めてください。インストゥルメントされた各リージョンについて、まずロギング設定を破棄し、次にメトリクスを破棄してください。すべてのリージョンがクリアされた後にのみ、ホーム・リージョンでポリシー設定を破棄し、次にワークロード・アイデンティティ・フェデレーション設定を破棄してください。

以下のいずれかに該当する場合は、次の手順を実行してください：

• Resource ManagerやTerraform経由ではなく、手動でインテグレーションを設定しました。
• Resource Managerのスタックレコードがすでに存在しないか、その破棄ジョブが失敗しました。
• Terraformのステートファイルが欠落しているか、不完全であるか、または実際にデプロイされているものから乖離しています。
• どちらのオプションから破棄を実行しても、リソースが残りました。

手順を順番に進めてください — 後続の手順は前の手順に依存します。

すべてのリソースはNew Relicコンパートメントに存在します。Resource ManagerまたはTerraformによって作成された場合はnewrelic_compartment_ORM_DO_NOT_REMOVE_<id>という名前になり、手動で作成した場合はnewrelic_compartment_DO_NOT_REMOVEという名前になります。完全な名前ではなくプレフィックスで照合してください — リソース名のリファレンスを参照してください。

ガイド付きセットアップウィザードとOCI Resource Managerスタックを使用してオンボーディングした場合：

1. OCIコンソールで、Developer Services > Resource Manager > Stacksに移動します。
2. ロギング・インテグレーション・スタックをデプロイしたコンパートメント（例：newrelic-compartment）を選択してください。コンパートメントを覚えていない場合は、使用されたコンパートメントが記録されている元のデプロイメント・ジョブのログ — Resource Manager > Jobs > (your deployment job) > Logs — を確認してください。
3. oci-log-integrationという名前のスタック（またはカスタムスタック名）を選択します。
4. Terraform Actionsを選択し、次にDestroyを選択します。
5. 破棄ジョブを確認してください。リソースマネージャーは、Service Connector Hubインスタンス（監査コネクタを含む）、OCIフォワーダー関数とそのアプリケーション、スタックが作成したロググループとObject Storageバケット、および関連するIAMポリシーと動的グループを自動的に削除します。
6. 破棄ジョブが正常に完了したら、Edit Stack、次にDelete Stackを選択して、スタック定義を削除してください。

Resource Manager経由ではなく、独自のTerraformまたはOpenTofuモジュールを使用してインテグレーションをデプロイした場合は、これを使用してください。

1. OCI Terraformワークスペースからプラン・チェックを実行し、削除される内容を確認します：

   bash

   コピー

   $
   terraform plan -destroy

2. このインテグレーションのTerraform設定が含まれるフォルダーに移動し、破棄してください：

   bash

   コピー

   $
   terraform destroy -auto-approve

3. OCIがプロビジョニングされたすべてのリソースを破棄したことを確認してください：oci_service_connector_hub、oci_functions_function、oci_identity_policy、およびoci_identity_dynamic_group。

4. アカウントをリンクするためにnewrelic Terraformプロバイダーを使用した場合は、設定からnewrelic_cloud_oci_integrationsリソースブロックを削除して再適用してください。それ以外の場合は、New Relicでのアカウントのリンク解除に従ってください。

ステップ・バイ・ステップのセットアップ・ガイドに従ってロギング・リソースを手動で作成した場合は、これらの手順を実行してください。依存関係のロックを回避するために、順番に進めてください。

1. サービスコネクタを削除します。インテグレーションを手動で作成したときに使用したコンパートメント（たとえば、newrelic-compartment）を選択し、Analytics & AI > Messaging > Service Connector Hubに移動して、New Relic関数にストリーミングするすべてのコネクタを削除します — たとえば、newrelic-logs-*やnewrelic-logs-*-auditなどです。
2. OCI関数とアプリケーションを削除します。同じコンパートメントを選択した状態で、Developer Services > Functionsに移動し、関数oci-log-forwarderを削除してから、その親関数アプリケーションを削除します。
3. シークレットを削除し、専用の場合はボールトも削除します。Identity & Security > Vaultに移動し、そこに保存されているNew Relic取り込みキーシークレットの削除をスケジュールします。このインテグレーション専用にボールトを作成した場合は、ボールトも削除します。既存のボールトを再利用した場合は、シークレットのみを削除します。
4. IAMポリシーと動的グループを削除します。Identity & Security > Identities > Policiesに移動して動的グループのアクセスを許可するインテグレーションポリシー（通常はルートコンパートメントの下に作成されます）を削除し、次にIdentity & Security > Dynamic Groupsに移動してフォワーダ動的グループを削除します。

スタックの破棄がHTTP 409 Conflict: Resource is being used by another processで失敗します。これは通常、アクティブなService Connector Hubバッチまたはファンクション実行が、基盤となるコンパートメントまたはサブネット・リソースのロックを保持していることを意味します。Analytics & AI > Messaging > Service Connector Hubでコネクタを選択してDeactivateを選択し、アクティブなファンクション呼出しがドレインされるまで2～3分待ってから、ORMのDestroyアクションを再実行します。

oci_identity_policyまたはoci_identity_dynamic_groupの削除時にスタックの破棄が失敗します。これは通常、破棄ジョブを実行しているユーザーまたはサービス・プリンシパルにテナンシ・レベルのポリシー管理権限がないことを意味します — たとえば、テナンシ・ルートにデプロイされたポリシーにはmanage policies in tenancyが必要です。ティアダウンを実行するユーザーがAdministratorsグループに属しているか、以下のテナンシ・ルート権限を直接持っていることを確認してください：

Allow group <Admin_Group> to manage policies in tenancy
Allow group <Admin_Group> to manage dynamic-groups in tenancy

それでも解決しない場合は、OCIコンソールのIdentity & Security > Identities > Policiesでポリシー・ステートメントを手動で削除し、破棄操作を再実行して状態をクリアしてください。

これは通常、セカンダリコネクタ — 監査コネクタ、またはORMスタックの外部で作成された手動ログコネクタ — がまだアクティブであることを意味します。アクティブなコネクタを検索するには、テナンシ全体でOCI Searchクエリを実行してください：

query serviceconnector resources

ターゲットがFunctionsで、oci-log-forwarderを指しているコネクタをすべて削除します。

これは想定されるOCIの動作であり、エラーではありません。誤ったキーの破棄を防ぐため、OCI Vaultシークレットは完全に削除される前に最低7日間の保持期間を必須としています — しかし、削除をスケジュールするとすぐにOCIは読み取り用のシークレットのペイロードを無効にするため、ログフォワーダーも保持期間中はそれを使用できません。