# servertiming

**Repository Path**: mirrors_rubenv/servertiming

## Basic Information

- **Project Name**: servertiming
- **Description**: Go library for adding Server-Timing headers to your application.
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-08-18
- **Last Updated**: 2026-01-31

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# servertiming

> Go library for adding [`Server-Timing` headers](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Server-Timing) to your application.

[![Build Status](https://travis-ci.org/rubenv/servertiming.svg?branch=master)](https://travis-ci.org/rubenv/servertiming) [![GoDoc](https://godoc.org/github.com/rubenv/servertiming?status.png)](https://godoc.org/github.com/rubenv/servertiming)

![Timings in Chrome Dev Tools](devtools.png)

## Usage

```go
// Create a new instance:

    t := servertiming.New()

// Optionally enable name prefixing to preserve the order of metrics (will adjust names though!)

    t.EnablePrefix()

// Add a few metrics, either by manually specifying the duration:

    t.Add("cache", "Cache Read", 23200*time.Microsecond)

// Or by using the start-stop API:

    ti.Start("db", "Database query")
    // query db
    ti.Stop("db")

// Then send it with your response:

    w.Header().Set("Server-Timing", ti.String())
```

Note: timings can be sent as a trailer when using HTTP2, see the example in `net/http`: [Example (Trailers)](https://godoc.org/net/http#example-ResponseWriter--Trailers).

## License

This library is distributed under the [MIT](LICENSE) license.