Documentation

Introduction

Hello!

Welcome to the Orchestrion documentation!

What is Orchestrion?

Orchestrion is a tool that adds Datadog instrumentation to Go applications automatically at build time. To do so, it uses the standard Go toolchain’s -toolexec feature to intercept and possibly modify compilation units before they are compiled or linked.

Features

  • Unobtrusive – Orchestrion lets developers focus on creating business value instead of wasting their time baking observability instrumentation into their applications.

  • Exhaustive – By running as a -toolexec proxy, Orchestrion can not only add instrumentation into the application’s code; it can also add instrumentation into the dependencies’ code, including into the Go standard library.

  • Flexible – Developers can easily influence the observability data produced by their applications by adding special directives, such as //orchestrion:ignore, or //dd:span custom-tag:value.

  • Configurable – Orchestrion’s code manipulations can be configured with simple YAML documents, allowing developers to provide specific instrumentation configurations for their own frameworks, if Datadog’s provided configuration does not cover these.

Questions or Feedback?

Orchestrion is still under active development, and features and APIs are subject to change.

Have a question or feedback? Feel free to open an issue, or engage with us and the community on GitHub discussions.

Next

Dive right into the following section to get started:

Last updated on