go: cloud.google.com/go/errorreporting Index | Examples | Files | Directories

package errorreporting

import "cloud.google.com/go/errorreporting"

Package errorreporting is a Google Stackdriver Error Reporting library.

This package is still experimental and subject to change.

See https://cloud.google.com/error-reporting/ for more information.

Code:

package main

import (
    "context"
    "errors"
    "log"

    "cloud.google.com/go/errorreporting"
)

func main() {
    // Create the client.
    ctx := context.Background()
    ec, err := errorreporting.NewClient(ctx, "my-gcp-project", errorreporting.Config{
        ServiceName:    "myservice",
        ServiceVersion: "v1.0",
    })
    if err != nil {
        // TODO: handle error
    }
    defer func() {
        if err := ec.Close(); err != nil {
            log.Printf("failed to report errors to Stackdriver: %v", err)
        }
    }()

    // Report an error.
    err = doSomething()
    if err != nil {
        ec.Report(errorreporting.Entry{
            Error: err,
        })
    }
}

func doSomething() error {
    return errors.New("something went wrong")
}

Index

Examples

Package Files

errors.go

type Client Uses

type Client struct {
    // contains filtered or unexported fields
}

Client represents a Google Cloud Error Reporting client.

func NewClient Uses

func NewClient(ctx context.Context, projectID string, cfg Config, opts ...option.ClientOption) (*Client, error)

NewClient returns a new error reporting client. Generally you will want to create a client on program initialization and use it through the lifetime of the process.

func (*Client) Close Uses

func (c *Client) Close() error

Close calls Flush, then closes any resources held by the client. Close should be called when the client is no longer needed.

func (*Client) Flush Uses

func (c *Client) Flush()

Flush blocks until all currently buffered error reports are sent.

If any errors occurred since the last call to Flush, or the creation of the client if this is the first call, then Flush reports the error via the Config.OnError handler.

func (*Client) Report Uses

func (c *Client) Report(e Entry)

Report writes an error report. It doesn't block. Errors in writing the error report can be handled via Config.OnError.

func (*Client) ReportSync Uses

func (c *Client) ReportSync(ctx context.Context, e Entry) error

ReportSync writes an error report. It blocks until the entry is written.

type Config Uses

type Config struct {
    // ServiceName identifies the running program and is included in the error reports.
    // Optional.
    ServiceName string

    // ServiceVersion identifies the version of the running program and is
    // included in the error reports.
    // Optional.
    ServiceVersion string

    // OnError is the function to call if any background
    // tasks errored. By default, errors are logged.
    OnError func(err error)
}

Config is additional configuration for Client.

type Entry Uses

type Entry struct {
    Error error
    Req   *http.Request // if error is associated with a request.
    User  string        // an identifier for the user affected by the error
    Stack []byte        // if user does not provide a stack trace, runtime.Stack will be called
}

Entry holds information about the reported error.

Directories

PathSynopsis
apiv1beta1Package errorreporting is an auto-generated package for the Stackdriver Error Reporting API.

Package errorreporting imports 14 packages (graph) and is imported by 8 packages. Updated 2018-12-07. Refresh now. Tools for package owners.