[REQUEST]: Troubleshooting guide for agentless agents

[jen-huang]

Description

Troubleshooting guide for agentless agents that can be linked from the status info work done in https://github.com/elastic/ingest-dev/issues/3933.

Resources

TBD

Collaboration

TBD. The docs and product team will work together to determine the best path forward.

Point of contact.

Main contact: TBD

Stakeholders: TBD

[jen-huang]

@smriti0321 I heard you are working with @benironside about overall product documentation for agentless. Should I move this issue elsewhere?

[benironside]

@jen-huang This is addressed in: elastic/security-docs#6184
So as far as I'm concerned this issue can be closed.

[jen-huang]

@benironside Thanks for letting me know about those docs! The work which needs to link to troubleshooting docs is generic for all agentless integrations, not just CSPM/security ones. For example it will be linked to from Elastic connector integrations too. IMO there should be a general place for docs for agentless integrations that links out to Solution-specific docs as needed.

@nimarezainia @kilfoyle Do we plan to add general agentless docs to existing Fleet and Integrations docs?

[kilfoyle]

@jen-huang I'm sadly not at all up to speed on the agentless work. I can add a page identical to the one Ben created here into the Fleet docs, if that makes sense. Would that suffice or do you think there's more required for the generic content?

[jen-huang]

@kilfoyle I think that would be a good start. I didn't diff the ESS vs Serverless docs so not sure if there is differing info that could be combined or split into multiple sections on the same page.

[nimarezainia]

@jen-huang I agree with the fact that we would need a generic troubleshooting guide to deal with agentless infrastructure issues. We don;t really have anything at the moment roadmap wise to deal with this.

I'll discuss with @kpollich and @cmacknz as to what this type of a guide needs to include. At the moment CSPM team owns and operates the agentless infra.