Skip to content

Conversation

@ivoanjo
Copy link
Member

@ivoanjo ivoanjo commented Mar 7, 2024

What does this PR do? What is the motivation?

This PR tweaks the Ruby profiler onboarding docs to mention that SSI on Kubernetes is supported, but on Linux host or VM and Docker, is not supported.

This is inspired, but not the same as the instructions for onboarding the .NET profiler (see
https://docs.datadoghq.com/profiler/enabling/dotnet/?tab=linuxwithsinglestepinstrumentation#enabling-the-profiler).

Merge instructions

  • Please merge after reviewing

I'm opening this PR first as a draft to discuss with the profiling team if this is how we want to document the current state with Ruby. I'll mark the PR ready for review once we decide we're happy with it.

Additional notes

N/A

**What does this PR do?**

This PR tweaks the Ruby profiler onboarding docs to mention that SSI
on Kubernetes is supported, but on Linux host or VM and Docker, is
not supported.

This is inspired, but not the same as the instructions for onboarding
the .NET profiler (see
<https://docs.datadoghq.com/profiler/enabling/dotnet/?tab=linuxwithsinglestepinstrumentation#enabling-the-profiler>).

**Motivation:**

Clearly document state of SSI for Ruby.
@ivoanjo ivoanjo changed the title [NO-TICKET± Clarify Ruby profiler SSI support [NO-TICKET] Clarify Ruby profiler SSI support Mar 7, 2024
@github-actions
Copy link
Contributor

github-actions bot commented Mar 7, 2024

Preview links (active after the build_preview check completes)

Modified Files


Continuous Profiler is not supported on serverless platforms, such as AWS Lambda.

[Single Step Instrumentation](https://docs.datadoghq.com/tracing/trace_collection/automatic_instrumentation/) for Kubernetes (using the Datadog Helm chart) is supported, but Single Step Instrumentation for Linux host or VM and Docker are not supported. You will still need to manually set the `DD_PROFILING_ENABLED=true` environment variable to enable profiling.
Copy link
Contributor

Choose a reason for hiding this comment

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

I'm not sure to understand: Linux host / VM+docker are not supported BUT it could work if DD_PROFILING_ENABLED=true?
Or these are definitively not supported BUT DD_PROFILING_ENABLED=true is needed for Kubernetes?

Copy link
Member Author

Choose a reason for hiding this comment

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

I'm not sure to understand: Linux host / VM+docker are not supported BUT it could work if DD_PROFILING_ENABLED=true?
Or these are definitively not supported BUT DD_PROFILING_ENABLED=true is needed for Kubernetes?

Linux host/VM + docker never work AND kubernetes works if you additionally set DD_PROFILING_ENABLED. But clearly my text was confusing, so I've given another pass at it, let me know if you think it's clear now, or if it's still confusing.

@ivoanjo ivoanjo marked this pull request as ready for review April 3, 2024 13:31
@ivoanjo ivoanjo requested a review from a team as a code owner April 3, 2024 13:31
@maycmlee
Copy link
Contributor

maycmlee commented Apr 3, 2024

Thanks @ivoanjo for opening up this PR! I'll put a work in progress label on it for now. Please remove it once this is ready for a docs review and we'll see it again in our PR list.

@maycmlee maycmlee added the WORK IN PROGRESS No review needed, it's a wip ;) label Apr 3, 2024
@ivoanjo
Copy link
Member Author

ivoanjo commented Apr 8, 2024

@maycmlee from the profiling team side we're happy with this, ready to move forward :)

@maycmlee maycmlee removed the WORK IN PROGRESS No review needed, it's a wip ;) label Apr 8, 2024
Copy link
Contributor

@buraizu buraizu left a comment

Choose a reason for hiding this comment

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

Thanks, just requesting some minor updates

Co-authored-by: Bryce Eadie <bryce.eadie@datadoghq.com>
@ivoanjo
Copy link
Member Author

ivoanjo commented Apr 9, 2024

Applied the suggestions, thanks for the review!

@buraizu
Copy link
Contributor

buraizu commented Apr 9, 2024

Thanks, let us know in the documentation channel when this is ready to merge!

@ivoanjo
Copy link
Member Author

ivoanjo commented Apr 10, 2024

This is ready to merge, please go ahead :D

@brett0000FF brett0000FF merged commit 466514b into master Apr 10, 2024
@brett0000FF brett0000FF deleted the ivoanjo/clarify-ssi-ruby-profiler-support branch April 10, 2024 15:33
@ivoanjo
Copy link
Member Author

ivoanjo commented Oct 22, 2025

This got removed in #26407, and I've opened #32316 to re-add it.

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.

7 participants