diff options
| author | Jorik Schellekens <joriksch@gmail.com> | 2019-08-22 18:21:10 +0100 |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2019-08-22 18:21:10 +0100 |
| commit | 8767b63a821eb8612e2ab830534fd6f40eb1aaaa (patch) | |
| tree | 43eb1604f1251cd36a1e394a3421cf8f850d0312 /docs | |
| parent | Merge pull request #5877 from Awesome-Technologies/remove_shared_secret_regis... (diff) | |
| download | synapse-8767b63a821eb8612e2ab830534fd6f40eb1aaaa.tar.xz | |
Propagate opentracing contexts through EDUs (#5852)
Propagate opentracing contexts through EDUs Co-Authored-By: Richard van der Hoff <1389908+richvdh@users.noreply.github.com>
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/opentracing.rst | 27 |
1 files changed, 25 insertions, 2 deletions
diff --git a/docs/opentracing.rst b/docs/opentracing.rst index b91a2208a8..6e98ab56ba 100644 --- a/docs/opentracing.rst +++ b/docs/opentracing.rst @@ -32,7 +32,7 @@ It is up to the remote server to decide what it does with the spans it creates. This is called the sampling policy and it can be configured through Jaeger's settings. -For OpenTracing concepts see +For OpenTracing concepts see https://opentracing.io/docs/overview/what-is-tracing/. For more information about Jaeger's implementation see @@ -79,7 +79,7 @@ Homeserver whitelisting The homeserver whitelist is configured using regular expressions. A list of regular expressions can be given and their union will be compared when propagating any -spans contexts to another homeserver. +spans contexts to another homeserver. Though it's mostly safe to send and receive span contexts to and from untrusted users since span contexts are usually opaque ids it can lead to @@ -92,6 +92,29 @@ two problems, namely: but that doesn't prevent another server sending you baggage which will be logged to OpenTracing's logs. +========== +EDU FORMAT +========== + +EDUs can contain tracing data in their content. This is not specced but +it could be of interest for other homeservers. + +EDU format (if you're using jaeger): + +.. code-block:: json + + { + "edu_type": "type", + "content": { + "org.matrix.opentracing_context": { + "uber-trace-id": "fe57cf3e65083289" + } + } + } + +Though you don't have to use jaeger you must inject the span context into +`org.matrix.opentracing_context` using the opentracing `Format.TEXT_MAP` inject method. + ================== Configuring Jaeger ================== |