Skip to content

[CHORE] Update MIGRATION.md to include changes to firstPartyHosts configuration#1217

Merged
cdn34dd merged 1 commit intodevelopfrom
carlosnogueira/issue-1207/add-first-party-hosts-migration-guide
Mar 20, 2026
Merged

[CHORE] Update MIGRATION.md to include changes to firstPartyHosts configuration#1217
cdn34dd merged 1 commit intodevelopfrom
carlosnogueira/issue-1207/add-first-party-hosts-migration-guide

Conversation

@cdn34dd
Copy link
Contributor

@cdn34dd cdn34dd commented Mar 19, 2026

What does this PR do?

Add migration section for firstPartyHosts configuration property.

Motivation

Issue:1207

Additional Notes

Anything else we should know when reviewing?

Review checklist (to be filled by reviewers)

  • Feature or bugfix MUST have appropriate tests
  • Make sure you discussed the feature or bugfix with the maintaining team in an Issue
  • Make sure each commit and the PR mention the Issue number (cf the CONTRIBUTING doc)
  • If this PR is auto-generated, please make sure also to manually update the code related to the change

@cdn34dd cdn34dd requested a review from a team as a code owner March 19, 2026 18:31
Copilot AI review requested due to automatic review settings March 19, 2026 18:31
Copy link

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Updates the v2 → v3 migration guide to document the firstPartyHosts configuration format change, helping users migrate distributed tracing host configuration correctly.

Changes:

  • Expands the firstPartyHosts entry in the “Property renames and relocations” table to mention a format change.
  • Adds a dedicated “firstPartyHosts format change” section with v2 vs v3 TypeScript examples.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@cdn34dd cdn34dd force-pushed the carlosnogueira/issue-1207/add-first-party-hosts-migration-guide branch from ec674b2 to 07e4226 Compare March 20, 2026 09:58
Copilot AI review requested due to automatic review settings March 20, 2026 10:32
@cdn34dd cdn34dd force-pushed the carlosnogueira/issue-1207/add-first-party-hosts-migration-guide branch from 07e4226 to 69b8444 Compare March 20, 2026 10:32
@cdn34dd cdn34dd merged commit 3433cc8 into develop Mar 20, 2026
5 of 12 checks passed
@cdn34dd cdn34dd deleted the carlosnogueira/issue-1207/add-first-party-hosts-migration-guide branch March 20, 2026 10:33
Copy link

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Updates the migration guide to document the breaking change to firstPartyHosts when moving from SDK v2 to v3, helping users correctly configure distributed tracing propagation for first-party resources.

Changes:

  • Expanded the firstPartyHosts row in the “Property renames and relocations” table to mention the format change.
  • Added a dedicated “firstPartyHosts format change” migration section with v2 vs v3 configuration examples.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

| `nativeViewTracking` | `RumConfiguration` | Moved. |
| `nativeInteractionTracking` | `RumConfiguration` | Moved. |
| `firstPartyHosts` | `RumConfiguration` | Moved. |
| `firstPartyHosts` | `RumConfiguration` | Moved. Format changed from `(string \| FirstPartyHost)[]` to `FirstPartyHost[]`. |
Copy link

Copilot AI Mar 20, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The type change in this table row looks inaccurate for v3: the public RumConfigurationOptions.firstPartyHosts is FirstPartyHost[] (no string/union support). To avoid confusion, consider describing the change as string[] (v2) -> FirstPartyHost[] (v3), or otherwise clarify where (string | FirstPartyHost)[] is valid.

Suggested change
| `firstPartyHosts` | `RumConfiguration` | Moved. Format changed from `(string \| FirstPartyHost)[]` to `FirstPartyHost[]`. |
| `firstPartyHosts` | `RumConfiguration` | Moved. Format changed from `string[]` (v2) to `FirstPartyHost[]` (v3). |

Copilot uses AI. Check for mistakes.
Comment on lines +140 to +145
import { PropagatorType } from '@datadog/mobile-react-native';

const config = new CoreConfiguration(
CLIENT_TOKEN,
ENVIRONMENT,
TrackingConsent.GRANTED,
Copy link

Copilot AI Mar 20, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This snippet includes an import { PropagatorType } ... line but omits other required imports (CoreConfiguration, TrackingConsent, etc.), which makes it hard to copy/paste as-is. Either include the missing imports, or remove the import line and keep the snippet as pseudocode for consistency with the other examples in this guide.

Copilot uses AI. Check for mistakes.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants