Skip to content

Update X-Ray guide to better compare Datadog APM & AWS X-Ray #29549

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
wants to merge 14 commits into
base: master
Choose a base branch
from

Conversation

avedmala
Copy link
Contributor

@avedmala avedmala commented May 27, 2025

What does this PR do? What is the motivation?

As we shift our focus away from the X-Ray Converter and towards the Lambda Extension and L2T, we wanted a blog post or some type of doc comparing Datadog APM and AWS X-Ray

After all, the title to the guide from the other page says "Decide When to Use Datadog APM and AWS X-Ray"


We have another integration page for X-Ray that's better maintained with the same setup instructions so I'm opting to link to that instead of repeating.

This will remove the per-runtime x-ray client libraries instructions but those aren't very valuable anyway IMO. We're just repeating info from AWS for Node and Python. We simply link to aws docs for the other runtimes anyway

Questions for reviewer

I’m curious about the overall message we're conveying, should we should “less harsh” in the comparison to AWS X-Ray?

Merge instructions

Merge readiness:

  • Ready for merge

For Datadog employees:
Merge queue is enabled in this repo. Your branch name MUST follow the <name>/<description> convention and include the forward slash (/). Without this format, your pull request will not pass in CI, the GitLab pipeline will not run, and you won't get a branch preview. Getting a branch preview makes it easier for us to check any issues with your PR, such as broken links.

If your branch doesn't follow this format, rename it or create a new branch and PR.

To have your PR automatically merged after it receives the required reviews, add the following PR comment:

/merge

Additional notes

…d AWS X-Ray

Restructured the guide to help users decide when to use Datadog APM vs AWS X-Ray for serverless tracing. Added comprehensive comparison sections covering limitations, advantages, and use cases for both solutions. Moved technical setup instructions to the end while maintaining all existing functionality.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
@github-actions github-actions bot added the Guide Content impacting a guide label May 27, 2025
Copy link
Contributor

Preview links (active after the build_preview check completes)

Modified Files

@avedmala avedmala changed the title Update X-Ray guide to focus on decision-making between Datadog APM an… Update X-Ray guide to better compare Datadog APM & AWS X-Ray May 27, 2025
@avedmala avedmala marked this pull request as ready for review May 28, 2025 15:59
@avedmala avedmala requested a review from a team as a code owner May 28, 2025 15:59
@avedmala avedmala marked this pull request as draft May 28, 2025 16:41
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Guide Content impacting a guide
Projects
None yet
Development

Successfully merging this pull request may close these issues.

1 participant