[Docs] Kubernetes quickstart flow troubleshooting

[mykolaharmash]

We need a place in our docs to link users for troubleshooting issues with the kubectl kustomize command.

This could be a new section inside Scaling Elastic Agent on Kubernetes or a new dedicated page.

There is a Figma mockup with some potential troubleshooting steps that might be used as a starting point for the docs page.

[akhileshpok]

@bturquet, @gizas - Is there any existing doc for troubleshooting of the agent in K8s that we can refer to from within the new onboarding flow? Thanks

[gizas]

We dont have something specific!

For start, we can refer to below general ones:

• Troubleshooting Common Problems
• Frequently Asked Questions

We have this one as part of the current PR
https://github.com/elastic/elastic-agent/blob/d1a28379019332e27395259912e3675871720a0a/deploy/kubernetes/elastic-agent-kustomize/default/README.md

I would also suggest to include:

• Command to check the output of kustomize rendering:
  kubectl kustomize elastic-agent-kustomize/default/elastic-agent-standalone/ >> kustomize.yaml
• Command to get cluster status:
  kubectl get pods -n kube-system | grep elastic
• Command to describe agent:
  kubectl describe -n kube-system <name_of_elastic_agent_pod>
• Check logs of elastic-agent
  kubectl logs -n kube-system <name_of_elastic_agent_pod>
kubectl logs -n kube-system <name_of_elastic_agent_pod> | grep -i error

This could be a new section inside Scaling Elastic Agent on Kubernetes or a new dedicated page.

I would advise not to change the above page as it has specific goal.

My advise is to link the new page/ guide possibly to:

• https://www.elastic.co/getting-started/observability/monitor-kubernetes-clusters
• https://www.elastic.co/observability/kubernetes-monitoring
  (which are entry pages to our observability offering for k8s)

This is the repo where rest of elastic-agent pages for k8s leave

[akhileshpok]

Thanks @gizas. @mykolaharmash - Probably best to link the current 'Troubleshooting Common Problems' doc to the new onboarding flow. cc-@bmorelli25 - We should try to improve the current 'Troubleshooting Common Problems' doc based on the suggestions provided by @gizas.

[elasticmachine]

Pinging @elastic/obs-ux-infra_services-team (Team:obs-ux-infra_services)

[flash1293]

@mykolaharmash @akhileshpok can we close this?

[mykolaharmash]

@flash1293 probably not, we still don't have anything about kustomize flow troubleshooting in the docs (like commands that @gizas provided)