https://github.com/marcus-crane/spanner

A handy tool for visualising Datadog traces
https://github.com/marcus-crane/spanner

apm cli datadog datadog-apm datadog-tracing go golang span traces tracing

Last synced: 10 days ago
JSON representation

A handy tool for visualising Datadog traces

• Host: GitHub
• URL: https://github.com/marcus-crane/spanner
• Owner: marcus-crane
• License: mit
• Created: 2021-12-30T07:25:56.000Z (almost 3 years ago)
• Default Branch: main
• Last Pushed: 2023-03-28T00:50:16.000Z (over 1 year ago)
• Last Synced: 2024-06-20T13:28:14.345Z (5 months ago)
• Topics: apm, cli, datadog, datadog-apm, datadog-tracing, go, golang, span, traces, tracing
• Language: Go
• Homepage:
• Size: 776 KB
• Stars: 2
• Watchers: 4
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Spanner

> A minimal tool for visualising Datadog traces 🔧

## Installation

You can install Spanner like so:

```shell

go install github.com/marcus-crane/spanner@latest

```

If you prefer Homebrew, you can use that as well:

```shell

brew install marcus-crane/tap/spanner

```

## Usage

Upon running `spanner`, it will start listening on `localhost:8126` for any requests.

When starting up one (or more) local applications with the Datadog tracer, they should default to localhost and you'll see the contents of the incoming traces dumped out to the terminal.

It isn't very pretty at the moment but it works as a first cut.

## Notes

It might also work with generic Opentracing spans but I haven't tried. I've also only implemented the [msgpack](https://github.com/vmihailenco/msgpack) format for traces but the [official agent](https://github.com/datadog/datadog-agent) also supports protobuf.

In my brief testing, only with the Go tracer, I didn't see any spans that weren't msgpack but it could vary between APM agents.

## Screenshots

![A screenshot of a terminal with Spanner running](screenshot.png)