https://github.com/mcataford/doggo

🐕🔎 Inspecting big Datadog traces in the CLI
https://github.com/mcataford/doggo

tooling

Last synced: 3 months ago
JSON representation

🐕🔎 Inspecting big Datadog traces in the CLI

• Host: GitHub
• URL: https://github.com/mcataford/doggo
• Owner: mcataford
• License: mit
• Created: 2023-04-21T12:18:23.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2023-04-27T12:44:39.000Z (over 1 year ago)
• Last Synced: 2024-06-21T07:39:37.381Z (6 months ago)
• Topics: tooling
• Language: Go
• Homepage:
• Size: 8.79 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# doggo

🐕🔎 Inspecting big Datadog traces in the CLI

> # ✈️ Moved away!

>

> This project has moved away from Github and is now hosted [elsewhere](https://forge.karnov.club/marc/doggo).

## Why?

The Datadog trace-viewing UI performance greatly degrades as the number of spans in a single trace increases and within

a trace, it is often painful to find the span you are interested in as there is no way to "jump" to a span directly.

This is an attempt at solving that problem: using `doggo`, you can inspect large trace json blobs and get to the subtree

corresponding to spans of interest in a few keystrokes without having to worry about your browser running out of memory.

At present, you will have to have the json you want to inspect handy -- the tool simply makes it more palatable.

## Installation

### Pre-built binaries

Each release includes pre-built binaries, drop those in your path (i.e. in `/usr/local/bin`) and you are ready to go!

### Building your own

You can also clone this repository and `go build .` to get your own executable.

## Usage

To get `doggo` on your machine, you can grab a [pre-compiled release](https://github.com/mcataford/doggo/releases) for your machine if one is available or build it locally by cloning the repository and running `go build`.

You can either include the executable in your `$PATH` or run the executable wherever it lives:

```

doggo   [-vv] [--depth={depth-limit}]

```

The `resource-name` provided is the resource name associated with the spans that interest you in the provided trace.

Doggo will display all the span subtrees up to `depth-limit` depth (unlimited depth if not specified) that have a

resource name that matches your query (either complete or partial).

Default verbosity will include resource names and span duration in millis. Adding `-v` will toss in some extra

information about each resource and `-vv` will include any metadata (i.e. tagging) that is available in the trace for

that span.

## Contributing

Doggo welcomes contributions. The main use case is pretty tailored to my day-to-day, but sensible suggested changes are

welcome!