<commit_before># Circonus metrics tracking for Go applications

This library supports named counters, gauges and histograms. It also provides convenience wrappers for registering latency instrumented functions with Go's builtin http server.

Initializing only requires setting an [API Token](https://login.circonus.com/user/tokens) at a minimum.

## Options

See [OPTIONS.md](OPTIONS.md) for information on all of the available cgm options.

## Example

### Bare bones minimum

A working cut-n-past example. Simply set the required environment variable `CIRCONUS_API_TOKEN` and run.

```go
package main

import (
    "log"
    "math/rand"
    "os"
    "os/signal"
    "syscall"
    "time"

    cgm "github.com/circonus-labs/circonus-gometrics"<commit_msg>doc: add `/v3` to import<commit_after># Circonus metrics tracking for Go applications

This library supports named counters, gauges and histograms. It also provides convenience wrappers for registering latency instrumented functions with Go's builtin http server.

Initializing only requires setting an [API Token](https://login.circonus.com/user/tokens) at a minimum.

## Options

See [OPTIONS.md](OPTIONS.md) for information on all of the available cgm options.

## Example

### Bare bones minimum

A working cut-n-past example. Simply set the required environment variable `CIRCONUS_API_TOKEN` and run.

```go
package main

import (
    "log"
    "math/rand"
    "os"
    "os/signal"
    "syscall"
    "time"

    cgm "github.com/circonus-labs/circonus-gometrics/v3"
{'fraction_non_alphanumeric': 0.08858267716535433, 'fraction_numerical': 0.0013123359580052493, 'mean_word_length': 4.134680134680135, 'pattern_counts': {'":': 0, '<': 3, '<?xml version=': 0, '>': 3, 'https://': 2, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '5638271', 'n_tokens_mistral': 477, 'n_tokens_neox': 452, 'n_words': 165}