Skip to content
CAI
Software that uses CAICheck a score

typelevel/natchez

56.3

Adequate · 6 November 2026

4.6k

lines of production code

Scala

primary language

4

measurements over time

CAI band scale
CAI trend line
CAI lens gauges

What this system is

Features

Add AWS X-Ray tracing integration

This release introduces a new X-Ray backend for Natchez, allowing users to export distributed traces to the AWS X-Ray daemon. The implementation includes an \XRayEntryPoint\ that sends segment data via UDP, an \XRayEnvironment\ trait that automatically resolves the daemon address and trace context from environment variables (and system properties for compatibility), and robust handling of span headers and exception serialization. Comprehensive property-based tests are included to verify header parsing, encoding, and environment fallback logic.

modules/xray · high confidence

Add GlobalTracer utility for OpenTracing integration

The opentracing module now includes a GlobalTracer object that provides utilities to interact with the OpenTracing GlobalTracer singleton. Users can check if a tracer is registered, fetch the currently registered tracer, or register a new tracer if none is present, facilitating easier integration with global tracing setups.

modules/opentracing · high confidence

Add Jaeger distributed tracing backend

Introduces a new Jaeger integration for the Natchez tracing library, allowing users to export traces to Jaeger. The change adds \Jaeger.entryPoint\ and \Jaeger.globalTracerEntryPoint\ to create entry points, \JaegerEntryPoint\ to handle span creation (root, continued, or or-root) with support for span links and span kinds (client, server, consumer, producer), and \JaegerSpan\ to manage span operations including logging, tagging, error attachment, and trace/span ID retrieval. It also provides \unsafeRunWithActivatedSpan\ for interoperability with Java libraries that expect an active span context.

modules/honeycomb, modules/jaeger, modules/lightstep · high confidence

Add MTL-based tracing implementation with Local instance support

Users can now use the \Local\[F, Span\[F\]\]\ typeclass from cats-mtl to provide tracing capabilities, enabling more flexible span scoping and context propagation. This change introduces \LocalTrace\ as a \Trace\ implementation that delegates to a \Local\ instance, supports error attachment with optional fields, and exposes \spanId\ retrieval. It also provides an implicit \Local\ instance for \Kleisli\[F, Span\[F\], \*\]\, allowing tracing to work seamlessly with Kleisli-based effect transformers.

modules/mtl/shared/src/main · high confidence

Add Mock OpenTracing implementation

Introduces a new MockSpan implementation in the modules/mock package that wraps the OpenTracing mock tracer. This change adds support for capturing trace and span IDs, injecting kernels for context propagation, attaching error details with stack traces, and logging events, enabling users to test tracing logic without a real backend.

modules/mock · high confidence

Add New Relic distributed tracing backend

Introduces a new \NewRelic\ module that implements the Natchez \EntryPoint\ and \Span\ interfaces, allowing users to export distributed traces to New Relic. The implementation handles creating root and child spans, propagating trace context via kernel headers (\X-Natchez-Trace-Id\, \X-Natchez-Parent-Span-Id\), attaching error details as span attributes, and sending span data using the New Relic Telemetry \SpanBatchSender\.

modules/newrelic · high confidence

Add Odin-based logging backend for distributed tracing

Introduces a new logging implementation in the \log-odin\ module that integrates the Odin logger with Natchez distributed tracing. This change adds \Log.scala\ and \LogSpan.scala\ to provide an \EntryPoint\ and \Span\ implementation that records trace data (including span kind, links, and error details) as structured JSON logs via Odin, enabling users to adopt Odin for their tracing backend.

modules/log-odin · high confidence

Add OpenCensus tracing backend

Introduces a new OpenCensus integration for distributed tracing, providing an \EntryPoint\ that registers the \OcAgentTraceExporter\ and supports root, continued, and combined span creation. The implementation maps Natchez spans to OpenCensus spans, handling trace/span ID extraction, attribute logging, error attachment, and span finishing with status codes.

modules/opencensus/src · high confidence

Add OpenTelemetry tracing backend module

Introduces a new \opentelemetry\ module that provides a concrete implementation of the Natchez tracing interface backed by the OpenTelemetry SDK. This allows users to create and manage distributed traces using OpenTelemetry's \Tracer\ and \Span\ APIs, including support for parent-child span relationships, error attachment, and resource-based lifecycle management for SDK components.

modules/opentelemetry/src · high confidence

Add logging backend for distributed tracing

Introduces a new logging-based tracing implementation in the \natchez.log\ package, providing \Log\ and \LogSpan\ classes that record trace data as structured JSON logs. This allows users to integrate distributed tracing into applications using \log4cats\, with support for span hierarchy, error attachment, and configurable JSON formatting.

modules/log/shared/src/main · high confidence

Added ScalaCheck arbitrary generators for tracing types

The testkit module now provides implicit ScalaCheck Arbitrary and Cogen instances for core Natchez types, including Kernel, TraceValue, SpanCreationPolicy, SpanKind, and Span.Options. This enables users to easily generate random test data for these types in property-based tests without manually defining generators.

modules/testkit · high confidence

Introduce Datadog tracing backend with concurrency-safe span handling

Adds a new Datadog integration module providing \DDEntryPoint\, \DDSpan\, and \DDTracer\ implementations that map Natchez tracing operations to the Datadog OpenTracing client. The entry point correctly uses \ignoreActiveSpan()\ during span continuation to prevent trace ID collisions in fiber-based runtimes where thread-local state might otherwise cause unrelated requests to share trace IDs. The span implementation supports error attachment with stack traces, span links, span kinds, and exposes trace and span IDs for generating APM URIs.

modules/datadog · high confidence

Natchez 0.3.0: Core tracing API overhaul and new backends

This release introduces a major overhaul of the core tracing API, adding \spanId\ and \traceUri\ to the \Span\ interface and introducing a \TraceableValue\ typeclass to support \Long\, \Float\, and \Double\ span fields. The \Kernel\ implementation now uses case-insensitive headers via \CIString\ for robust propagation, and the \Span\ trait gains a \mapK\ method for effect-type transformation. New modules include \natchez-opentelemetry\ for OpenTelemetry integration, \natchez-mock\ for OpenTracing-based testing, and \natchez-noop\ for disabling tracing, alongside a refactored \InMemory\ testkit.

repository · high confidence

Behavioural changes

Core tracing API restructured with EntryPoint and Trace abstractions

The core module introduces a new \EntryPoint\ trait to manage root spans and trace continuation via kernels, including a \noop\ implementation for non-tracing contexts. The \Trace\ effect is redefined to manage the current span context, adding methods like \spanK\ for natural transformation support, \imapK\ for effect-type transformation, and \spanId\ retrieval. Standard OpenTelemetry-compatible tagging helpers are now provided in \Tags\ (covering HTTP, DB, peer, and span kinds), and a \Fields\ mixin allows exceptions to carry trace data.

modules/core · high confidence

New tracing examples and updated entrypoint configuration

The examples module now includes new demonstration files for OpenTelemetry, global tracer usage, and logging-based tracing, alongside a refactored main example that uses \OptionsBuilder\ for tracer configuration. The existing Lightstep example has been updated to fix compilation errors, and the codebase has been updated to address deprecation warnings from cats-effect and adopt new kind-projector syntax.

modules/examples · high confidence

Project rebranded from Skunk to Natchez

The project has been renamed from Skunk to Natchez, a distributed tracing library for Scala. This change is reflected in the README, which updates the project title, description, and links (including the Gitter badge and microsite URL), and in the LICENSE file, which updates the copyright year to 2019.

(repo-wide) · high confidence

Test coverage

Added test suite for tracing behavior and implicit resolution; Added tests for Local instance on Kleisli-wrapped spans; Added tests for the log module's JSON formatting and trace handling.

Dependencies

Migrate to sbt-typelevel and update core Scala dependencies

The build system has been migrated to sbt-typelevel, introducing structured cross-compilation for JVM, JS, and Native platforms and updating the core library dependencies: Cats is upgraded to 2.13.0, Cats Effect to 3.7.1, and fs2 to 3.14.0. The project now officially supports Scala 2.12.21, 2.13.18, and 3.3.7, with Scala 3.3.7 set as the default version. Additionally, the build now includes MiMa for binary compatibility checking and configures Mergify for automated dependency updates.

(dependencies) · high confidence

Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

How this codebase got here

Score

  • CAI 58 → 56 (-1.2)
  • Rubric changed (rubric-2026.10.5 → rubric-2026.11.2) — scores are not directly comparable.

Lenses

  • Code Health 59 → 59 (+0.0)
  • Architecture 99 → 99 (+0.0)
  • Maturity 46 → 46 (+0.0)
  • Readiness 60 → 58 (-1.4)
  • Security 81 → 70 (-11.7)
  • Performance 100 → 100 (+0.0)

Resolved (10)

  • Off-boarding risk: anonymized user #1
  • Outdated: com.datadoghq:dd-trace-api
  • Outdated: com.datadoghq:dd-trace-ot
  • Outdated: com.newrelic.telemetry:telemetry-core
  • Outdated: com.newrelic.telemetry:telemetry-http-okhttp
  • Outdated: io.grpc:grpc-netty
  • Outdated: io.grpc:grpc-okhttp
  • Outdated: io.netty:netty-tcnative-boringssl-static
  • Outdated: org.http4s:http4s-client_2.13
  • Outdated: org.http4s:http4s-dsl_2.13

New (2)

  • Dependency hygiene PARTLY measured — sbt declarations read, dependency currency not (Maven Central unreachable)
  • Off-boarding risk: anonymized user #1

Changes since last survey

  • 6 commits — 6 feature/other, 0 fixes

By area

  • (repo) — 3 commits
  • (root) — 2 commits
  • project/build.properties — 1 commit

Notable commits

  • change: Merge pull request #1396 from typelevel/update/sbt-1.13.1
  • change: Merge pull request #1399 from typelevel/update/opentelemetry-semconv-1.45.0
  • change: Merge pull request #1400 from typelevel/update/opentelemetry-exporter-otlp-1.68.0
  • change: Update opentelemetry-exporter-otlp, ... to 1.68.0
  • change: Update opentelemetry-semconv to 1.45.0
  • change: Update sbt, scripted-plugin to 1.13.1

Architecture

  • Unchanged — 0 containers · 1 contexts · 0 edges

Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

Survey your own repository

typelevel/natchez was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.

About this page

  • The score is its most recent published measurement, taken on 6 November 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
  • Measured at commit cdf3d101bd4e13a4b47e4bd5242ae196abab2b33 — the exact code this score is about.
  • Scored under rubric-2026.11.2 — the same rubric and the same method as every other entry in this index.
  • Measured by Canine Code Analyzer (cca.canine.dev) using cca measure-2026.11.3+preprod-60d1b390edf0.