Skip to content
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

Merged
merged 27 commits into from
Jun 14, 2024

Conversation

tiffany76
Copy link
Contributor

@tiffany76 tiffany76 commented May 23, 2024

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

@tiffany76
Copy link
Contributor Author

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.

@tiffany76 tiffany76 marked this pull request as ready for review May 30, 2024 01:41
@tiffany76 tiffany76 requested review from a team and TylerHelmuth and removed request for a team May 30, 2024 01:41
@tiffany76
Copy link
Contributor Author

Ready for review. I flagged one section that I'm having trouble with. Thanks!

Copy link
Member

@theletterf theletterf left a 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.

content/en/docs/collector/internal-telemetry.md Outdated Show resolved Hide resolved
content/en/docs/collector/internal-telemetry.md Outdated Show resolved Hide resolved
content/en/docs/collector/internal-telemetry.md Outdated Show resolved Hide resolved
@svrnm
Copy link
Member

svrnm commented Jun 3, 2024

@open-telemetry/collector-approvers PTAL

tiffany76 and others added 2 commits June 3, 2024 14:51
Co-authored-by: Fabrizio Ferri-Benedetti <fferribenedetti@splunk.com>
@tiffany76
Copy link
Contributor Author

/fix:format

@opentelemetrybot
Copy link
Collaborator

You triggered fix:format action run at https://github.com/open-telemetry/opentelemetry.io/actions/runs/9357775924

@svrnm svrnm added the sig-approval-missing Co-owning SIG didn't provide an approval label Jun 5, 2024
@tiffany76
Copy link
Contributor Author

@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!

Copy link
Member

@mx-psi mx-psi left a 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

content/en/docs/collector/troubleshooting.md Outdated Show resolved Hide resolved
@tiffany76 tiffany76 requested a review from mx-psi June 12, 2024 15:58
@tiffany76
Copy link
Contributor Author

Hi @mx-psi, @svrnm: I think this one is ready to go. Thanks!

@theletterf
Copy link
Member

🚀 You did it! Wohoo!

@theletterf theletterf merged commit 254337e into open-telemetry:main Jun 14, 2024
13 of 14 checks passed
@tiffany76 tiffany76 deleted the internal-obs-3 branch June 14, 2024 15:26
mx-psi pushed a commit to open-telemetry/opentelemetry-collector that referenced this pull request Jun 28, 2024
#### 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
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
sig:collector sig-approval-missing Co-owning SIG didn't provide an approval
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Migrate the Collector Troubleshooting docs to OpenTelemetry.io
5 participants