feat: adding jaeger tracing schema, updating documentation

[tobbbles]

This PR updates the configuration schema to document the tracing block, currently with only support for Jaeger as per #376.

This PR addresses two pieces:

1. It documents the Jaeger tracing functionality :D
2. It enables the use of tracing in the configuration file. Although feat: Enable tracing #376 added this functionality, it was only possible to configure via environment variables and not a configuration file, due to being missing in the schema.

Related issue(s)

N/A

Checklist

• I have read the contributing guidelines.
• I am following the
  contributing code guidelines.
• I have read the security policy.
• I confirm that this pull request does not address a security
  vulnerability. If this pull request addresses a security. vulnerability, I
  confirm that I got green light (please contact
  [email protected]) from the maintainers to push
  the changes.
• I have added tests that prove my fix is effective or that my feature
  works.
• I have added or changed the documentation.

Further Comments

This enables users to configure Jaeger tracing via their YAML config. However in future Oathkeeper should also support other kinda of tracing providers from github.com/ory/x/tracing for more completeness across all projects.

Note:
The tracing schema used does not reference github.com/ory/x/tracing/config.schema.json as Oathkeeper does not implement the full functionality. It is however copy and pasted from there with all non-Jaeger implementations removed.

[tobbbles]

Looks like this was removed from running npm run gen:config

[zepatrik]

Possible, we probably did not run it yet since the script was updated at some point.

[codecov]

Codecov Report

Merging #830 (36ed605) into master (057293f) will not change coverage.
The diff coverage is n/a.

@@           Coverage Diff           @@
##           master     #830   +/-   ##
=======================================
  Coverage   62.47%   62.47%           
=======================================
  Files         102      102           
  Lines        4813     4813           
=======================================
  Hits         3007     3007           
  Misses       1531     1531           
  Partials      275      275           

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 057293f...36ed605. Read the comment docs.

[aeneasr]

Looks like this has some conflicts with #832 being merged - could you please take a look? :)

[tobbbles]

Looks like this has some conflicts with #832 being merged - could you please take a look? :)

master is currently broken due to #832 upgrading ory/x and the docs generation not being able to succeed. #838 will address this, and once merged I can update and re-generate the documentation for this PR :)

[aeneasr]

Everything is merged :)

[tobbbles]

Everything is merged :)

Rebased! Some cleanup on indentation from #829