Exporting custom metrics and logs is available in the Shuttle Pro Tier and above.
tracing
crate.
Getting Started
First, add thetracing
dependency to your project:
Basic Usage
Add tracing events with fields to your functions to create custom metrics. Here’s a simple example:- Send an
info
level log to stdout - Export the metric to your configured telemetry provider
- Include the custom attribute
counter.hello
with value1
Metric Types
The runtime’s OTel exporter usestracing-opentelemetry
under the hood, which automatically handles three metric types:
-
Monotonic Counters: Values that only increase (e.g., total requests)
-
Counters: Values that can increase or decrease
-
Histograms: For measuring distributions of values
Example Trace Output
Here’s what a tracing event looks like when exported:Best Practices
-
Use Meaningful Names: Choose clear, descriptive names for your metrics
-
Include Context: Add relevant context to your metrics
-
Use Appropriate Metric Types:
- Use
monotonic_counter
for values that only increase - Use
counter
for values that can go up and down - Use
histogram
for measuring distributions
- Use