[documentation]: improve details on kubernetes input configuration about telegraf HOT 3 CLOSED

Hi,

There is a fine line between the Telegraf docs being how-to guides for each of the items and docs on using it with Telegraf. I would expect a user who is setting up and running K8s to know what their API URL is in their deployment. The Telegraf docs should not be used to explain how to set up or use a cloud provided K8s instance versus using something local like kind or k3s and then access these the deployment.

For the token, while it may not be as obvious, using a quick search on whatever distributions you are to create programmatic access or a bearer token should be fairly simple (e.g. K8s access cluster API docs

That said, can you help me understand what might help aid here?

from telegraf.

There is a fine line between the Telegraf docs being how-to guides for each of the items and docs on using it with Telegraf.

Certainly. But it would be nice to provide links and remove ambiguities.

I would expect a user who is setting up and running K8s to know what their API URL is in their deployment.

For K3s I would assume the "API URL" refers to the Kubernetes server running on port 6443.
But normal authentication is done via client cert and not via token.

For the token, while it may not be as obvious, using a quick search on whatever distributions you are to create programmatic access or a bearer token should be fairly simple (e.g. K8s access cluster API docs

K3s seems to refer to tokens to "bearer token used to authenticate the joining node to the cluster".

So the K3s docs seems to be a bit of a let down here. But the link to the K8s documentation would be a great add to the README.

It does explain how to obtain a service-account-token.
If that's the bearer token needed for Telegraf - that would be good to mention.

That said, can you help me understand what might help aid here?

Did this help from my end?

from telegraf.

Did this help from my end?

Very much, thank you! Can you please give #15335 a look and let me know if it clears things up?

Thanks

from telegraf.