Converge on JAEGER_SAMPLING_ENDPOINT env variable for client's sampling

[yurishkuro]

Update 2020-02-07

per discussion #1971 (comment), we settled on the name JAEGER_SAMPLING_ENDPOINT. I'm adding the tracking:

• Go client Converge on JAEGER_SAMPLING_ENDPOINT env variable jaeger-client-go#511
• Java client
• Node client
• Python client
• C# client Replace JAEGER_SAMPLER_MANAGER_HOST_PORT with JAEGER_SAMPLING_ENDPOINT jaeger-client-csharp#165
• C++ client Fix loading of sampling endpoint address from JAEGER_SAMPLING_ENDPOINT environment variable jaeger-client-cpp#200
• Documentation matrix update

Original ticket

A bunch of tickets and PRs flying about, without a firm agreement on what we want to call this env variable.

Two candidates:

1. JAEGER_CONFIG_MANAGER_HOST_PORT https://github.com/jaegertracing/jaeger-client-java/pull/554/files#r221994309
2. JAEGER_CONFIG_ENDPOINT Rename JAEGER_SAMPLER_MANAGER_HOST_PORT to JAEGER_SAMPLING_ENDPOINT jaeger-client-go#282 (comment)

Drawbacks:

1. JAEGER_CONFIG_MANAGER_HOST_PORT: Does not allow http vs. https, which may be necessary/useful in some situations
2. JAEGER_CONFIG_ENDPOINT: Consistent with JAEGER_ENDPOINT for submitting spans, but misleading, because JAEGER_ENDPOINT is the actual URL like http://jaeger-collector:14268/api/traces, but for configuration it's a base url only, to be used with suffix endpoints like /sampling or /baggage

[yurishkuro]

cc @jpkrohling @pavolloffay

[jpkrohling]

I'm in favor of having a configuration option that accepts a URL, which contains all the components required to derive the actual endpoint value (protocol, host, port, base path).

The other obvious name for the property would be JAEGER_CONFIG_URL, but it has the same drawback as JAEGER_CONFIG_ENDPOINT, as it's not a complete URL (lacks the actual path). JAEGER_CONFIG_BASE_URL would be better in that sense, but I think it's unnecessarily verbose.

[pavolloffay]

JAEGER_CONFIG_ENDPOINT is fine. First I didn't consider http/https problem.

Do we expect people using different endpoints? If no we could require specifying just the root path and set the base in the implementation to make it easier for users.

[yurishkuro]

Conclusion: go with JAEGER_CONFIG_ENDPOINT, but make it explicit in the description that this is a "base URL".

Agreed?

[yurishkuro]

Update: per discussion #1971 (comment), we settled on the name JAEGER_SAMPLING_ENDPOINT

[Falco20019]

C# can be checked as done as it's merged and released as of 0.3.7.

[yurishkuro]

Per #3362, we're sunsetting Jaeger clients.