status-go/vendor/github.com/ipfs/go-log
Andrea Maria Piana 4d15ae8a85 Upgrade to go 1.18 2022-05-11 12:39:54 +01:00
..
tracer chore: bump go-waku (#2404) 2021-10-19 09:43:41 -04:00
v2 Upgrade to go 1.18 2022-05-11 12:39:54 +01:00
writer go-waku integration (#2247) 2021-06-16 16:19:45 -04:00
LICENSE Add rendezvous implementation for discovery interface 2018-07-25 15:10:57 +03:00
README.md chore: bump go-waku (#2404) 2021-10-19 09:43:41 -04:00
context.go Add rendezvous implementation for discovery interface 2018-07-25 15:10:57 +03:00
entry.go Add rendezvous implementation for discovery interface 2018-07-25 15:10:57 +03:00
levels.go go-waku integration (#2247) 2021-06-16 16:19:45 -04:00
log.go go-waku integration (#2247) 2021-06-16 16:19:45 -04:00
loggable.go Add rendezvous implementation for discovery interface 2018-07-25 15:10:57 +03:00
metadata.go Add rendezvous implementation for discovery interface 2018-07-25 15:10:57 +03:00
oldlog.go go-waku integration (#2247) 2021-06-16 16:19:45 -04:00
package.json migrate to go 1.12 and go modules 2019-06-12 13:12:00 +02:00

README.md

go-log

standard-readme compliant GoDoc CircleCI

The logging library used by go-ipfs

It currently uses a modified version of go-logging to implement the standard printf-style log output.

Install

go get github.com/ipfs/go-log

Usage

Once the package is imported under the name logging, an instance of EventLogger can be created like so:

var log = logging.Logger("subsystem name")

It can then be used to emit log messages, either plain printf-style messages at six standard levels or structured messages using Start, StartFromParentState, Finish and FinishWithErr methods.

Example

func (s *Session) GetBlock(ctx context.Context, c *cid.Cid) (blk blocks.Block, err error) {

    // Starts Span called "Session.GetBlock", associates with `ctx`
    ctx = log.Start(ctx, "Session.GetBlock")

    // defer so `blk` and `err` can be evaluated after call
    defer func() {
        // tag span associated with `ctx`
        log.SetTags(ctx, map[string]interface{}{
            "cid": c,
            "block", blk,
        })
        // if err is non-nil tag the span with an error
        log.FinishWithErr(ctx, err)
    }()

    if shouldStartSomething() {
        // log message on span associated with `ctx`
        log.LogKV(ctx, "startSomething", true)
    }
  ...
}

Tracing

go-log wraps the opentracing-go methods - StartSpan, Finish, LogKV, and SetTag.

go-log implements its own tracer - loggabletracer - based on the basictracer-go implementation. If there is an active WriterGroup the loggabletracer will record span data to the WriterGroup. An example of this can be seen in the log tail command of go-ipfs.

Third party tracers may be used by calling opentracing.SetGlobalTracer() with your desired tracing implementation. An example of this can be seen using the go-jaeger-plugin and the go-ipfs tracer plugin

Contribute

Feel free to join in. All welcome. Open an issue!

This repository falls under the IPFS Code of Conduct.

Want to hack on IPFS?

License

MIT