Migre de regras de descarte para regras cloud Pipeline

Baixe e adicione o script de validação.

Baixe o arquivo outputs.tf do repositório GitHub do provedor Terraform do New Relic e adicione-o ao seu espaço de trabalho Terraform de CI/CD.

Este script fornece um sistema de validação e extração para recursos de regras de exclusão, gerando seus IDs em formato JSON para uso em procedimentos de migração.

Configure o script para seus tipos de regra de descarte.

O script suporta dois tipos de regras de exclusão:

• Regras de descarte independentes: newrelic_nrql_drop_rule recursos definidos diretamente em sua configuração (não encapsulados em um módulo)

• Regras de descarte modulares: newrelic_nrql_drop_rule recursos encapsulados em um módulo Terraform

  No arquivo outputs.tf que você acabou de adicionar, defina os sinalizadores apropriados no bloco locals para habilitar o processamento para seus tipos de regra de exclusão:

  locals {
    # Enable for standalone drop rules
    enable_standalone_drop_rules = true
  
    # Enable for modular drop rules
    enable_modular_drop_rules = false
  }

  Copiar

  Defina enable_standalone_drop_rules como true se você tiver regras de descarte independentes. Defina enable_modular_drop_rules para true se você tiver regras de descarte modulares. Você pode habilitar ambos se tiver os dois tipos.

Adicione suas regras de descarte independentes (se aplicável)

Se você tiver regras de descarte independentes e as tiver habilitado na etapa anterior, identifique todos os recursos independentes newrelic_nrql_drop_rule em sua configuração do Terraform.

Por exemplo, se a sua configuração do Terraform tiver estas regras de remoção independentes:

resource "newrelic_nrql_drop_rule" "drop_debug_logs" {
  account_id  = var.new_relic_account_id
  description = "Filters out debug level logs"
  action      = "drop_data"
  nrql        = "SELECT * FROM Log WHERE level = 'debug'"
}

resource "newrelic_nrql_drop_rule" "drop_health_checks" {
  account_id  = var.new_relic_account_id
  description = "Removes health check logs"
  action      = "drop_data"
  nrql        = "SELECT * FROM Log WHERE endpoint = '/health'"
}

resource "newrelic_nrql_drop_rule" "drop_pii_data" {
  account_id  = var.new_relic_account_id
  description = "Filters out PII data"
  action      = "drop_data"
  nrql        = "SELECT * FROM Log WHERE contains(message, 'SSN')"
}

Para cada recurso, você deve anotar o identificador do recurso e a referência completa do recurso. Por exemplo, no recurso newrelic_nrql_drop_rule.drop_debug_logs:

• O identificador do recurso é drop_debug_logs
• A referência completa do recurso é newrelic_nrql_drop_rule.drop_debug_logs

No arquivo outputs.tf, adicione esses recursos à lista standalone_rules na seção designada de regras de descarte independentes:

# Configure standalone drop rules here
standalone_rules = local.enable_standalone_drop_rules ? [
  {
    name     = "drop_debug_logs"
    resource = newrelic_nrql_drop_rule.drop_debug_logs
  },
  {
    name     = "drop_health_checks"
    resource = newrelic_nrql_drop_rule.drop_health_checks
  },
  {
    name     = "drop_pii_data"
    resource = newrelic_nrql_drop_rule.drop_pii_data
  }
] : []

$
terraform state list | \
>
  grep 'newrelic_nrql_drop_rule' | \
>
  grep -v '^module\.' | \
>
  sed -E \
>
    -e '/\.([^[]+)\["/ s/^.*\.([^[]+)\["([^"]+)"\].*$/  {\n    name     = "\1_\2"\n    resource = &\n  },/' \
>
    -e 't' \
>
    -e '/\.([^[]+)\[[0-9]/ s/^.*\.([^[]+)\[([0-9]+)\].*$/  {\n    name     = "\1_\2"\n    resource = &\n  },/' \
>
    -e 't' \
>
    -e 's/^.*\.([^ ]+)$/  {\n    name     = "\1"\n    resource = &\n  },/'

Adicione suas regras de descarte modular (se aplicável)

Se você tiver regras de arrastar e soltar modulares e as tiver ativado na etapa 2, você precisa garantir que seus módulos exportem um atributo all_rules antes de adicioná-los ao script.

Pré-requisito: Seus módulos devem exportar um atributo all_rules que contém referências a todos os newrelic_nrql_drop_rule recursos gerenciados pelo módulo.

Se você tiver as mesmas três regras de descarte discutidas na etapa anterior, adicione esta saída ao seu módulo:

output "all_rules" {
  description = "A map of all drop rule resource objects created by this module."
  value = {
    debug_logs    = newrelic_nrql_drop_rule.drop_debug_logs
    health_checks = newrelic_nrql_drop_rule.drop_health_checks
    pii_data      = newrelic_nrql_drop_rule.drop_pii_data
  }
}

Em seguida, no arquivo outputs.tf, adicione o módulo à lista _modular_rules_raw na seção designada de regras de remoção modular:

# Configure modular drop rules here
_modular_rules_raw = local.enable_modular_drop_rules ? [
  {
    name     = "production_drop_rules"
    resource = module.drop_rules["production_drop_rules"].all_rules
  }
] : []

$
terraform state list | \
>
  grep '^module\..*newrelic_nrql_drop_rule' | \
>
  sed -E 's/(\.newrelic_nrql_drop_rule.*)//' | \
>
  sort -u | \
>
  sed -E 's/^module\.([^[]+)\["([^"]+)"\]$/  {\n    name     = "\2"\n    resource = module.\1\["\2"].all_rules\n  },/'

Executar plano do Terraform

No seu ambiente de CI/CD, execute:

$
terraform plan

Se o plano for bem-sucedido, você deverá ver uma mensagem de sucesso na saída:

Changes to Outputs:
  + a_validation_success = "✅ All listed resources export pipeline_cloud_rule_entity_id"

Isso confirma que todos os recursos de regra de descarte estão configurados corretamente e exportam o atributo pipeline_cloud_rule_entity_id. Agora você pode prosseguir para executar terraform apply.

Se você vir erros de validação como este:

Changes to Outputs:
  + validation_errors = [
      + "❌ Drop rule 'drop_debug_logs' does not export `pipeline_cloud_rule_entity_id` or it is null",
      + "❌ Drop rule 'drop_health_checks' does not export `pipeline_cloud_rule_entity_id` or it is null",
      + "❌ Drop rule 'drop_pii_data' does not export `pipeline_cloud_rule_entity_id` or it is null",
    ]

Isso significa que você não está usando o provedor Terraform do New Relic na versão 3.73.0 ou superior. Atualize a versão do seu provedor na sua configuração do Terraform para v3.73.0 ou superior e execute terraform plan novamente.

Execute o comando `terraform apply`.

Após verificar se a saída do plano exibe a mensagem de sucesso, execute:

$
terraform apply

Após a aplicação ser concluída com sucesso, você verá uma saída semelhante a esta:

Apply complete! Resources: 0 added, 0 changed, 0 destroyed.

Outputs:

a_validation_success = "✅ All listed resources export pipeline_cloud_rule_entity_id"
experimental_drop_rule_resource_ids = "{\"drop_rule_resource_ids\":[{\"id\":\"3806526:106878882\",\"name\":\"drop_debug_logs\",\"pipeline_cloud_rule_entity_id\":\"MzgwNjUyNnxORVVMS...\"},{\"id\":\"3806526:106878883\",\"name\":\"drop_health_checks\",\"pipeline_cloud_rule_entity_id\":\"MzgwNjUyNnxORVVMS...\"},{\"id\":\"3806526:106878884\",\"name\":\"drop_pii_data\",\"pipeline_cloud_rule_entity_id\":\"MzgwNjUyNnxORVVMS...\"}]}"
experimental_drop_rule_resource_ids_formatted = <<EOT
{
  "drop_rule_resource_ids": [
    {
      "name": "drop_debug_logs",
      "id": "3806526:106878882",
      "pipeline_cloud_rule_entity_id": "MzgwNjUyNnxORVVMS..."
    },
    {
      "name": "drop_health_checks",
      "id": "3806526:106878883",
      "pipeline_cloud_rule_entity_id": "MzgwNjUyNnxORVVMS..."
    },
    {
      "name": "drop_pii_data",
      "id": "3806526:106878884",
      "pipeline_cloud_rule_entity_id": "MzgwNjUyNnxORVVMS..."
    }
  ]
}
EOT

Copie a saída JSON.

Copie toda a string JSON da saída experimental_drop_rule_resource_ids_formatted. Você precisará disso para a Fase 2.

Defina as variáveis de ambiente necessárias.

Antes de executar o comando da CLI, certifique-se de que as variáveis de ambiente necessárias estejam definidas:

$
export NEW_RELIC_API_KEY="your-api-key"
$
export NEW_RELIC_ACCOUNT_ID="your-account-id"
$
export NEW_RELIC_REGION="US"  # Optional, defaults to 'US'

Salve o resultado JSON em um arquivo.

Crie um arquivo JSON (por exemplo, drop_rules.json) no diretório do seu espaço de trabalho do Terraform e cole a saída JSON da Fase 1.

{
  "drop_rule_resource_ids": [
    {
      "name": "drop_debug_logs",
      "id": "3806526:106878882",
      "pipeline_cloud_rule_entity_id": "MzgwNjUyNnxORVVMS..."
    },
    {
      "name": "drop_health_checks",
      "id": "3806526:106878883",
      "pipeline_cloud_rule_entity_id": "MzgwNjUyNnxORVVMS..."
    },
    {
      "name": "drop_pii_data",
      "id": "3806526:106878884",
      "pipeline_cloud_rule_entity_id": "MzgwNjUyNnxORVVMS..."
    }
  ]
}

Execute o comando de migração da CLI do New Relic

Navegue até o diretório do seu espaço de trabalho do Terraform e execute:

$
newrelic migrate nrqldroprules tf-importgen-ci --file drop_rules.json

Parâmetro de comando:

Exemplo usando o parâmetro --json :

Se preferir não criar um arquivo, você pode passar a string JSON diretamente:

$
newrelic migrate nrqldroprules tf-importgen-ci \
>
  --json '{"drop_rule_resource_ids":[{"name":"drop_debug_logs","id":"3806526:106878882","pipeline_cloud_rule_entity_id":"MzgwNjUyNnxORVVMS..."}]}'

Analise os arquivos gerados.

O comando da CLI gera três arquivos de configuração do Terraform em seu espaço de trabalho:

• provider.tf: Configuração do provedor Terraform e New Relic com restrições de versão.

• imports.tf: Importar blocos que vinculam novos recursos a regras cloud Pipeline existentes no New Relic.

• pcrs.tf: Definições de recursos de regras cloud Pipeline (geradas automaticamente durante a execução do comando).

  O comando também exibe recomendações para remover regras antigas de exclusão do estado do Terraform, que você usará na Fase 3.

Confirme e envie a configuração gerada.

Adicione os arquivos Terraform gerados ao seu repositório git:

$
git add .
$
git commit -m "Add Pipeline cloud rule migration configuration"
$
git push origin your-branch-name

Isso fará com que seu pipeline de CI/CD processe as alterações na Fase 3.

Analise o plano Terraform

Após enviar suas alterações, seu pipeline de CI/CD será acionado automaticamente e publicará um comentário de plano em sua solicitação de pull request. O resultado do plano mostrará:

• Recursos sendo importados: Três recursos newrelic_pipeline_cloud_rule

• Resumo do plano: Plan: 3 to import, 0 to add, 0 to change, 0 to destroy

  / Exemplo de saída do plano Terraform: diff O Terraform executará as seguintes ações: # newrelic_pipeline_cloud_rule.drop_debug_logs será importado recurso "newrelic_pipeline_cloud_rule" "drop_debug_logs" { account_id = 3806526 description = "Filtra logs de nível de depuração do ambiente de produção para reduzir o volume de dados" id = "MzgwNjUyNnxOR0VQfFBJUEVMSU5FX0NMT1VEX1JVTEV8MDE5OTRjZjgtYmFmNy03MjU3LWE3M2MtZWY5OTkxYTQxMjgy" name = " Regra de descarte NRQL ID: 106878882 criada pelo usuário ID: 1004672904 criada em: 2025-09-15T10:43:13.122888Z" NRQL = "DELETE FROM `Log` WHERE ((`level` = 'debug') AND (`environment` = 'production'))" } # newrelic_pipeline_cloud_rule.drop_health_checks será um recurso importado "newrelic_pipeline_cloud_rule" "drop_health_checks" { account_id = 3806526 description = "Remove os atributos userEmail e userName dos dados MyCustomEvent" id = "MzgwNjUyNnxOR0VQfFBJUEVMSU5FX0NMT1VEX1JVTEV8MDE5OTRjZmItMTQ0Yy03NDM5LWJhNDYtZjI4MTg0ODc5YmE2" name = " ID da regra de exclusão NRQL : 106878884 criado pelo usuário ID: 1004672904 criado em: 2025-09-15T10:45:47.049993Z" NRQL = "DELETE `userEmail`, `userName` FROM `MyCustomEvent`" } # newrelic_pipeline_cloud_rule.drop_pii_data será o recurso importado "newrelic_pipeline_cloud_rule" "drop_pii_data" { account_id = 3806526 description = "Exclui o atributo containerId dos agregados métricos" id = "MzgwNjUyNnxOR0VQfFBJUEVMSU5FX0NMT1VEX1JVTEV8MDE5OTRjZmItMTQ4Ni03MDI4LWJlMDktZmYzOTM2NWQ4ODUw" name = "NRQL ID da regra de exclusão: 106878885 criada pelo usuário ID: 1004672904 criada em: 2025-09-15T10:45:47.060296Z" NRQL = "DELETE `containerId` FROM `MetricAggregate`" } Plano: 3 para importar, 0 para adicionar, 0 para alterar, 0 para destruir. /

Aplique as alterações.

Depois de revisar o plano e confirmar que ele parece correto, comente na sua solicitação de pull request:

$
terraform apply

Seu pipeline de CI/CD executará o comando `terraform apply`, que importará as regras cloud Pipeline para o estado do Terraform.

Exemplo de saída do aplicativo:

newrelic_pipeline_cloud_rule.drop_health_checks: Importing...
newrelic_pipeline_cloud_rule.drop_health_checks: Import complete
newrelic_pipeline_cloud_rule.drop_debug_logs: Importing...
newrelic_pipeline_cloud_rule.drop_debug_logs: Import complete
newrelic_pipeline_cloud_rule.drop_pii_data: Importing...
newrelic_pipeline_cloud_rule.drop_pii_data: Import complete

Apply complete! Resources: 3 imported, 0 added, 0 changed, 0 destroyed.

Limpar as antigas regras de descarte do estado

Após a importação ser concluída com sucesso, você precisa remover os recursos antigos newrelic_nrql_drop_rule do seu estado do Terraform. Utilize as recomendações fornecidas na saída da CLI da Fase 2.

No seu ambiente CI/CD ou localmente, execute os comandos terraform state rm para cada regra de exclusão antiga:

$
terraform state rm newrelic_nrql_drop_rule.drop_debug_logs
$
terraform state rm newrelic_nrql_drop_rule.drop_health_checks
$
terraform state rm newrelic_nrql_drop_rule.drop_pii_data

Verifique a migração

Após a limpeza do estado:

• Verifique a saída para confirmar se todas as importações foram concluídas com sucesso.
• Verifique na interface do New Relic se as suas regras Pipeline cloud ainda estão ativas e funcionando.
• Execute terraform plan para confirmar que não há alterações pendentes (a saída deve mostrar "Nenhuma alteração").
• Confirme que as regras antigas de descarte não aparecem mais em terraform state list.

Mescle sua solicitação de pull request

Após a verificação ser concluída, mescle sua solicitação de pull request para finalizar a migração. Sua configuração do Terraform agora gerencia regras cloud Pipeline em vez de regras de descarte NRQL.

Navegue até seu espaço de trabalho do Terraform.

Abra seu terminal e navegue até o diretório que contém seus arquivos de configuração do Terraform com recursos newrelic_nrql_drop_rule.

$
cd /path/to/your/terraform/workspace

Execute o comando de atualização da CLI do New Relic

Execute o seguinte comando para atualizar o estado do Terraform:

$
newrelic migrate nrqldroprules tf-update

Este comando automaticamente:

• Analisa seu espaço de trabalho do Terraform para identificar todos os recursos newrelic_nrql_drop_rule.
• Executa operações terraform plan e terraform apply nesses recursos.
• Atualiza seu arquivo de estado do Terraform com o atributo pipeline_cloud_rule_entity_id para cada regra de drop.

Verifique a atualização do estado

Após a conclusão do comando, seu arquivo de estado do Terraform agora contém o mapeamento entre as regras de drop e as regras Pipeline cloud. Você pode verificar isso consultando seu estado:

$
terraform show -json | grep pipeline_cloud_rule_entity_id

Você deverá ver os valores pipeline_cloud_rule_entity_id para cada regra de descarte na saída. Isso confirma que seu cadastro estadual foi atualizado com sucesso. A CLI lerá esses valores automaticamente na próxima etapa.

Execute o comando de geração de importação da CLI do New Relic.

No diretório do seu espaço de trabalho do Terraform, execute:

$
newrelic migrate nrqldroprules tf-importgen

Este comando automaticamente:

• Valida se os recursos da regra de exclusão contêm valores pipeline_cloud_rule_entity_id.
• Gera blocos de importação para cada regra Pipeline cloud.
• Executa terraform plan -generate-config-out=generated_pipeline_rules.tf para criar a configuração de regras cloud Pipeline.
• Executa terraform apply para importar as regras cloud Pipeline para o estado do Terraform.

Analise os resultados da importação

Após a conclusão bem-sucedida do comando, as regras cloud Pipeline são importadas para o seu estado do Terraform. O comando gera o arquivo generated_pipeline_rules.tf contendo as definições de recursos de regra cloud Pipeline criadas por terraform plan -generate-config-out.

Execute o comando de exclusão da CLI do New Relic

No diretório do seu espaço de trabalho do Terraform, execute:

$
newrelic migrate nrqldroprules tf-delist

Este comando:

• Exibe avisos de segurança confirmando que os recursos só serão removidos do estado.
• Remove todos os recursos newrelic_nrql_drop_rule do estado do Terraform.
• Fornece instruções para limpar seus arquivos de configuração do Terraform.

Limpe sua configuração do Terraform.

Após a conclusão do comando delist, você deve comentar ou remover todos os blocos de recursos newrelic_nrql_drop_rule de seus arquivos de configuração do Terraform para evitar que sejam recriados.

Verifique a migração

Após limpar seus arquivos de configuração, verifique a migração:

$
# Confirm Pipeline cloud rules are in state
$
terraform state list | grep pipeline_cloud_rule
$

$
# Confirm old drop rules are removed from state
$
terraform state list | grep nrql_drop_rule
$

$
# Verify no pending changes
$
terraform plan

Se bem-sucedido, terraform plan deverá mostrar "Nenhuma alteração".