-
Notifications
You must be signed in to change notification settings - Fork 1.3k
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
Unify internal observability documentation - 3 of 3 #4529
Conversation
Still working on copy edits. I hope to move it out of draft mode tomorrow, but there's a good chance it won't happen until after the US holiday on Monday. |
Ready for review. I flagged one section that I'm having trouble with. Thanks! |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Thank you! Just some nits.
@open-telemetry/collector-approvers PTAL |
Co-authored-by: Fabrizio Ferri-Benedetti <[email protected]>
/fix:format |
You triggered fix:format action run at https://github.com/open-telemetry/opentelemetry.io/actions/runs/9357775924 |
@open-telemetry/collector-approvers, does anyone have time to give this PR a look? It's a pretty straightforward transfer and edit of the content from the Collector repo docs. And I've pointed out one section that might need some extra work. Thanks! |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Overall LGTM, there's one section we may want to remove for now, but otherwise makes sense
🚀 You did it! Wohoo! |
#### Description Now that [4246](open-telemetry/opentelemetry.io#4246), [4322](open-telemetry/opentelemetry.io#4322), and [4529](open-telemetry/opentelemetry.io#4529) have been merged, and the new [Internal telemetry](https://opentelemetry.io/docs/collector/internal-telemetry/) and [Troubleshooting](https://opentelemetry.io/docs/collector/troubleshooting/) pages are live, it's time to clean up the underlying Collector repo docs so that the website is the single source of truth. I've deleted any content that was moved to the website, and linked to the relevant sections where possible. I've consolidated what content remains in the observability.md file and left troubleshooting.md and monitoring.md as stubs that point to the website. I also searched the Collector repo for cross-references to these files and adjusted links where appropriate. ~~Note that this PR is blocked by [4731](open-telemetry/opentelemetry.io#4731 EDIT: #4731 is merged and no longer a blocker. <!-- Issue number if applicable --> #### Link to tracking issue Fixes #8886
This PR is the last of three. Together they will create a new internal observability document on opentelemetry.io, combining and migrating multiple markdown files from the Collector repo. This PR covers the section on monitoring the Collector with internal telemetry.
The Collector repo documents have some overlap between monitoring and troubleshooting, and this PR makes changes to both of those sections on the website.
Link to tracking issue: open-telemetry/opentelemetry-collector#8886. (Not triggering a closure on this until I can update/remove the Collector repo docs.)
Also fixes #3894.
Also relates to:
Previews:
Monitoring
Troubleshooting