Drop rules to Pipeline cloud rules #21857

tejaswaroop-nr · 2025-10-06T05:59:28Z

Migration docs for Pipeline cloud rules with Terraform

github-actions · 2025-10-06T05:59:36Z

Thanks for your pull request! Your PR is in a queue, and a writer will take a look soon. We generally publish small edits within one business day, and larger edits within three days.

Please ensure the propsed changes look good by building it first in your local environment. Refer to this contribution guide to get the site up and running in your local.

If you really require a preview url, reach out to one of the writers and they will generate one for you.

tejaswaroop-nr · 2025-10-09T17:33:59Z

Netlify build

github-actions · 2025-10-09T17:34:11Z

🚀 Netlify Preview Building!

If the build is successful, the preview for this pull request will be available at the following URL (usually takes 10-20 minutes):

https://pipeline-cloud-rules-migration--docs-website-netlify.netlify.app

tejaswaroop-nr · 2025-10-09T18:19:52Z

Netlify build

tejaswaroop-nr · 2025-10-10T03:33:28Z

Document preview link: https://68e7fcd52775b1000821255f--docs-website-netlify.netlify.app/docs/data-apis/manage-data/migrate-drop-rules-to-pipeline-cloud-rules/

tejaswaroop-nr · 2025-10-15T12:55:56Z

Netlify build

tejaswaroop-nr · 2025-10-15T13:31:48Z

Netlify build

tejaswaroop-nr · 2025-10-15T13:38:31Z

Updated document preview link: https://pipeline-cloud-rules-migration--docs-website-netlify.netlify.app/docs/data-apis/manage-data/migrate-drop-rules-to-pipeline-cloud-rules/

tejaswaroop-nr · 2025-10-28T05:39:21Z

Netlify build

src/content/docs/data-apis/manage-data/migrate-drop-rules-to-pipeline-cloud-rules.mdx

tejaswaroop-nr · 2025-11-04T20:01:18Z

Netlify build

src/content/docs/data-apis/manage-data/migrate-drop-rules-to-pipeline-cloud-rules.mdx

pranav-new-relic · 2025-11-05T11:46:44Z

src/content/docs/data-apis/manage-data/migrate-drop-rules-to-pipeline-cloud-rules.mdx

+{/* The following content will go into a troubleshooting guide
+
+## Troubleshooting [#troubleshooting]
+
+### Import fails with "resource not found"
+
+If imports fail during `terraform apply`:
+
+**Solution:** Run `terraform refresh` to ensure your state is synchronized with New Relic, then verify the `pipeline_cloud_rule_entity_id` values are correct in your state file (for local approach) or JSON file (for GitOps approach).
+
+### Plan shows unexpected changes after migration
+
+If `terraform plan` shows changes after successful migration:
+
+**Solution:** This usually indicates the generated `pcrs.tf` doesn't match the actual resource configuration. Review and adjust the generated configuration to match your New Relic settings exactly.
+
+### Old drop rules still showing in Terraform state
+
+If `terraform state list` still shows `newrelic_nrql_drop_rule` resources after migration:
+
+**Solution:** Use the `terraform state rm` command to manually remove them from state without deleting them from New Relic. For example:
+```bash
+terraform state rm newrelic_nrql_drop_rule.rule_name
+```
+Follow the recommendations provided in the CLI output from Phase 2 for the complete list of resources to remove. */}


@tejaswaroop-nr this sounds like a comment you've added, so this can be added to a different guide in future; I don't think we need to document this for inclusion somewhere else, as I would suggest adding a "References" section that would lead to

https://registry.terraform.io/providers/newrelic/newrelic/latest/docs/guides/drop_rules_eol_guide#nrql-drop-rules-eol-implications-and-actions-needed

https://registry.terraform.io/providers/newrelic/newrelic/latest/docs/resources/pipeline_cloud_rule

https://registry.terraform.io/providers/newrelic/newrelic/latest/docs/resources/nrql_drop_rule

https://github.com/newrelic/terraform-provider-newrelic/tree/main/examples/drop_rule_migration_ci#troubleshooting

https://github.com/newrelic/newrelic-cli/blob/main/internal/migrate/tf_importgen_ci_guide.md

https://github.com/newrelic/newrelic-cli/blob/main/internal/migrate/tf_importgen_guide.md

with each of these shown with relevant labels such as Troubleshooting for the CI workflow, Troubleshooting for the local workflow, etc - do you think this would make sense

src/content/docs/data-apis/manage-data/migrate-drop-rules-to-pipeline-cloud-rules.mdx

Co-authored-by: Pranav Nandula <[email protected]>

Create migrate-drop-rules-to-pipeline-cloud-rules.mdx

7baacf9

tejaswaroop-nr self-assigned this Oct 6, 2025

tejaswaroop-nr added content requests related to docs site content from_tw Identifies issues/PRs from Tech Docs writers labels Oct 6, 2025

github-actions bot requested a review from adutta-newrelic October 6, 2025 05:59

Update migrate-drop-rules-to-pipeline-cloud-rules.mdx

d47915f

Update telemetry-data-platform.yml

7cb17d9

Update migrate-drop-rules-to-pipeline-cloud-rules.mdx

2b42d5a

Minot changes

1a4949e

Update migrate-drop-rules-to-pipeline-cloud-rules.mdx

d5855f8

pranav-new-relic reviewed Oct 28, 2025

View reviewed changes