Utilize este guia quando desejar interromper o monitoramento do OCI com o New Relic. Ele orienta você na remoção dos recursos que a integração criou em sua tenancy do OCI e, em seguida, na desconexão da sua conta do New Relic.
Exclua seus recursos do OCI antes de desvincular a conta no New Relic. A desvinculação exclui o registro que armazena os OCIDs do seu compartimento e da sua stack, e você precisa deles para encontrar os recursos.
Siga as etapas em Desinstalar recursos de métrica e Desinstalar recursos de logs para os tipos de dados que você instrumentou. Em seguida, verifique se não restou nada, desvincule a conta no New Relic e use a referência de nome do recurso se precisar encontrar algo pelo nome.
Desinstalar recursos de métricas
A forma como você remove os recursos de métrica depende de como eles foram criados. Selecione a opção que corresponde à sua configuração:
Se você configurou a integração por meio da stack do Oracle Resource Manager, o Terraform criou todos os recursos e os rastreia no estado da stack. Destruir a stack remove tudo na ordem correta de dependência.
No console do OCI, acesse Developer Services > Resource Manager > Stacks.
Selecione a sua região e, em seguida, abra a stack de métricas do New Relic.
Selecione Destroy e aguarde o job atingir Succeeded.
Selecione Delete stack.
Repita as etapas 2–4 para a stack de logging nessa região.
Repita as etapas 1–5 para cada região instrumentada.
Mude para a sua região de origem e destrua a stack de políticas e a stack de configuração do WIF da mesma forma.
Dica
Se cada stack foi destruída com sucesso, você terminou — pule para Verificar se não restou nada. Use a exclusão manual apenas se uma stack estiver ausente, tiver sofrido desvio ou se o job de destruição tiver falhado.
Use isto se você aplicou a configuração do Terraform do New Relic por conta própria, em vez de por meio do Resource Manager.
Você precisa do diretório de trabalho original e do seu estado — o arquivo terraform.tfstate local, ou acesso ao backend remoto com o qual ele foi configurado. O Terraform só pode destruir aquilo que o seu estado descreve.
Mude para a configuração que você aplicou, inicialize-a e selecione o workspace, se tiver usado um:
bash
$
cd<path-to-your-newrelic-oci-configuration>
$
terraform init
$
terraform workspace select<workspace>
Confirme se o estado ainda descreve seus recursos:
bash
$
terraform state list
Se isso não retornar nada, ou muito menos recursos do que você espera, o estado está ausente ou incompleto. Em vez disso, exclua manualmente na console do OCI — destruir a partir de um estado parcial deixa recursos para trás e ainda custa dinheiro.
Destrua cada configuração, fornecendo os mesmos valores de variável aplicados com:
Revise o plano antes de confirmar. Valores de variáveis diferentes podem direcionar a execução para a região incorreta ou falhar ao resolver os recursos, deixando-os órfãos.
Trabalhe em ordem inversa de dependência. Para cada região que você instrumentou, destrua a configuração de logging primeiro e, depois, a métrica. Somente quando todas as regiões estiverem limpas, destrua a configuração de política e, em seguida, a configuração de federação de identidade de workload, ambas na sua região de origem.
Importante
Não use terraform destroy -target para remover recursos individuais. Ele ignora o gráfico de dependência e, nesta configuração, isso isola os gateways da VCN e os hubs de conectores — as duas coisas que continuam custando dinheiro a você.
Dica
Se todas as exclusões foram concluídas corretamente, pule para Verifique se não restou nada. Se alguma execução apresentar erro no meio do processo, execute-a novamente uma vez — a OCI ocasionalmente rejeita uma exclusão enquanto um recurso dependente ainda está sendo encerrado — e, em seguida, exclua o que restar manualmente no console da OCI.
Use estas etapas se qualquer um dos seguintes se aplicar:
Você configurou a integração manualmente, em vez de por meio do Resource Manager ou do Terraform.
O registro da stack do Resource Manager não existe mais, ou o seu trabalho de destruição falhou.
O seu arquivo de estado do Terraform está ausente, incompleto ou divergiu do que está realmente implantado.
Uma execução de destruição a partir de qualquer uma das opções deixou recursos para trás.
Execute as etapas em ordem — as etapas posteriores dependem das anteriores.
Todos os recursos residem no compartimento New Relic. Ele recebe o nome newrelic_compartment_ORM_DO_NOT_REMOVE_<id> quando o Resource Manager ou o Terraform o criou, e newrelic_compartment_DO_NOT_REMOVE se você o criou manualmente. Fazer a correspondência pelo prefixo em vez do nome completo — consultar a Referência de nome de recurso.
Excluir os Service Connector Hubs
Esta é a etapa que interrompe o fluxo de dados e o custo recorrente. Faça isso primeiro.
No console do OCI, acesse Analytics & AI > Messaging > Connectors.
Defina o compartimento como o compartimento do New Relic.
Exclua todos os conectores cujo destino seja uma função do New Relic — há um para métricas e, se você ativou os logs, um para logging.
Repita para cada região que você instrumentou.
Exclua as funções e os aplicativos de função
Vá para Developer Services > Functions > Applications.
Abra newrelic-<prefix>-<region>-metrics-function-app e exclua a função newrelic-<prefix>-<region>-metrics-function, em seguida, exclua o aplicativo.
Se você ativou os logs, exclua a função de logging e seu aplicativo da mesma forma.
Repita para cada região instrumentada.
Exclua o repositório do registro de contêiner
Exclua o repositório após a função, porque a função é executada a partir da imagem que ele contém.
Acesse Identity & Security > Policies e exclua estes três, se presentes:
newrelic_metrics_policy_ORM_DO_NOT_REMOVE_<id>
newrelic_logs_policy_ORM_DO_NOT_REMOVE_<id>
newrelic_common_policy_ORM_DO_NOT_REMOVE_<id>
Exclua os recursos de federação de identidade de workload
Você os criou quando configurou a autenticação. Excluí-los revoga permanentemente a capacidade da New Relic de se autenticar na sua locação.
Acesse Identity & Security > Domains e abra o domínio de identidades que você usou.
Em Integrated applications, desative e, em seguida, exclua:
newrelic-ida-app-orm
newrelic-token-exchange-app-orm
Em Users, exclua newrelic-wif-svc-user-orm.
Em Groups, exclua newrelic-svc-user-group-orm.
Em Settings > Identity propagation trust, exclua as configurações de confiança da New Relic.
Vá para Identity & Security > Policies e exclua newrelic-svc-user-policy-orm.
Exclua o compartimento do New Relic
Um compartimento deve estar vazio antes que você possa excluí-lo, portanto, faça isso por último.
Vá para Identity & Security > Compartments.
Abra o compartimento do New Relic e confirme que ele não contém recursos.
Selecione Delete.
Desinstalar recursos de logs
A forma como você remove os recursos de logs depende de como você os criou. Selecione a opção que corresponde à sua configuração:
Se você realizou a integração usando o assistente de configuração guiada e uma stack do OCI Resource Manager:
No console do OCI, acesse Developer Services > Resource Manager > Stacks.
Selecione o compartimento onde você implantou a stack de integração de logging (por exemplo, newrelic-compartment). Se você não se lembra do compartimento, verifique os logs do job de implantação original — Resource Manager > Jobs > (your deployment job) > Logs — que registram o compartimento usado.
Selecione a stack chamada oci-log-integration (ou o nome da sua stack personalizada).
Selecione Terraform Actions e depois selecione Destroy.
Confirme o job de destruição. O Resource Manager exclui automaticamente as instâncias do Service Connector Hub (incluindo conectores de auditoria), a função de encaminhador do OCI e seu aplicativo, os grupos de logs e os buckets do Object Storage que a stack criou e as políticas do IAM e grupos dinâmicos associados.
Assim que o job de destruição for concluído com êxito, selecione Edit Stack e, em seguida, Delete Stack, para remover a definição da stack.
Use isso se você implantou a integração com seus próprios módulos do Terraform ou OpenTofu em vez de usar o Resource Manager.
A partir do seu espaço de trabalho do OCI Terraform, execute uma verificação de plano para revisar o que será removido:
bash
$
terraform plan -destroy
Acesse a pasta que contém a configuração do Terraform para esta integração e, em seguida, destrua-a:
bash
$
terraform destroy -auto-approve
Confirme se a OCI destruiu todos os recursos provisionados: oci_service_connector_hub, oci_functions_function, oci_identity_policy e oci_identity_dynamic_group.
Se você usou o provedor Terraform newrelic para vincular a conta, remova o bloco de recursos newrelic_cloud_oci_integrations da sua configuração e aplique novamente — caso contrário, siga Desvincular a conta no New Relic.
Use estas etapas se você criou os recursos de logging manualmente, seguindo o guia de configuração passo a passo. Execute-os em ordem para evitar bloqueios de dependência.
Exclua os conectores de serviço. Selecione o compartimento que você usou quando criou manualmente a integração (por exemplo, newrelic-compartment), acesse Analytics & AI > Messaging > Service Connector Hub e exclua todos os conectores que transmitem para a função do New Relic — por exemplo, newrelic-logs-* e newrelic-logs-*-audit.
Exclua a função e o aplicativo do OCI. Com o mesmo compartimento selecionado, acesse Developer Services > Functions, exclua a função oci-log-forwarder e, em seguida, exclua seu aplicativo de função pai.
Exclua o segredo e o cofre, se ele for dedicado. Acesse Identity & Security > Vault e agende a exclusão do segredo da chave de ingestão do New Relic armazenado lá. Se você criou um cofre especificamente para esta integração, exclua o cofre também — se você reutilizou um cofre existente, exclua apenas o segredo.
Exclua as políticas do IAM e o grupo dinâmico. Acesse Identity & Security > Identities > Policies e exclua a política de integração que concede acesso ao grupo dinâmico (normalmente criada no compartimento raiz), depois acesse Identity & Security > Dynamic Groups e exclua o grupo dinâmico do encaminhador.
Os recursos criados pelo Resource Manager ou pelo Terraform possuem uma tag de formato livre. No console do OCI, acesse Governance & Administration > Search e execute cada uma destas consultas estruturadas:
query all resources where(freeformTags.key='newrelic-orm-terraform'&& freeformTags.value='true')
query all resources where(freeformTags.key='newrelic-terraform'&& freeformTags.value='true')
Duas chaves de tag diferentes estão em uso: a tag da stack de métricas e políticas newrelic-orm-terraform, e as tags da stack de logging newrelic-terraform. Execute ambos, em todas as regiões que você instrumentou.
Importante
Um resultado vazio não significa que a sua tenancy está limpa. Estas consultas não encontrarão:
Para confirmar uma desmontagem limpa, verifique ambas as plataformas:
Nenhum volume de log de entrada — no New Relic, abra Logs e consulte oracle.tenantid = '<YOUR_TENANCY_OCID>'. Confirme que nenhum novo evento de log chegue após o seu timestamp de desmontagem.
Zero invocações de função — no console do OCI, em Metrics, confirme se FunctionInvocationCount para a função do encaminhador de logs cai para 0.
Sem recursos órfãos do IAM — confirme que nenhum grupo dinâmico ou política que faça referência a newrelic permanece em Identity & Security.
Solucionar problemas de desprovisionamento
Se a desmontagem não for concluída corretamente, relacione o que você está observando a uma destas causas:
A destruição da stack falha com HTTP 409 Conflict: Resource is being used by another process. Isso geralmente significa que um lote ativo do Service Connector Hub ou a execução de uma função está mantendo um bloqueio nos recursos subjacentes de compartimento ou sub-rede. Em Analytics & AI > Messaging > Service Connector Hub, selecione o conector e selecione Deactivate, aguarde 2–3 minutos para que as invocações de função ativas sejam concluídas e, em seguida, execute novamente a ação Destroy do ORM.
A destruição da stack falha ao excluir oci_identity_policy ou oci_identity_dynamic_group. Isso geralmente significa que o usuário ou o principal de serviço que executa o job de destruição não possui direitos de gerenciamento de políticas no nível da tenancy — por exemplo, as políticas implantadas na raiz da tenancy exigem manage policies in tenancy. Confirme se o usuário que está executando a desmontagem pertence ao grupo Administrators ou se tem esses direitos de raiz da tenancy diretamente:
Allow group <Admin_Group> to manage policies in tenancy
Allow group <Admin_Group> to manage dynamic-groups in tenancy
Se isso não resolver o problema, exclua a instrução de política manualmente na console do OCI em Identity & Security > Identities > Policies e, em seguida, execute novamente a operação de destruição para limpar o estado.
Isso geralmente significa que um conector secundário — um conector de auditoria ou um conector de log manual criado fora da stack do ORM — ainda está ativo. Execute uma consulta do OCI Search em toda a tenancy para encontrar conectores ativos:
query serviceconnector resources
Exclua qualquer conector cujo destino seja Functions apontando para oci-log-forwarder.
Este é um comportamento esperado do OCI, não um erro. Os segredos do OCI Vault impõem um período de retenção mínimo obrigatório de 7 dias antes da exclusão definitiva, para evitar a destruição acidental da chave — mas o OCI desabilita a carga do segredo para leituras assim que você agenda a exclusão, de modo que o encaminhador de logs também não pode usá-la durante a janela de retenção.
Desvincular a conta no New Relic
Assim que seus recursos do OCI forem removidos:
Vá para one.newrelic.com > All capabilities > Infrastructure > Oracle Cloud Infrastructure.
Selecione sua conta vinculada.
Selecione Unlink this account e, em seguida, confirme.
Isso desativa todo o monitoramento da OCI para essa conta e afeta quaisquer dashboards, alertas e tags que dependiam disso. Não é possível desfazer isso.
Referência de nome de recurso
<id> é um sufixo aleatório curto gerado no momento de implantar, portanto, faça a correspondência pelo prefixo em vez do nome completo. O padrão de <prefix> é newrelic.
stack
Escopo
Chave da tag
Recursos
Política
Tenancy
newrelic-orm-terraform
Compartimento, cofre KMS, chave KMS, segredo de ingestão, segredo do usuário, grupo dinâmico e as políticas de métricas, logs e comuns — todos nomeados newrelic_*_ORM_DO_NOT_REMOVE_<id>
Métrica
Por região
newrelic-orm-terraform
Service Connector Hub, newrelic-<prefix>-<region>-metrics-function-app, newrelic-<prefix>-<region>-metrics-function, newrelic-<prefix>-<region>-metrics-vcn além de seu gateway NAT, gateway de serviço, NRMetricsInternetGateway e sub-rede privada
Registro
Por região
newrelic-terraform
Service Connector Hub, aplicativo de função de logging, função de logging, grupo de logs, log, VCN e gateways
Federação de identidades
Tenancy
nenhum
newrelic-ida-app-orm, newrelic-token-exchange-app-orm, newrelic-wif-svc-user-orm, newrelic-svc-user-group-orm, newrelic-svc-user-policy-orm e as configurações de confiança de propagação de identidade