Overview

​

Prerequisites

Please complete the Quickstart and make sure you set up custom tracing using the @trace Python decorator or traceFunction JavaScript method. Here’s the guide for custom spans to set those up.

​

Session & Span Level Enrichments

Custom Spans allow you to trace any function in your code and see its inputs, outputs, errors, duration, etc. However, for certain use cases, you might want to add additional context into your trace such as feedback or metrics. We call this context injection enrichments.

To log additional context to your root session, you can use

• enrich_session() in Python
• enrichSession() in JavaScript

To log additional context to a specific child event span, you can use

• enrich_span() in Python
• enrichSpan() in JavaScript

These are useful if you want to add context within a traced function during runtime.

​

Enrichment Schema

Enrichments are key-value pairs that you can add to your traces to provide additional context. You can add the following enrichment attributes to your traces:

Note: For the Object type enrichments (config, metadata, etc.), enrichments are always additive for unique keys. This means that enriching the same field twice with different keys will result in both keys being included in the trace. However, if you enrich the same field with the same key twice, the value will be overwritten.

​

Examples

Here are some ways in which you can enrich your traces: