https://github.com/devigned/tab

OpenTracing and OpenCensus abstraction for tracing and logging
https://github.com/devigned/tab

logging opencensus opentracing tracing

Last synced: 11 months ago
JSON representation

OpenTracing and OpenCensus abstraction for tracing and logging

• Host: GitHub
• URL: https://github.com/devigned/tab
• Owner: devigned
• License: mit
• Created: 2019-01-11T20:49:30.000Z (about 7 years ago)
• Default Branch: master
• Last Pushed: 2023-08-30T14:07:14.000Z (over 2 years ago)
• Last Synced: 2025-04-15T05:56:23.852Z (11 months ago)
• Topics: logging, opencensus, opentracing, tracing
• Language: Go
• Size: 39.1 KB
• Stars: 10
• Watchers: 1
• Forks: 5
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# Trace Abstraction (tab)

[![Go Report Card](https://goreportcard.com/badge/github.com/devigned/tab)](https://goreportcard.com/report/github.com/devigned/tab)

[![godoc](https://godoc.org/github.com/devigned/tab?status.svg)](https://godoc.org/github.com/devigned/tab)

[![Build Status](https://travis-ci.org/devigned/tab.svg?branch=master)](https://travis-ci.org/devigned/tab)

[![Coverage Status](https://coveralls.io/repos/github/devigned/tab/badge.svg?branch=master)](https://coveralls.io/github/devigned/tab?branch=master)

OpenTracing and OpenCensus abstraction for tracing and logging. 

Why? Well, sometimes you want to let the consumer choose the tracing / logging implementation.

## Getting Started

### Installing the library

```

go get -u github.com/devigned/tab

```

If you need to install Go, follow [the official instructions](https://golang.org/dl/)

### Usage

```go

package main

import (

	"context"

	"fmt"

	

	"github.com/devigned/tab"

	_ "github.com/devigned/tab/opencensus" // use OpenCensus

	// _ "github.com/devigned/tab/opentracing" // use OpenTracing

)

func main() {

	// start a root span

	ctx, span := tab.StartSpan(context.Background(), "main")

	defer span.End() // close span when done

	

	// pass context w/ span to child func

	printHelloWorld(ctx)

}

func printHelloWorld(ctx context.Context) {

	// start new span from parent

	_, span := tab.StartSpan(ctx, "printHelloWorld")

	defer span.End() // close span when done

	

	// add attribute to span

	span.AddAttributes(tab.StringAttribute("interesting", "value"))

	fmt.Println("Hello World!")

	tab.For(ctx).Info("after println call")

}

```