Document ability to set a static concurrency for `request.concurrency`

[jszwedko]

A note for the community

• Please vote on this issue by adding a 👍 reaction to the original issue to help the community and maintainers prioritize this request
• If you are interested in working on this issue or have submitted a pull request, please leave a comment

Problem

The documentation for request.concurrency doesn't indicate that you can set a static concurrency limit (a useful feature).

We should fix the docs to document how to set a static concurrency (like request.concurrency = 50).

Configuration

No response

Version

vector v0.32.1

Debug Output

No response

Example Data

No response

Additional Context

No response

References

• https://github.com/vectordotdev/vector/issues/18594
• https://github.com/vectordotdev/vector/issues/18593

[jszwedko]

I think this is still an issue as we the changes to document a static concurrency were backed out of https://github.com/vectordotdev/vector/pull/18651

[neuronull]

This seems to be related to how the docs are generated from the code, and the fact that the fixed concurrency isn't actually represented in the enum.

Perhaps a way forward is to add an example to showcase the static usage, which we don't have right now.

We can also see if the auto generation of docs could be improved to handle this use case.

https://github.com/vectordotdev/vector/blob/30a1e2613f63eaeed3e8768ee6423dba568fca4d/src/sinks/util/service/concurrency.rs#L24-L37