[main] Add B3 trace IDs to cf cli commands

[Samze]

Fixes #3309

Description of the Change

The CLI now sets the B3_TRACE headers as per https://docs.cloudfoundry.org/adminguide/distributed-tracing.html#unique-trace-id.

Notes:

• Automatically sets the same X-B3-Traceid header for all API requests initiated by that CF command. (e.g. use the same header for all api calls for the command cf apps).
• Automatically generates a new X-B3-Spanid per API request.
• Adds the new environment variable CF_B3_TRACE_ID that allows the X-B3-Traceid to be overridden.
• Sets this header for all clients used in the CLI (Cloud controller/Router/UAA).
• As per the go-router behaviour described in the linked article above , this will set the X-Vcap-Request-Id to the same header as the X-B3-Traceid (in uuid v4 format) and will work with W3C headers if `router.tracing.enable_w3c is set.
• Headers can be discovered via CF_TRACE or -v

Why Is This PR Valuable?

See #3309

Examples

With auto-generated headers:

 ./out/cf apps -v
Getting apps in org org-1 / space space-1 as admin...

REQUEST: [2025-01-21T14:04:19-07:00]
GET /v3/apps?order_by=name&per_page=5000&space_guids=e643fc8e-a90b-4a40-b51e-5bf1a143868e HTTP/1.1
Host: api.sys.tas.z00d47cae.shepherd.lease
Accept: application/json
Authorization: [PRIVATE DATA HIDDEN]
Content-Type: application/json
User-Agent: cf/9.0.0+b7e079787.2025-01-21 (go1.23.1; arm64 darwin)
X-B3-Spanid: 83c5b12313c7dd54
X-B3-Traceid: f6fc6d7e08c443fd81f34d643890d05d
[application/json Content Hidden]

RESPONSE: [2025-01-21T14:04:20-07:00]
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Date: Tue, 21 Jan 2025 21:04:20 GMT
Referrer-Policy: strict-origin-when-cross-origin
Vary: Accept
X-B3-Spanid: 83c5b12313c7dd54
X-B3-Traceid: f6fc6d7e08c443fd81f34d643890d05d
X-Content-Type-Options: nosniff
X-Download-Options: noopen
X-Frame-Options: SAMEORIGIN
X-Permitted-Cross-Domain-Policies: none
X-Runtime: 0.009293
X-Vcap-Request-Id: f6fc6d7e-08c4-43fd-81f3-4d643890d05d::ab389f8c-a57e-4a53-a82b-8395087b7cb0
X-Xss-Protection: 1; mode=block

With environment variable override:

CF_B3_TRACE_ID=e7edced4f7014a7080bb7bb5ce1e358d ./out/cf apps -v
Getting apps in org org-1 / space space-1 as admin...

REQUEST: [2025-01-21T14:04:49-07:00]
GET /v3/apps?order_by=name&per_page=5000&space_guids=e643fc8e-a90b-4a40-b51e-5bf1a143868e HTTP/1.1
Host: api.sys.tas.z00d47cae.shepherd.lease
Accept: application/json
Authorization: [PRIVATE DATA HIDDEN]
Content-Type: application/json
User-Agent: cf/9.0.0+b7e079787.2025-01-21 (go1.23.1; arm64 darwin)
X-B3-Spanid: e392eb41959dd48a
X-B3-Traceid: e7edced4f7014a7080bb7bb5ce1e358d
[application/json Content Hidden]

RESPONSE: [2025-01-21T14:04:50-07:00]
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Date: Tue, 21 Jan 2025 21:04:50 GMT
Referrer-Policy: strict-origin-when-cross-origin
Vary: Accept
X-B3-Spanid: e392eb41959dd48a
X-B3-Traceid: e7edced4f7014a7080bb7bb5ce1e358d
X-Content-Type-Options: nosniff
X-Download-Options: noopen
X-Frame-Options: SAMEORIGIN
X-Permitted-Cross-Domain-Policies: none
X-Runtime: 0.007993
X-Vcap-Request-Id: e7edced4-f701-4a70-80bb-7bb5ce1e358d::ae3e797f-104d-4fa7-a983-6ee2ed9f6e8a
X-Xss-Protection: 1; mode=block

[a-b]

LGTM

[joaopapereira]

@Samze any update on this PR?

[Samze]

@Samze any update on this PR?

This dropped off my radar over the holidays, hope to pick this back up and finish it off in the next week or two.

[gururajsh]

LGTM