Add TA troubleshooting page

[avillela]

Adding page to the docs with tips for troubleshooting the OTel Operator's Target Allocator.

This was originally going to be a blog post; however, per suggestion from @svrnm, this is a much better fit.

Reference issue: #4707

[avillela]

Question for @open-telemetry/operator-approvers - I have a working example repo that I'd like to reference on this page, but I think that it's probably best to move this code to an examples folder the OTel Operator repo before doing this. Thoughts?

[svrnm]

Thanks, this is a really good addition to docs! A few comments and suggestions. Note that the section titles are really long which might look strange in the outline navigation, maybe we can review and shorten them

[avillela]

Thanks, this is a really good addition to docs! A few comments and suggestions. Note that the section titles are really long which might look strange in the outline navigation, maybe we can review and shorten them

Yeah, they do look a bit long. I think that when we had the step numbers, it was a bit easier to distinguish one from the other. Is there a reson why you prefer to leave those out, @svrnm?

[theletterf]

Good stuff! Added some comments.

[avillela]

FYI @svrnm @swiatekm-sumo @theletterf - I had some previous content for troubleshooting auto-instrumentation, so I created a page for that too.

[svrnm]

FYI @svrnm @swiatekm-sumo @theletterf - I had some previous content for troubleshooting auto-instrumentation, so I creaded a page for that too.

Can you fork that out in a dedicated PR or is this closely related?

[avillela]

FYI @svrnm @swiatekm-sumo @theletterf - I had some previous content for troubleshooting auto-instrumentation, so I creaded a page for that too.

Can you fork that out in a dedicated PR or is this closely related?

It's not closely related, so I can definitely create a separate PR.

[avillela]

Removed auto-instrumentation troubleshooting page. I have created a separate PR for this (#4724).

done

[svrnm]

@open-telemetry/operator-approvers PTAL!

[avillela]

Applying my own updates per feedback below

[avillela]

@swiatekm-sumo thanks for keeping me honest! I've incorporated your suggestions and did another read through. Hopefully I didn't miss any spots where I mis-explained the TA functionality.

[jaronoff97]

A few minor comments, but overall this is fantastic and will be massively helpful!

[jaronoff97]

would be good to note here that the query parameter collector_id is saying that these are the targets for otelcol-collector-0

[avillela]

Noted!

[jaronoff97]

THANK YOU @avillela fantastic work here :D :D :D

[swiatekm]

Nice 💪