feat: added captureHTTPsRequest feature

[dreamorosi]

Description of your changes

This PR introduces a new feature for Tracer that allows to trace, by default, all outgoing HTTP(s) requests:

• Customers can opt-out from this feature by setting the POWERTOOLS_TRACER_CAPTURE_HTTPS_REQUESTS environment variable or captureHTTPsRequests constructor parameter to false when instantiating the Tracer
• The feature relies on aws-xray-sdk ability to instrument the standard library's http and https modules, as Tracer should be able to trace any 3rd party request client library that is built upon these two modules. Support to 3rd party HTTP clients is provided on a best effort basis (this disclaimer is specified in the documentation). axios has been tested during development and is included in integration tests.
• Documentation and JSDocs updated
• The feature is implemented without exposing any new API on Tracer and directly on the Tracer instance, as such no changes to decorator and middleware implementation has been made
• Unit tests implemented
• Integration tests implemented
• Minor housekeeping changes (mostly formatting)

How to verify this change

See checks passing on this PR, see integration test results (link)

Screenshots of the new section in the documentation:

Documentation changes also include the addition of the new config to the Utility Settings section:

Screenshots of traces & service map generated by running this build & using axios:

Related issues, RFCs

#675
#275

PR status

Is this ready for review?: YES
Is it a breaking change?: NO

Checklist

• My changes meet the tenets criteria
• I have performed a self-review of my own code
• I have commented my code where necessary, particularly in areas that should be flagged with a TODO, or hard-to-understand areas
• I have made corresponding changes to the documentation
• I have made corresponding changes to the examples
• My changes generate no new warnings
• The code coverage hasn't decreased
• I have added tests that prove my change is effective and works
• New and existing unit tests pass locally and in Github Actions
• Any dependent changes have been merged and published in downstream module
• The PR title follows the conventional commit semantics

Breaking change checklist

N/A

---

By submitting this pull request, I confirm that you can use, modify, copy, and redistribute this contribution, under the terms of your choice.

[flochaz]

last force push might have removed all your changes ... I can't see diff anymore

[dreamorosi]

last force push might have removed all your changes ... I can't see diff anymore

Thanks @flochaz, fixed it and included the changes from #676

[dreamorosi]

e2e tess are now passing: https://github.com/awslabs/aws-lambda-powertools-typescript/runs/5669680344?check_suite_focus=true

[dreamorosi]

Thanks a ton @ijemmy for the review, agree with all your comments and I will address them right away.

[dreamorosi]

Sorry, had to rebase due to merge conflicts :/ Need another round of reviews

[saragerion]

It looks good to me already, great job!